git clone https://github.com/carolynvs/whaleinabox-kit.git.
Create a file to contain secret credentials. Do not check-in this file.
Name the file
secrets.sh and add the your Carina credentials:
export CARINA_USERNAME=username export CARINA_APIKEY=apikey
Name the file
secrets.ps1 and add your Carina credentials:
Run the following command to perform one-time setup tasks:
Note: You will be prompted to log into Docker Hub. This is how your Jupyter notebooks and materials are distributed to your users.
The output from the previous script includes the IP address of the website. If you have a custom domain name, update your DNS and add an A record pointing to the IP address. Depending on TTL (time to live) settings, this will a few minutes or longer.
You can determine when the entry is ready by running the following command,
example.com with your domain name:
dig +short example.com
Register the website with Carina OAuth.
For the Callback URL use
Add your Carina OAuth credentials to the secrets file.
secrets.sh and add your Carina OAuth credentials:
export CARINA_OAUTH_CLIENT_ID=application-id export CARINA_OAUTH_CLIENT_SECRET=secret
secrets.ps1 and add your Carina OAuth credentials:
Run the following command to create the website. This command can be rerun at any time to update the website assets, materials, or just fix things if they break.
This is a mighty fine boxed whale, ready to be taken home and turned into your very own howtowhale. Most things can be tweaked without having to delve into the deployment infrastructure.
Add Jupyter notebooks and other materials to the
materials directory and redeploy.
html/index.html and redeploy.
Dockerfile-jupyter where you can change the base Jupyter notebook server image
or install dependencies.
FROM jupyter/minimal-notebookto another base Jupyter notebook server of your choice. I recommend selecting one from the Jupyter Docker Stacks project.
RUN <command>to install additional dependencies, for example
RUN apt-get update && apt-get install -y curlor
RUN pip install pandas.