Alibaba Cloud CLI adalah alat berbasis baris perintah yang memungkinkan Anda memanggil operasi API Alibaba Cloud di terminal atau antarmuka baris perintah untuk membuat, mengonfigurasi, dan mengelola sumber daya Alibaba Cloud. Topik ini menjelaskan cara memanggil operasi API Elastic Compute Service (ECS) menggunakan Alibaba Cloud CLI untuk membuat dan mengelola instance ECS serta menyediakan contoh.
Untuk informasi lebih lanjut tentang Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI?.
Persiapan
Buat pasangan AccessKey untuk Pengguna Resource Access Management (RAM). Akun Alibaba Cloud memiliki semua izin pada sumber daya. Jika pasangan AccessKey akun Alibaba Cloud Anda bocor, sumber daya Anda terpapar pada risiko besar. Kami menyarankan Anda menggunakan pasangan AccessKey dari pengguna RAM. Untuk informasi tentang cara membuat pasangan AccessKey, lihat Buat Pasangan AccessKey.
Berikan izin yang diperlukan pada sumber daya ECS dan Virtual Private Cloud (VPC) kepada pengguna RAM yang ingin Anda gunakan. Kode contoh yang disediakan dalam topik ini mencakup pembuatan sumber daya seperti instance ECS, VPC, dan vSwitch. Untuk memberikan izin yang diperlukan untuk menjalankan kode contoh, kami sarankan Anda melampirkan kebijakan yang dijelaskan dalam tabel berikut kepada pengguna RAM.
Layanan cloud
Kebijakan
VPC
AliyunVPCFullAccess
ECS
AliyunECSFullAccess
Instal dan konfigurasikan Alibaba Cloud CLI. Anda harus menginstal Alibaba Cloud CLI sebelum dapat menggunakannya. CLI ini tersedia untuk Windows, Linux, dan macOS. Unduh paket instalasi yang sesuai dengan sistem operasi komputer Anda.
Instal Alibaba Cloud CLI. Untuk panduan instalasi di berbagai sistem operasi, lihat topik-topik berikut:
Konfigurasikan Alibaba Cloud CLI.
Konfigurasikan parameter seperti kredensial dan wilayah yang diperlukan untuk menggunakan sumber daya Alibaba Cloud. Untuk informasi tentang cara mengonfigurasi kredensial, buka tab AK di bagian Jenis-Jenis Kredensial dari topik "Konfigurasi Profil".
Jika Anda hanya perlu melakukan operasi debugging sementara, Anda tidak perlu menginstal Alibaba Cloud CLI. Anda dapat menggunakan Cloud Shell yang disediakan oleh Alibaba Cloud untuk melakukan operasi tersebut. Untuk informasi lebih lanjut, lihat Apa itu Cloud Shell?.

