Prerequisites
-
Make sure you are in a group that has at least the
editorrole within your tenant; for example, the defaulteditorsgroup. You can check this in the Administration → IAM section of the web console. - Make sure that you have enough quota for GPUs. The Blueprint requires a minimum of four GPUs to run.
-
Create a Managed Service for Kubernetes® cluster that meets the following requirements:
- A public endpoint is allocated.
- A node group has at least four GPUs.
- NVIDIA® GPU Operator and NVIDIA® Device Plugin are deployed on the cluster.
How to deploy
-
In the web console, go to
Applications.
- Find NVIDIA Blueprint for virtual screening by searching for it or browsing by category, then open the application page.
- Click Deploy on cluster to deploy using the Kubernetes option.
-
Configure the application:
- In Application name and Namespace, enter unique names for your deployment.
- Enter your NGC API key. If you do not yet have an NGC key, see How to get an NGC Key.
- Under Disk size, specify a value between
2000 Giand10000 Gi. At least2000 Giis required to download the models. Disks do not scale automatically, so enter a size that is sufficient for your needs. - In JupyterHub admin password, click Generate to create a secure password, copy it and then select I saved the password securely.
- In JupyterHub accessibility, choose how the JupyterHub interface can be accessed.
- Click Deploy application.
-
Wait until the application status becomes
Running. The deployment might take up to three hours.
How to get an NGC Key
If you do not yet have an NGC key, you can get one by the following steps:- Go to NVIDIA NGC website.
- Enter your email, password and other necessary credentials to create an account.
- Once registered, go to build.nvidia.com and click Generate API key. Follow the steps and copy the API key and paste it in the deployment configuration.
How to access the Blueprint via JupyterHub
After the application is deployed, you can access it via JupyterHub by IP or by using port forwarding.Access by IP
-
Install and configure
kubectl. -
Run the following command to get the external IP address:
-
In your browser, go to
http://<ip>and log in as admin. Use the password that you saved during deployment.
Access by port forwarding
-
Install and configure
kubectl. -
Set up port forwarding:
- Open http://localhost:8080 in your browser. On the login screen, enter admin as the username and use the password that you saved during deployment.
Managing users
To create and manage users in JupyterHub, do the following:- In the JupyterHub top menu, select File → Hub Control Panel.
- Click Admin → Add Users.
- Enter usernames, one per line. To grant a user admin rights, select the Admin checkbox.
- Click Add Users.
How to delete the Blueprint
- In the web console, go to
Applications.
- Find the deployed Blueprint in the list and open it.
- In the application, go to the Settings tab.
- Under Delete application, click Delete.
- Confirm the deletion.