This 20-minute getting started guide walks you through all of the things you can do with Anaconda Enterprise. We recommend that you do each step hands-on in Enterprise as you walk through this guide.
See also the Quick Start guide for a 5-minute spin to try out the power of Enterprise.
In this Getting started guide you will create a new Anaconda Project, open it in a notebook, and upload a notebook to your project.
Then you’ll take a peek at the file that governs your Project, the anaconda-project.yml.
After that you’ll use the Project interface to easily add a download, a channel and a package, prepare an environment and link the notebook to it.
Next you’ll add and save a deployable command, and run your project.
Finally you will deploy the project and share it with other Enterprise users.
Getting started steps
- Before you start
- Create an Anaconda Project
- Open the Project in JupyterLab
- Add a notebook
- See how Anaconda Projects work
- Run the Notebook
- Deploy the Project
- Share your Deployment
- Learn more
Before you start¶
You will have already received a welcome email from your system administrator with a link to your Enterprise site, your username and password. Click the link and enter your username or email address and password, then click the Login button:
NOTE: If your administrator enabled self-registration, you will create your own username and password. Enter the following information to register:
Now you are at the Anaconda Enterprise dashboard, which displays a list of all your Anaconda Projects.
Notice there are sample projects available from the top right. You can play with these later.
Create an Anaconda Project¶
Anaconda Project encapsulates data science projects to make them easily portable. Project automates all your setup steps such as installing the right packages, downloading files, setting environment variables and running commands.
Let’s create a new Project named
On the Projects list, click the top left Add (+) button and select New Project.
Name your new project “finance_notebook”. Click the Next button.
You can choose among several types of projects, including Anaconda 3, Anaconda 2, R Language, SAS and Spark.
For this exercise select Anaconda 3.6, then click the Create button.
Anaconda Enterprise prepares your Project, copying all the necessary files into it, so this will take a minute.
TIP: While it’s running, download and check out the handy
JupyterLab and Jupyter Notebook cheat sheet.
Open the Project in JupyterLab¶
If you haven’t already, click the top right OPEN IN JUPYTERLAB button.
TIP: If you prefer to use classic Jupyter Notebook, click the arrow to the right of the OPEN IN JUPYTERLAB button and select “Open in classic Notebook”.
Add a notebook¶
You can use JupyterLab to create new notebooks or edit existing notebooks.
To see the data science capabilities of the Anaconda Enterprise, you can play with a large notebook that is already written for you. The Markowitz Notebook is based on a classic financial theory for maximizing portfolio return. Let’s say a friend or colleague gave you this notebook, and you want to add it to this project.
Click this link to download
the Markowitz notebook
to your computer.
Next, upload the Markowitz notebook to your Finance Notebook in Jupyter Notebook. Click the left Files tab, then click the Upload File(s) icon at the top:
To see the uploaded file, click the left FILES tab. The uploaded Notebook appears in the file list. Now both notebooks are available to you in this project.
See how Anaconda Projects work¶
anaconda-project.yml file now to take a look at it:
This file shows everything that was automatically created when you launched your new project.
If you wanted to make changes to your Project file, you would click the left Project tab. You are not making changes now, so if you opened it, close the tab by clicking the X on the top tab in the right pane.
Add a download¶
Now let’s say you want a file to be automatically downloaded when you run the notebook, so now you will add a download to this project.
On the left Project tab, find the “DOWNLOADS” field, click its Add (+) icon and add a file for the notebook to download.
Copy and paste this into the URL box: http://pastebin.com/raw/BX9mBNhL
In the Name box enter “MARKOWITZ” and in the local file box enter “markowitz.csv”. Click the Save button.
Save all your changes by clicking the blue-highlighted “Project Save” button at the top right of this pane.
Add a channel¶
Add the R Language channel to this Project so you can easily search, download and install packages from this specific channel when using this project.
In the left Project tab, open the CHANNELS field with the pencil icon next to it.
Then copy and paste this link: https://conda.anaconda.org/r
Click the Add (+) icon to add the channel, then click the blue-highlighted “Project Save” button at the top right of this pane.
In the left Project tab, find the “PACKAGES” field and click its edit
icon, the pencil, to add packages. Adding packages here adds them to your
anaconda-project.yml file. You could also edit that file directly if you
markowitz.ipynb uses the following packages which are already installed
with Anaconda 3.6, so you do not need to add them here:
After adding pages, click the “Save Project Data” icon on the top right corner of the left panel, NOT the far right “Save Notebook” icon at the top of the page.
Prepare all environments¶
Now that you’ve added all these goodies to your Project, it’s time to link the notebook to your Project environment.
Still on the left Project tab, find the ENVIRONMENTS field and click the “Prepare All Environments” button next to the Add (+) icon.
Run the Notebook¶
To run the notebook, click the left Files tab, then double-click the icon to the left of the name “markowitz.ipynb” to open it.
Click the top “Notebook” menu, and from the drop-down select “Run All Cells”.
Deploy the Project¶
To deploy your project, you will add a deployable command and save, then leave JupyterLab and deploy using the Anaconda Enterprise interface.
Add a deploy command¶
Any project you want to deploy needs to have a deployable command for it to run.
From the left Project tab (not Commands tab), find the “COMMANDS” field and click its Add (+) icon.
In the Type section click “Notebook”
In the Name box enter “default”
In the notebook box enter “markowitz.ipynb”
Click the Save button.
Save and exit¶
In the top navigation bar on the far right, click the Save icon, and then click Next to save the Project. Then exit the Notebook with the “Back to finance_notebook” link on the top left corner. This brings you back to the Project Detail page.
Click the left Deploy tab, then click the Deploy button to deploy it.
While it is deploying, you can click the Deployment History tab to see a counter, then a pop-up telling you it has deployed.
Interact with Deployment¶
Time to play with your Deployment! In the Deployments list, click the name of your new Deployment to view and interact with it.
From the left View tab you can choose Cell, All Output, and Clear to clear the output. Then run all cells in your notebook with Cell and Run All.