USING NGC WITH ALIBABA CLOUD

Transcription

1 USING NGC WITH ALIBABA CLOUD DU _v02 March 2018 Setup Guide

2 TABLE OF CONTENTS Chapter 1. Introduction to... 1 Chapter 2. Preliminary Setup Setting Up SSH Keys Setting Up a Security Group (Optional) Installing Alibaba CLI... 5 Chapter 3. Launching an NVIDIA GPU Cloud VM with the Alibaba Console Creating the NVIDIA GPU Cloud VM Instance Connecting to the VM Instance with SSH... 9 Chapter 4. Launching an NVIDIA GPU Cloud Virtual Machine Image Using Alibaba CLI Getting the NGC VMI Image ID Creating Your VM Instance Assigning a Public IP Address Starting the Instance Connecting to the VM Instance with SSH Starting, Stopping, or Deleting Your VM Instance...13 DU _v02 ii

3 Chapter 1. INTRODUCTION TO USING NGC WITH ALIBABA CLOUD These instructions are for using NGC with the International Alibaba Cloud. To view instructions for the Chinese Alibaba Cloud, see NVIDIA makes available on the Alibaba Cloud platform a customized image optimized for the NVIDIA Pascal and Volta -based Tesla GPUs. Running NGC containers on this virtual machine (VM) instance provides optimum performance for deep learning jobs. For those familiar with the Alibaba platform, the process of launching the instance is as simple as logging into Alibaba, selecting the "NVIDIA GPU Cloud Machine Image" and one of the supported NVIDIA GPU instance types, configuring settings as needed, then launching the VM. After launching the VM, you can SSH into it and start running deep learning jobs using framework containers from the NGC container registry. This document provides step-by-step instructions for accomplishing this. Prerequisites These instructions assume the following: You have an Alibaba account - with permissions to create resources. You have performed the following steps from the NGC website (see NGC Getting Started Guide) Signed up for an NGC account at Created an NGC API key for access to the NGC container registry. Browsed the NGC website and identified an available NGC container and tag to run on the VMI. DU _v02 1

4 Introduction to If you plan to use the CLI or Terraform, then the Alibaba CLI must be be installed, with at least the ECS SDK, and you must create SSH keys to use with Alibaba; see setup instructions below. Windows Users: The CLI code snippets are for bash on Linux or Mac OS X. If you are using Windows and want to use the snippets as-is, you can use the Windows Subsystem for Linux and use the bash shell (you will be in Ubuntu Linux). DU _v02 2

5 Chapter 2. PRELIMINARY SETUP Perform these preliminary setup tasks to simplify the process of launching the NVIDIA GPU Cloud machine image Setting Up SSH Keys If you do not already have SSH keys set up specifically for Alibaba, you will need to set one up and have it on the machine you will use to SSH to the VM. In the examples, the key is named "alibaba-key" From a browser, log in to the ECS console - Open the left navigation menu tab and then click Key Pairs from the Network & Security group. From the upper right of the screen, click Create Key Pair. Give it a name, such as "alibaba-key" and click OK. A.pem file will immediately download. This is the ONLY time you can download it. After downloading the.pem file, move it to the.ssh directory. mv alibaba-key.pem ~/.ssh/ chmod 400 ~/.ssh/alibaba-key.pem On Windows, the location will depend on the SSH client you use, so modify the path above and in the snippets or your SSH client configuration. See the Alibaba documentation for Creating an SSH key pair Setting Up a Security Group In order to create instances, you need to put them in a Security Group. Log in to the ECS console Open the left navigation menu tab and then click Security Groups from the Network & Security group. 1. DU _v02 3

6 Preliminary Setup From the upper right of the screen, click Create Security Group. 4. Give it a name and description, then click OK. 5. Immediately set the rules using the section Quickly Create Rules. a) Check SSH and HTTPS. b) At Custom Port Range, select TCP and then enter 5000/5000. c) Set Authorization Object = /0 or the IP address from which you will access. d) Click OK. 3. DU _v02 4

