全部产品
Search
文档中心

Elastic Compute Service:Buat dan gunakan instance ECS dengan menggunakan Alibaba Cloud CLI

更新时间:Jul 06, 2025

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.

Catatan

Untuk informasi lebih lanjut tentang Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI?.

Persiapan

  1. 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.

  2. 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

  3. 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.

    1. Instal Alibaba Cloud CLI. Untuk panduan instalasi di berbagai sistem operasi, lihat topik-topik berikut:

    2. 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?. image

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.

  1. 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

    CreateVpc

    RegionId

    ID wilayah tempat VPC dibuat. Contoh: ap-northeast-1.

    CidrBlock

    Blok CIDR VPC. Contoh: 192.168.0.0/16.

  2. 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.

    CreateVSwitch

    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.

  3. 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

    CreateSecurityGroup

    RegionId

    ID wilayah tempat grup keamanan dibuat. Contoh: ap-northeast-1.

    VpcId

    ID VPC tempat grup keamanan dibuat. Contoh: vpc-bp1aag0sb9s4i92i3****.

  4. Buat aturan masuk di grup keamanan.

    Operasi API

    Parameter

    Deskripsi dan contoh

    AuthorizeSecurityGroup

    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.

  5. 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

    RunInstances

    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.

    Catatan

    Pastikan 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.

Penting

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.

image

Sambungkan ke instance ECS

Anda dapat menggunakan SSH untuk masuk ke instance ECS dan kemudian menerapkan layanan serta membangun aplikasi di instance tersebut.

  1. 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.

      公网IP

  2. Sambungkan ke instance ECS.

    ssh <Username>@<Alamat IP Publik>

    image

Lepas Sumber Daya

Jika Anda tidak lagi memerlukan sumber daya yang telah dibuat, Anda dapat memanggil operasi API berikut untuk melepaskannya.

Catatan

Pilih operasi API untuk melepaskan sumber daya berdasarkan kebutuhan bisnis Anda. Dalam contoh-contoh berikut, semua sumber daya yang dibuat di bagian sebelumnya dilepaskan.

  1. Lepaskan instance ECS.

    Operasi API

    Parameter

    Deskripsi dan contoh

    DeleteInstances

    RegionId

    ID wilayah. Contoh: ap-northeast-1.

    InstanceId

    ID instance. Contoh: i-bp17f3kzgtzzj91r****.

  2. Hapus grup keamanan.

    Operasi API

    Parameter

    Deskripsi dan contoh

    DeleteSecurityGroup

    RegionId

    ID wilayah grup keamanan. Contoh: ap-northeast-1.

    SecurityGroupId

    ID grup keamanan. Contoh: sg-bp1esyhwfbqeyudt****.

  3. Hapus vSwitch.

    Operasi API

    Parameter

    Deskripsi dan contoh

    DeleteVSwitch

    RegionId

    ID wilayah. Contoh: ap-northeast-1.

    VSwitchId

    ID vSwitch. Contoh: vsw-bp1nzprm8h7mmnl8t****.

  4. Hapus VPC.

    Operasi API

    Parameter

    Deskripsi dan contoh

    DeleteVpc

    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 --help

Anda 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> ...

Hasilkan Perintah CLI

Alibaba Cloud menyediakan OpenAPI Explorer bagi pengembang untuk memahami dan menggunakan operasi API dari berbagai layanan Alibaba Cloud secara cepat dan efisien. OpenAPI Explorer mengintegrasikan berbagai fitur terkait API, termasuk pencarian cerdas, dokumentasi, debugging online, unduhan SDK, kode contoh, diagnosis kesalahan, dan statistik panggilan. Anda dapat menggunakan OpenAPI Explorer untuk menghasilkan perintah CLI untuk suatu operasi API. Untuk informasi lebih lanjut, lihat Apa itu API?.

  1. Masuk ke Portal OpenAPI.

  2. Pilih operasi API untuk mana Anda ingin menghasilkan perintah CLI dan tentukan parameter.

  3. Klik tab CLI Example di panel kanan untuk melihat perintah CLI yang dihasilkan dengan parameter yang ditentukan.

    2024-08-12_10-30-57.png