命令

命令說明

命令示例

fastgpu [help,-h,--help]

查看所有FastGPU命令的幫助說明。

fastgpu --help

fastgpu -h

fastgpu {command} --help

查看指定的FastGPU命令的幫助說明。

fastgpu ls --help

fastgpu ls

列出FastGPU用戶創(chuàng)建的實(shí)例。包括以下信息：

• instance name：實(shí)例名稱。

• age(hours)：實(shí)例創(chuàng)建至今的時間，以小時為單位。

• public_ip：實(shí)例的公網(wǎng)IP。

• private_ip：實(shí)例的內(nèi)網(wǎng)IP。

• GPU：GPU規(guī)格和數(shù)量。

• instance_type：實(shí)例規(guī)格。

參數(shù)說明：

-a：列出您當(dāng)前阿里云賬戶下所有實(shí)例。會提供Key-Owner（密鑰對）和instance_id（實(shí)例id）兩個額外的信息。

• 查詢當(dāng)前Linux賬戶下的實(shí)例：

  fastgpu ls

• 查詢同一個阿里云賬號不同Linux賬戶下的所有實(shí)例：

  fastgpu ls -a

fastgpu create --config create.cfg
fastgpu create --name {instance_name} --machine {count} --instance_type {ins_type}

創(chuàng)建一個實(shí)例或一個集群。

• 創(chuàng)建一個Ubuntu系統(tǒng)的實(shí)例，并指定實(shí)例名稱和規(guī)格，同時自動安裝CUDA：

  fastgpu create --name fastgpu_vm -np 1 --instance_type ecs.gn6v-c8g1.16xlarge --image_type ubuntu --install_cuda

• 按照配置文件創(chuàng)建實(shí)例：

  fastgpu create -c config.cfg

fastgpu ssh {instance_name}

使用SSH連接并登錄到指定實(shí)例。

使用SSH連接到task0.my_job實(shí)例：

fastgpu ssh task0.my_job

fastgpu scp /local/path/to/upload {instance_name}:/remote/path/to/save
fastgpu scp {instance_name}:/remote/path/to/copy /local/path/to/save

將本地文件拷貝到實(shí)例中，或者是從實(shí)例中拷貝到本地。

• 將本地文件拷貝到實(shí)例中：

  fastgpu scp /root/test.txt task0.my_job:/root/

• 將實(shí)例中的文件拷貝到本地：

  fastgpu scp task0.my_job:/home/cuda/ ~/cuda/

• 將本地文件拷貝到my_job集群中所有實(shí)例的/root目錄中：

  fastgpu scp /root/test.txt {my_job}:/root/

fastgpu querygpu
fastgpu query
fastgpu query -gpu {gpu_type}
fastgpu query -np  {number of gpus per node}
fastgpu query -gpu {gpu_type} -np {number of gpus per node}

查詢阿里云支持的GPU實(shí)例規(guī)格。

• 查詢所有實(shí)例類型：

  fastgpu querygpu

  fastgpu query

• 查詢V100 GPU包含的所有實(shí)例類型：

  fastgpu query -gpu "V100"

• 查詢4個GPU的實(shí)例類型：

  fastgpu query -np 4

fastgpu queryimage
fastgpu queryimage {os_type}

查詢阿里云支持的實(shí)例鏡像。

參數(shù)說明：

os_type：阿里云支持的os類型。包括CentOS、Ubuntu、Debian、SUSE、Aliyun等。

• 查詢所有鏡像：

  fastgpu queryimage

• 查詢CentOS系統(tǒng)的所有鏡像版本：

  fastgpu queryimage centos

fastgpu describe {instance_name}
fastgpu describe

查詢實(shí)例的所有屬性。屬性包括CPU核數(shù)、GPU、鏡像、內(nèi)存大小、創(chuàng)建時間、密鑰對、狀態(tài)等信息。

• 查詢所有實(shí)例的所有屬性：

  fastgpu describe

• 查詢task0.my_job實(shí)例屬性：

  fastgpu describe task0.my_job

• 查詢my_job集群下的所有實(shí)例屬性：

  fastgpu describe {my_job}

fastgpu kill {instance_name}
fastgpu kill -y {instance_name}
fastgpu kill {instance_a_name} {instance_b_name} {instance_c_name}
fastgpu kill -f {instance_name}

釋放指定的實(shí)例。

• 釋放停止?fàn)顟B(tài)的task0.my_job實(shí)例：

  fastgpu kill task0.my_job

• 強(qiáng)制釋放task0.my_job實(shí)例，無論實(shí)例是什么狀態(tài)：

  fastgpu kill -f task0.my_job

• 強(qiáng)制停止my_job集群的所有實(shí)例：

  fastgpu kill -f {my_job}

fastgpu stop {instance_name}
fastgpu stop {instance_a_name} {instance_b_name} {instance_c_name}
fastgpu stop -f {instance_name}
fastgpu stop -k {instance_name}