7 Preliminary Setup 2.3. (Optional) Installing Alibaba CLI To use the Alibaba CLI, follow the Alibaba CLI Install Instructions and also install the ECS SDK Install the ECS SDK. sudo pip install aliyun-python-sdk-ecs Configure the CLI with your keys. aliyuncli configure DU _v02 5

8 Chapter 3. LAUNCHING AN NVIDIA GPU CLOUD VM WITH THE ALIBABA CONSOLE 3.1. Creating the NVIDIA GPU Cloud VM Instance Log on the Alibaba Elastic Compute Service (ECS) console - marketplace.alibabacloud.com/. 2. Search for NVIDIA GPU, then select the NVIDIA GPU Cloud Virtual Machine Image. 3. Click Choose your plan from the NVIDIA GPU Cloud Virtual Machine Image product page Near the bottom of the page, click ECS Advanced Purchase page. DU _v02 6

9 Launching an NVIDIA GPU Cloud VM with the Alibaba Console 5. Make the following selections from the Basic Configurations page.. a) For Billing Method, select Pay-As-You-Go. b) For Region, select one that contains the image (e.g. US-West 1 Zone B ), and then a region from the dropdown menu (for example, US.West 1 (Silicon Valley)). Note that not all regions support GPU instances. c) For Instance Type,click Heterogeneous Compute and then locate and select a GPU Compute Type gn5 instance according to your GPU and memory requirements. d) For Image, select Marketplace Image, and then make sure the NVIDIA GPU Cloud Virtual Machine Image is selected. e) For Storage, add a disk for dataset storage by clicking Add Disk under Data Disk, and then entering the storage size. Recommended minimum dataset storage size is 1 TB (1024 GB) f) Click Next: Networking. 6. Make the following selections from the Networking page. a) For Security Group, click Select Security Group. b) Select your security group from the list, then click Select. Make sure you created a Security Group as explained in the section Set Up Security Groups DU _v02 7

10 Launching an NVIDIA GPU Cloud VM with the Alibaba Console c) Click Next: System Configurations. 7. Make the following selections from the System Configurations page. a) Make sure Key Pair is selected for Log On Credentials. b) Click the Key Pair list arrow and then select your key pair. 8. Click Preview, then review your configuration. 9. Click the Terms of Service check box, indicating your acceptance, and then click Create Instance. 10. At the Activated message, click Console. DU _v02 8

11 Launching an NVIDIA GPU Cloud VM with the Alibaba Console Wait until your instance status is Running, then you can connect to the instance using SSH Connecting to the VM Instance with SSH Once started, you can SSH into your instance using the SSH key for the root user. If you followed the setup in this tutorial, your key is in ~/.ssh/. Command syntax: ssh -i <KEYPATH> Example: ssh -i ~/.ssh/alibaba-key.pem Refer to Connect to a Linux Instance for more instructions on connecting to your instance. DU _v02 9

12 Chapter 4. LAUNCHING AN NVIDIA GPU CLOUD VIRTUAL MACHINE IMAGE USING ALIBABA CLI Using Example Python Scripts A comprehensive set of example Python scripts for automating the CLI are provided at You can download the scripts and modify them to meet your requirements. The code examples that follow use similar environment variables and structure as the scripts. Using the Instructions in this Chapter This flow and the code snippets in this section are for Linux or Mac OS X. If you are using Windows, you can use the Windows Subsystem for Linux and use the bash shell (where you will be in Ubuntu Linux). Many of these CLI command can have significant delays. For complete CLI documentation and sample scripts visit the Alibaba Documentation Center Getting the NGC VMI Image ID Once started, you can SSH into your instance using the SSH key for the root user. If you followed the setup in this tutorial, your key is in ~/.ssh/. You need to specify a source ImageID when creating an instance. Use this command to find the latest ImageID of the NVIDIA-GPU-Cloud-Machine-Image: aliyuncli ecs DescribeImages --RegionId us-west-1 \ --ImageName "NVIDIA-GPU-Cloud-Virtual-Machine" \ DU _v02 10