Buat instance ECS
Beberapa parameter seperti ID vSwitch, ID grup keamanan, dan ID gambar diperlukan untuk membuat instance ECS. Anda dapat memasukkan ID sumber daya yang ada atau memanggil operasi API untuk membuat sumber daya baru.
Buat VPC.
VPC adalah jaringan pribadi khusus di cloud. Anda dapat mengonfigurasi dan mengelola VPC sebagai jaringan yang diisolasi secara logis di cloud publik.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah tempat VPC dibuat. Contoh: ap-northeast-1.
CidrBlock
Blok CIDR VPC. Contoh: 192.168.0.0/16.
Buat vSwitch.
vSwitch adalah perangkat switching jaringan dalam VPC yang mendukung fungsi switch fisik. Ini memungkinkan komunikasi antara mesin virtual (VM) dan antara VM dengan jaringan fisik.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah tempat vSwitch dibuat. Contoh: ap-northeast-1.
ZoneId
ID zona tempat vSwitch dibuat. Contoh: ap-northeast-1a.
VpcId
ID VPC tempat vSwitch dibuat. Contoh: vpc-bp1aag0sb9s4i92i3****.
CidrBlock
Blok CIDR vSwitch. Contoh: 192.168.0.0/24.
Buat grup keamanan.
Grup keamanan bertindak sebagai firewall virtual yang mengontrol lalu lintas masuk dan keluar untuk instance ECS.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah tempat grup keamanan dibuat. Contoh: ap-northeast-1.
VpcId
ID VPC tempat grup keamanan dibuat. Contoh: vpc-bp1aag0sb9s4i92i3****.
Buat aturan masuk di grup keamanan.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah grup keamanan. Contoh: ap-northeast-1.
SecurityGroupId
ID grup keamanan. Contoh: sg-bp1esyhwfbqeyudt****.
IpProtocol
Protokol. Contoh: tcp.
SourceCidrIp
Blok CIDR sumber. Contoh: 0.0.0.0/0.
PortRange
Rentang port. Contoh:
Instance Linux: 22/22.
Instance Windows: 3389/3389.
Buat instance ECS.
ECS menyediakan kapasitas komputasi berperforma tinggi, aman, dan hemat biaya yang cocok untuk berbagai skenario seperti hosting situs web, pengembangan aplikasi, dan pemrosesan data. Dengan ECS, Anda dapat dengan cepat menerapkan dan menjalankan aplikasi serta menyesuaikan sumber daya secara fleksibel sesuai dengan perubahan bisnis.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah tempat instance ECS dibuat. Contoh: ap-northeast-1.
ImageId
ID gambar dari mana instance ECS dibuat. Kami menyarankan Anda memilih gambar Alibaba Cloud Linux yang ID-nya adalah aliyun_3_x64_20G_alibase_20240819.vhd.
InstanceType
Tipe instance ECS. Contoh: ecs.e-c1m1.large.
SecurityGroupId
ID grup keamanan tempat instance ECS dibuat. Contoh: sg-bp1esyhwfbqeyudt****.
VSwitchId
ID vSwitch yang akan dihubungkan ke instance ECS. Contoh: vsw-bp1nzprm8h7mmnl8t****.
InstanceName
Nama instance ECS. Contoh: ecs_cli_demo.
InstanceChargeType
Metode penagihan instance ECS. Untuk membuat instance bayar sesuai pemakaian, atur parameter ini menjadi PostPaid.
CatatanPastikan saldo akun Anda mencukupi.
PASSWORD
Kata sandi logon. Contoh: ******.
InternetMaxBandwidthOut
Bandwidth publik maksimum arah keluar. Jika nilai parameter ini lebih besar dari 0, alamat IP publik akan otomatis ditetapkan ke instance.
SystemDisk.Category
Kategori disk sistem. Contoh: cloud_essd.
SystemDisk.Size
Ukuran disk sistem. Contoh: 40 GiB.
Kode contoh berikut memberikan contoh lengkap tentang cara membuat instance ECS.
Gunakan Alibaba Cloud CLI untuk menjalankan kode contoh. Jika Anda menjalankan ulang kode tersebut, sumber daya seperti VPC, vSwitch, dan grup keamanan akan dibuat berulang kali. Hal ini dapat menyebabkan pemborosan sumber daya. Pastikan Anda meninjau kode dengan hati-hati dan mengoptimalkannya berdasarkan logika bisnis Anda.
#!/bin/bash
# Konfigurasikan ID AccessKey dan Rahasia AccessKey yang digunakan oleh Alibaba Cloud CLI.
# Catatan: Pastikan ID AccessKey dan Rahasia AccessKey dikonfigurasi dengan aman dengan mengonfigurasi variabel lingkungan atau dengan menggunakan file konfigurasi.
# 1. Konfigurasikan variabel.
INSTANCE_NAME="ecs_cli_demo"
#2. Instal alat dependensi jq.
echo "Menginstal alat dependensi jq..."
yum install jq
sleep 3
#3. Buat VPC, vSwitch, dan grup keamanan.
echo "Membuat VPC..."
VpcId=$(aliyun vpc CreateVpc --RegionId ap-northeast-1 --CidrBlock 192.168.0.0/16 | jq -r .VpcId)
aliyun vpc DescribeVpcAttribute --RegionId ap-northeast-1 --VpcId ${VpcId} --waiter expr='Status' to=Available > /dev/null 2>&1
echo "Membuat vSwitch..."
VSwitchId=$(aliyun vpc CreateVSwitch --CidrBlock 192.168.0.0/24 --VpcId ${VpcId} --ZoneId=ap-northeast-1a | jq -r .VSwitchId)
echo "Membuat grup keamanan..."
SecurityGroupId=$(aliyun ecs CreateSecurityGroup --RegionId ap-northeast-1 --VpcId ${VpcId} | jq -r .SecurityGroupId)
aliyun ecs AuthorizeSecurityGroup --RegionId ap-northeast-1 --SecurityGroupId ${SecurityGroupId} --IpProtocol tcp --SourceCidrIp 0.0.0.0/0 --PortRange 22/22 > /dev/null 2>&1
read -s -P "Masukkan Kata Sandi Anda:" PASSWORD
echo
echo "KATA SANDI OK."
# 4. Jalankan perintah untuk membuat instance ECS.
echo "Membuat instance ECS..."
INSTANCE_ID_RAW=$(aliyun ecs RunInstances \
--RegionId ap-northeast-1 \
--ImageId aliyun_3_x64_20G_alibase_20240819.vhd \
--InstanceType ecs.e-c1m1.large \
--SecurityGroupId ${SecurityGroupId} \
--VSwitchId ${VSwitchId} \
--InstanceName $INSTANCE_NAME \
--InstanceChargeType PostPaid \
--InternetMaxBandwidthOut 1 \
--Password $PASSWORD \
--SystemDisk.Category cloud_essd \
--SystemDisk.Size 40)
# 5. Dapatkan InstanceId untuk informasi yang dikembalikan selanjutnya.
INSTANCE_ID=$(echo "$INSTANCE_ID_RAW" | jq -r '.InstanceIdSets.InstanceIdSet[]')
# 6. Tunggu 20 detik agar instance ECS dibuat.
echo "Menunggu instance ECS dibuat..."
sleep 20
# 7. Periksa status instance ECS.
echo "Memeriksa status instance ECS..."
INSTANCE_ID_QUOTED=$(printf '"%s"' "$INSTANCE_ID")
aliyun ecs DescribeInstances \
--RegionId ap-northeast-1 \
--InstanceIds "[${INSTANCE_ID_QUOTED}]" \
--output cols=InstanceId,InstanceName,InstanceType,ImageId,Status rows=Instances.Instance[]
Buat dan jalankan skrip Shell. Gambar berikut menunjukkan hasil perintah.