停止指定的實(shí)例。若實(shí)例為集群實(shí)例，可以通過指定該實(shí)例名的取值，即將{集群名字}作為該實(shí)例值的后綴來批量停止集群下的所有實(shí)例。

• 停止運(yùn)行中的task0.my_job實(shí)例：

  fastgpu stop task0.my_job

• 強(qiáng)制停止task0.my_job實(shí)例：

  fastgpu stop -f task0.my_job

• 強(qiáng)制停止my_job下所有實(shí)例：

  fastgpu stop -f {my_job}

fastgpu start {instance_name}

啟動指定的實(shí)例。

參數(shù)說明：

-y：跳過確認(rèn)。

• 啟動task0.my_job實(shí)例：

  fastgpu start task0.my_job

• 啟動my_job集群：

  fastgpu start {my_job}

fastgpu mount {instance_name}
fastgpu mount {instance_name} {mount_target_domain}

為指定的實(shí)例掛載NAS文件系統(tǒng)到/ncluster目錄。

參數(shù)說明：

mount_target_domain：指定NAS的掛載點(diǎn)。如果不指定，則會自動創(chuàng)建掛載點(diǎn)并掛載。

• 為task0.my_job實(shí)例自動創(chuàng)建一個掛載點(diǎn)，并掛載NAS文件系統(tǒng)到實(shí)例中：

  fastgpu mount task0.my_job

• 手動創(chuàng)建并獲取掛載點(diǎn)，并將掛載點(diǎn)掛載到task0.my_job實(shí)例中：

  fastgpu mount task0.my_job example.cn-hangzhou.nas.aliyuncs.com

• 為集群所有實(shí)例掛載NAS文件系統(tǒng)：

  fastgpu mount {my_job}

fastgpu run {instance_name} {cmd}

在指定實(shí)例中執(zhí)行shell命令。

參數(shù)說明：

cmd：需要執(zhí)行的命令。

• 查詢task0.my_job實(shí)例的IP：

  fastgpu run task0.my_job ifconfig

• 查詢my_job集群下所有實(shí)例的IP：

  fastgpu run {my_job} ifconfig

fastgpu addip {instance_name}
fastgpu addip {instance_name} {your_public_ip}
fastgpu addip {instance_name} {your_public_ip} {port_range}
fastgpu addip {instance_name} {your_public_ip} {port_range} {description}
fastgpu addip -a {your_public_ip} {port_range} {description}

為指定實(shí)例的安全組添加可訪問的公網(wǎng)IP。

• 將本機(jī)公網(wǎng)IP的22端口添加到默認(rèn)安全組中：

  fastgpu addip -a

• 將本機(jī)公網(wǎng)IP的22端口添加到task0.my_job實(shí)例中的安全組中：

  fastgpu addip task0.my_job

• 允許IP地址為203.0.113.0的機(jī)器訪問task0.my_job實(shí)例的2000-3000端口：

  fastgpu addip task0.my_job 203.0.113.0 2000/3000

  fastgpu addip task0.my_job 203.0.113.0 2000/3000 "open 2000-3000 port"

• 允許IP地址為203.0.113.0的機(jī)器訪問my_job集群中的所有機(jī)器的2000~3000端口：

  fastgpu addip {my_job} 203.0.113.0 2000/3000

fastgpu deleteip {instance_name}
fastgpu deleteip {instance_name} {your_public_ip}
fastgpu deleteip {instance_name} {your_public_ip} {port_range}
fastgpu deleteip -a

將IP從某一實(shí)例安全組中移除。

• 將本機(jī)公網(wǎng)IP從task0.my_job實(shí)例安全組中移除：

  fastgpu deleteip task0.my_job

• 將IP地址為203.0.113.0的機(jī)器從實(shí)例安全組移除：

  fastgpu deleteip task0.my_job 203.0.113.0

• 移除IP地址為203.0.113.0的機(jī)器訪問2000-3000端口的權(quán)限：

  fastgpu deleteip task0.my_job 203.0.113.0 2000/3000

• 將task0.my_job實(shí)例22端口下所有IP從安全組中移除：

  fastgpu deleteip -a task0.my_job

• 將IP地址為203.0.113.0的機(jī)器從my_job集群下的所有實(shí)例中刪除：

  fastgpu deleteip {my_job} 203.0.113.0

fastgpu queryip
fastgpu queryip -a
fastgpu queryip {instance_name}

查詢實(shí)例的安全組IP，默認(rèn)只查詢22端口對應(yīng)的IP。

參數(shù)說明：

-a：查詢所有端口的IP。

• 查詢所有實(shí)例的22端口安全組IP：

  fastgpu queryip

• 查詢task0.my_job實(shí)例的22端口安全組IP：

  fastgpu queryip task0.my_job

• 查詢task0.my_job實(shí)例所有端口對應(yīng)的安全組IP：

  fastgpu queryip -a task0.my_job