13 Launching an NVIDIA GPU Cloud Virtual Machine Image Using Alibaba CLI --output json --filter Images.Image[0].ImageId It will output the Image ID such as "m-rj9iy0xjiod3ghkyhz4p" 4.2. Creating Your VM Instance Creating an instance with the CLI is done using the `aliyuncli ecs CreateInstance` command. Full syntax documentation - Recommended Instance Options "--InternetMaxBandwidthOut 10" sets the peak outbound network bandwidth to 10 Mbps. The valid range is [1, 200]. "--InstanceChargeType PostPaid" sets the billing method to pay-as-you-go. Change this to "PrePaid" to set it to a subscription billing. Other Notable Create Instance Options The inbound network bandwidth defaults to 200 Mbps. Use "-InternetMaxBandwidthIn" to change this. The valid range is [1, 200]. To change the size of the system disk (default is 40 GB), use the "--SystemDiskSize" option. Valid values are [40, 500]. To add a data disk (up to 16), use the "--DataDiskNSize" and "--DataDiskNCategory" options where "N" is [1, 16]. Valid values are: DataDiskNCategory DataDiskNSize Description cloud [5, 2000] (default) Basic cloud disk cloud_efficiency [20, 32768] Ultra cloud disk cloud_ssd [20, 32768] Cloud SSD ephemeral_ssd [5, 800] Ephemeral SSD Launch Example Launch the instance and capture the resulting JSON: aliyuncli ecs CreateInstance \ --RegionId us-west-1 \ --ImageId "m-rj9iy0xjiod3ghkyhz4p" \ --SecurityGroupId "sg-rj94krsusal2k5l6gnnz" \ --InstanceType ecs.gn5-c4g1.xlarge \ --InstanceName "my-instance" \ --InternetMaxBandwidthOut 10 \ --InstanceChargeType PostPaid \ --KeyPairName alibaba-key DU _v02 11

14 Launching an NVIDIA GPU Cloud Virtual Machine Image Using Alibaba CLI The output shows the instance ID. { } "InstanceId": "i-rj9a0iw25hryafj0fm4v", "RequestId": "440ECC70-09F9-492C-AB9E-21AA9C4E0531" 4.3. Assigning a Public IP Address Instances created via CLI are not automatically given a public IP address. To assign a public IP address to the instance you just created, run: aliyuncli ecs AllocatePublicIpAddress --RegionId us-west-1 \ --InstanceId "i-rj9a0iw25hryafj0fm4v" Successful completion of the command will return the IP address: { } "IpAddress": " ", "RequestId": "65EB59AE-FA75-446F-B5C7-2BA0F9A77CDC" 4.4. Starting the Instance Instances created via CLI are not started automatically. To start the instance you just created, run: aliyuncli ecs StartInstance --InstanceId "i-rj9a0iw25hryafj0fm4v" 4.5. Connecting to the VM Instance with SSH Once started, you can SSH into your instance using the SSH key for the root user. If you followed the setup in this tutorial, your key is in ~/.ssh/. Command syntax: ssh -i <KEYPATH> root@<ip> Example: ssh -i ~/.ssh/alibaba-key.pem root@ Refer to Connect to a Linux Instance for more instructions on connecting to your instance. DU _v02 12

15 Launching an NVIDIA GPU Cloud Virtual Machine Image Using Alibaba CLI 4.6. Starting, Stopping, or Deleting Your VM Instance Once an instance is running, you can stop, (re)start, or delete your instance. Stop: aliyuncli ecs StopInstance --InstanceId INSTANCE_ID Start or Restart: aliyuncli ecs StartInstance --InstanceId INSTANCE_ID Delete: aliyuncli ecs DeleteInstance --InstanceId INSTANCE_ID DU _v02 13