Sambungkan ke instance ECS
Anda dapat menggunakan SSH untuk masuk ke instance ECS dan kemudian menerapkan layanan serta membangun aplikasi di instance tersebut.
Dapatkan alamat IP publik instance ECS.
Panggil operasi DescribeInstances dan tentukan
<ID Instance>untuk memeriksa alamat IP publik instance.Contoh permintaan:
aliyun ecs DescribeInstances \ --RegionId ap-northeast-1 \ -- InstanceIds '["<ID Instance>"]'Contoh respons:
Parameter PublicIpAddresses menunjukkan alamat IP publik instance ECS.

Sambungkan ke instance ECS.
ssh <Username>@<Alamat IP Publik>
Lepas Sumber Daya
Jika Anda tidak lagi memerlukan sumber daya yang telah dibuat, Anda dapat memanggil operasi API berikut untuk melepaskannya.
Pilih operasi API untuk melepaskan sumber daya berdasarkan kebutuhan bisnis Anda. Dalam contoh-contoh berikut, semua sumber daya yang dibuat di bagian sebelumnya dilepaskan.
Lepaskan instance ECS.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah. Contoh: ap-northeast-1.
InstanceId
ID instance. Contoh: i-bp17f3kzgtzzj91r****.
Hapus grup keamanan.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah grup keamanan. Contoh: ap-northeast-1.
SecurityGroupId
ID grup keamanan. Contoh: sg-bp1esyhwfbqeyudt****.
Hapus vSwitch.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah. Contoh: ap-northeast-1.
VSwitchId
ID vSwitch. Contoh: vsw-bp1nzprm8h7mmnl8t****.
Hapus VPC.
Operasi API
Parameter
Deskripsi dan contoh
RegionId
ID wilayah. Contoh: ap-northeast-1.
VpcId
ID VPC. Contoh: vpc-bp1aag0sb9s4i92i3****.
Contoh kode:
#!/bin/bash
# Konfigurasikan parameter sumber daya yang ingin Anda lepaskan atau hapus.
INSTANCE_ID='ecs_cli_demo' # Tentukan ID instance ECS yang ingin Anda lepaskan.
SECURITY_GROUP_ID='sg-bp1esyhwfbqeyudt****' # Tentukan ID grup keamanan yang ingin Anda hapus.
VSWITCH_ID='vsw-bp1nzprm8h7mmnl8t****' # Tentukan ID vSwitch yang ingin Anda hapus.
VPC_ID='vpc-bp1aag0sb9s4i92i3****' # Tentukan ID VPC yang ingin Anda hapus.
REGION='ap-northeast-1' # Tentukan ID wilayah.
echo "Melepaskan atau menghapus sumber daya..."
# Lepaskan instance ECS.
aliyun ecs DeleteInstance \
--region ${REGION} \
--InstanceId ${INSTANCE_ID}
# Hapus grup keamanan.
aliyun ecs DeleteSecurityGroup \
--region ${REGION} \
--RegionId ${REGION} \
--SecurityGroupId ${SECURITY_GROUP_ID}
# Hapus vSwitch.
aliyun vpc DeleteVSwitch \
--region ${REGION} \
--RegionId ${REGION} \
--VSwitchId ${VSWITCH_ID}
# Hapus VPC.
aliyun vpc DeleteVpc \
--region ${REGION} \
--RegionId ${REGION} \
--VpcId ${VPC_ID}
echo "Pelepasan selesai"
Referensi
Anda dapat menjalankan perintah berikut untuk menanyakan perintah yang didukung:
aliyun ecs --helpAnda dapat menjalankan perintah dengan menggunakan sintaksis berikut untuk memanggil operasi API ECS. Untuk informasi tentang parameter permintaan, lihat dokumentasi setiap operasi API.
aliyun ecs <Nama Operasi API> --<Nilai Parameter 1> --<Nilai Parameter 2> ...