fastgpu addpub {string of id_rsa.pub}

將本機(jī)公鑰添加進(jìn)指定實(shí)例。

參數(shù)說明：

string of id_rsa.pub：公鑰路徑。

將~/.ssh/id_rsa.pub內(nèi)容添加到實(shí)例中：

fastgpu addpub

fastgpu rename {instance_name} {instance_new_name}
fastgpu rename {instance_id} {instance_new_name}

重命名實(shí)例。

將task0.my_job實(shí)例重命名為my_new_ins：

fastgpu rename task0.my_job task0.my_new_ins

fastgpu tmux {instance_name}

使用SSH連接到實(shí)例，并使用默認(rèn)的tmux進(jìn)程。

登錄task0.my_job實(shí)例，并創(chuàng)建一個tmux進(jìn)程：

fastgpu tmux task0.my_job

fastgpu deletekeypair

刪除本機(jī)的密鑰對。

刪除~/.fastgpu/下對應(yīng)的密鑰對：

fastgpu deletekeypair

fastgpu createkeypair

在本機(jī)創(chuàng)建一個密鑰對，后續(xù)實(shí)例的創(chuàng)建以及連接都會使用此次創(chuàng)建的密鑰對。

在本機(jī)~/.fastgpu/下創(chuàng)建一個密鑰對：

fastgpu createkeypair

fastgpu attachkeypair {instance_name}

將密鑰對綁定到實(shí)例中。

• 將~/.fastgpu/下的密鑰對綁定至task0.my_job實(shí)例：

  fastgpu attachkeypair task0.my_job

• 將~/.ncluster/下的密鑰對綁定至my_job集群：

  fastgpu attachkeypair {my_job}

fastgpu detachkeypair {instance_name}

從實(shí)例中分離密鑰對。

• 分離task0.my_job實(shí)例密鑰對：

  fastgpu detachkeypair task0.my_job

• 分離my_job集群下所有實(shí)例的密鑰對：

  fastgpu detachkeypair {my_job}

fastgpu notebooksample {instance_name} {passwd_of_login}

在指定實(shí)例中創(chuàng)建部署jupyter notebook項目示例。

• 默認(rèn)密碼：AIACC。

• 項目實(shí)例：tensorflow-1.14-python36。

參數(shù)說明：

passwd_of_login：指定jupyter-notebook服務(wù)器密碼。

在task0.my_job實(shí)例中創(chuàng)建并部署項目示例：

fastgpu notebooksample task0.my_job

fastgpu cuda {instance_name} {gpu_driver_version} {cuda_version} {cudnn_version}

為指定實(shí)例安裝驅(qū)動，CUDA和cuDNN組件。默認(rèn)值為：

• gpu_driver_version：460.91.03。

• cuda-version：11.2.2。

• cudnn-version：8.1.1。

• 在task0.my_job實(shí)例中安裝CUDA的默認(rèn)版本：

  fastgpu cuda task0.my_job

• 在task0.my_job實(shí)例中安裝GPU驅(qū)動，CUDA和cuDNN，GPU驅(qū)動版本為460.91.03，CUDA版本號為11.2.2，cuDNN版本號為8.1.1：

  fastgpu cuda task0.my_job 460.91.03 11.2.2 8.1.1

fastgpu conda {instance_name}
fastgpu conda {instance_name} -f {conda_yaml_file}
fastgpu conda {instance_name} -h
fastgpu conda {instance_name} --cuda 10.0 -tf -v 1.15.0

為指定實(shí)例安裝Conda，并創(chuàng)建出指定的Python、CUDA版本的虛擬環(huán)境。

• 為task0.my_job實(shí)例安裝Conda，不安裝任何虛擬環(huán)境：

  fastgpu conda task0.my_job

• 為my_job集群中所有實(shí)例安裝Conda：

  fastgpu conda {my_job}

• 為task0.my_job實(shí)例安裝Conda，并配置Python 3.6，CUDA 11.0以及PyTorch 1.7.0虛擬環(huán)境：

  fastgpu conda -py 3.6 -cu 11.0 -pt -v 1.7.0

fastgpu allconda {instance_name}

在指定實(shí)例中安裝所有支持的Conda環(huán)境。

• 為task0.my_job安裝所有的conda環(huán)境：

  fastgpu allconda task0.my_job

• 為my_job集群安裝所有的conda環(huán)境：

  fastgpu allconda {my_job}

fastgpu replaceimage {instance_name} {image_id}

替換指定實(shí)例的鏡像。

參數(shù)說明：

image_id：需要替換的鏡像名稱或鏡像ID。

• 將task0.my_job實(shí)例的鏡像替換為CentOS：

  fastgpu replaceimage task0.my_job centos_8_2_x64_20G_alibase_20210712.vhd

• 將my_job下所有實(shí)例替換為CentOS：

  fastgpu replaceimage {my_job} centos_8_2_x64_20G_alibase_20210712.vhd