Alibaba Cloud Command Line Interface (CLI), OpenAPI işlemlerini çağırarak terminalinizden Alibaba Cloud kaynaklarını yönetmenizi sağlayan bir araçtır. Bu konu, Alibaba Cloud CLI kullanarak bir ECS örneği oluşturmak ve yönetmek için örnekler sunar.
Alibaba Cloud CLI hakkında daha fazla bilgi için bkz. Alibaba Cloud CLI nedir?.
Başlamadan önce
Bir Alibaba Cloud hesabı tüm kaynaklar üzerinde tam yetkilere sahip olduğundan, hesap AccessKey bilgilerinin sızdırılması yüksek güvenlik riski oluşturur. Yalnızca gereken minimum izinlere sahip olan bir RAM kullanıcısının AccessKey bilgilerini kullanmanızı öneririz. Daha fazla bilgi için bkz. AccessKey oluşturma.
-
RAM kullanıcısına ECS ve VPC kaynaklarını yönetmek için gerekli izinleri verin. Bu konudaki örnek kod; örnekler, VPC'ler ve vSwitch'ler gibi kaynaklar oluşturur. Aşağıdaki izinleri atamanızı öneririz:
Cloud hizmeti
İzin
VPC
Sistem ilkesini ekleyin: AliyunVPCFullAccess
ECS
Sistem ilkesini ekleyin: AliyunECSFullAccess -
CLI'yı yükleyin ve yapılandırın. Alibaba Cloud CLI Windows, Linux ve macOS için kullanılabilir. İşletim sisteminize uygun kurulum yöntemini seçin:
-
CLI'yı yükleyin.
-
CLI'yı yapılandırın.
Alibaba Cloud kaynaklarını çağırmak için gereken kimlik bilgilerini ve hizmet isteği bölgesini yapılandırın. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma.
Yalnızca geçici olarak hata ayıklama yapmanız gerekiyor ve Alibaba Cloud CLI'yı yüklemek istemiyorsanız Cloud Shell kullanabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell nedir? Cloud Shell'i başlatmak için Alibaba Cloud konsolunda oturum açın ve üst gezinme çubuğundaki Tickets öğesinin sağ tarafındaki Cloud Shell simgesine (terminal simgesi) tıklayın.
-
Bir ECS örneği oluşturun
Bir ECS örneği oluşturmak için bir vSwitch ID, güvenlik grubu ID ve görüntü ID gibi parametreler gerekir. Mevcut kaynak ID'lerini kullanabilir veya aşağıdaki adımlardaki işlemleri çağırarak yeni olanları oluşturabilirsiniz.
-
Bir VPC oluşturun.
VPC, cloud kaynaklarınız için mantıksal olarak izole edilmiş özel bir ağdır.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
CidrBlock
VPC CIDR bloğu: 192.168.0.0/16
-
Bir vSwitch oluşturun.
vSwitch, bir VPC içindeki farklı cloud kaynaklarını bağlayan temel bir ağ cihazıdır.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
ZoneId
Alan: cn-hangzhou-i
VpcId
VPC ID: vpc-bp1aag0sb9s4i92i3****
CidrBlock
vSwitch CIDR bloğu: 192.168.0.0/24
-
Bir güvenlik grubu oluşturun.
Güvenlik grubu, ECS örneklerinize gelen ve giden trafiği kontrol eden sanal bir güvenlik duvarıdır.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
VpcId
VPC ID: vpc-bp1aag0sb9s4i92i3****
-
Güvenlik grubuna gelen bir kural ekleyin.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
SecurityGroupId
Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****
IpProtocol
Protokol: tcp
SourceCidrIp
Kaynak CIDR bloğu: 0.0.0.0/0
PortRange
Bağlantı noktası aralığı:
-
Linux örnekleri için: 22/22
-
Windows örnekleri için: 3389/3389
-
-
Bir ECS örneği oluşturun.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
ImageId
Görüntü: Alibaba Cloud Linux görüntüsünü kullanın aliyun_3_x64_20G_alibase_20240819.vhd
InstanceType
Örnek türü: ecs.e-c1m1.large
SecurityGroupId
Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****
VSwitchId
vSwitch ID: vsw-bp1nzprm8h7mmnl8t****
InstanceName
Örnek adı: ecs_cli_demo
InstanceChargeType
Kullandıkça öde bir örnek oluşturmak için PostPaid olarak ayarlayın.
NotHesabınızda yeterli bakiye bulunduğundan emin olun.
Password
Oturum açma parolası:
InternetMaxBandwidthOut
Bu değer 0'dan büyükse, örneğe otomatik olarak bir genel IP adresi atanır.
SystemDisk.Category
Sistem diski kategorisi: cloud_essd
SystemDisk.Size
Sistem diski boyutu: 40 GiB
Aşağıda tam örnek komut dosyası verilmiştir:
Bu örnek komut dosyasını birden çok kez çalıştırmak yinelenen kaynaklar oluşturur ve gereksiz maliyetlere yol açabilir. Çalıştırmadan önce komut dosyasını gözden geçirin ve özel ihtiyaçlarınıza göre uyarlayın.
#!/bin/bash
# In a production environment, make sure that your AccessKey ID and AccessKey secret
# are securely set by using environment variables or a configuration file.
# 1. Set variables.
INSTANCE_NAME="ecs_cli_demo"
# 2. Install the jq tool.
echo "Installing the jq dependency tool..."
yum install -y jq
sleep 3
# 3. Create a VPC, vSwitch, and security group.
echo "Creating a VPC..."
VpcId=$(aliyun vpc CreateVpc --RegionId cn-hangzhou --CidrBlock 192.168.0.0/16 | jq -r .VpcId)
aliyun vpc DescribeVpcAttribute --RegionId cn-hangzhou --VpcId ${VpcId} --waiter expr='Status' to=Available > /dev/null 2>&1
echo "Creating a vSwitch..."
VSwitchId=$(aliyun vpc CreateVSwitch --CidrBlock 192.168.0.0/24 --VpcId ${VpcId} --ZoneId=cn-hangzhou-i | jq -r .VSwitchId)
echo "Creating a security group..."
SecurityGroupId=$(aliyun ecs CreateSecurityGroup --RegionId cn-hangzhou --VpcId ${VpcId} | jq -r .SecurityGroupId)
aliyun ecs AuthorizeSecurityGroup --RegionId cn-hangzhou --SecurityGroupId ${SecurityGroupId} --IpProtocol tcp --SourceCidrIp 0.0.0.0/0 --PortRange 22/22 > /dev/null 2>&1
read -s -p "Enter your password:" PASSWORD
echo
echo "PASSWORD OK."
# 4. Run the command to create an ECS instance.
echo "Creating the ECS instance..."
INSTANCE_ID_RAW=$(aliyun ecs RunInstances \
--RegionId cn-hangzhou \
--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. Extract the instance ID for later use.
INSTANCE_ID=$(echo "$INSTANCE_ID_RAW" | jq -r '.InstanceIdSets.InstanceIdSet[]')
# 6. Wait for 20 seconds for the ECS instance to be created.
echo "Waiting for the ECS instance to be created..."
sleep 20
# 7. Query the ECS instance status.
echo "Querying the ECS instance status..."
INSTANCE_ID_QUOTED=$(printf '"%s"' "$INSTANCE_ID")
aliyun ecs DescribeInstances \
--RegionId cn-hangzhou \
--InstanceIds "[${INSTANCE_ID_QUOTED}]" \
--output cols=InstanceId,InstanceName,InstanceType,ImageId,Status rows=Instances.Instance[]
Shell komut dosyasını oluşturun ve çalıştırın. Beklenen çıktı aşağıdaki gibidir:
[root@i-xxxxx Z ~]# bash ecs-cli.sh
Installing the jq dependency tool...
Last metadata expiration check: 0:24:56 ago on Tue 22 Oct 2024 09:24:50 AM CST.
Package jq-1.6-15.al8.x86_64 is already installed.
Dependencies resolved.
Nothing to do.
Complete!
Creating a VPC...
Creating a vSwitch...
Creating a security group...
Enter your password:
PASSWORD OK.
Creating the ECS instance...
Waiting for the ECS instance to be created...
Querying the ECS instance status...
InstanceId | InstanceName | InstanceType | ImageId | Status
---------- | ------------ | ------------ | ------- | -------
i-bpxxxxxxxxxxxz4 | ecs_cli_demo | ecs.e-c1m1.large | aliyun_3_x64_20G_alibase_20240819.vhd | Running
Örneğe bağlanın
SSH ile örneğe bağlandıktan sonra hizmetlerinizi ve uygulamalarınızı dağıtabilirsiniz.
-
Örneğin genel IP adresini alın.
Örneğin genel IP adresini elde etmek için
<InstanceID>ile DescribeInstances işlemini çağırın.-
Örnek istek
aliyun ecs DescribeInstances \ --RegionId cn-hangzhou \ --InstanceIds '["<instance-id>"]' -
Örnek yanıt
PublicIpAddress parametresi örneğin genel IP adresini gösterir.
"PublicIpAddress": { "IpAddress": [ "115.29.xxx.xxx" ] }
-
-
ECS örneğine bağlanın.
ssh <username>@<public_ip_address>[root@i-xxx bfZ ~ ]# ssh root@1xx.xx.xx.xx The authenticity of host '1xx.xx.xx.xx (1xx.xx.xx.xx)' can't be established. ECDSA key fingerprint is SHA256:PVyhCaxxx4mecykrU. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '1xx.xx.xx.xx' (ECDSA) to the list of known hosts. root@1xx.xx.xx.xx's password: Welcome to Alibaba Cloud Elastic Compute Service ! Last login: Thu Oct 10 13:31:58 2024 from xxx.67 [root@iZ xxx ugZ ~]#
Kaynakları temizleyin
Kaynaklara artık ihtiyacınız olmadığında ek ücretlerden kaçınmak için bunları serbest bırakın.
Kaynakları serbest bırakmak için uygun OpenAPI işlemini seçin. Bu örnekte önceki adımlarda oluşturulan tüm kaynaklar serbest bırakılır.
-
ECS örneğini silin.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
InstanceId
Örnek ID: i-bp17f3kzgtzzj91r****
-
Güvenlik grubunu silin.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
SecurityGroupId
Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****
-
vSwitch'i silin.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
VSwitchId
vSwitch ID: vsw-bp1nzprm8h7mmnl8t****
-
VPC'yi silin.
API
Parametre
Değer
RegionId
Bölge: cn-hangzhou
VpcId
VPC ID: vpc-bp1aag0sb9s4i92i3****
Aşağıda örnek bir komut dosyası verilmiştir:
#!/bin/bash
# Replace the placeholder values with the actual IDs of the resources you want to release.
INSTANCE_ID='i-bpxxxxxxxxxxxz4'
SECURITY_GROUP_ID='sg-bp1esyhwfbqeyudt****'
VSWITCH_ID='vsw-bp1nzprm8h7mmnl8t****'
VPC_ID='vpc-bp1aag0sb9s4i92i3****'
REGION='cn-hangzhou'
echo "Releasing resources..."
# Delete the instance.
aliyun ecs DeleteInstance \
--region ${REGION} \
--InstanceId ${INSTANCE_ID}
# Wait for the instance to be deleted before deleting the security group.
# Add a wait logic here in a production script.
# Delete the security group.
aliyun ecs DeleteSecurityGroup \
--region ${REGION} \
--SecurityGroupId ${SECURITY_GROUP_ID}
# Delete the vSwitch.
aliyun vpc DeleteVSwitch \
--region ${REGION} \
--VSwitchId ${VSWITCH_ID}
# Delete the VPC.
aliyun vpc DeleteVpc \
--region ${REGION} \
--VpcId ${VPC_ID}
echo "Cleanup complete."
Başvurular
ECS için desteklenen CLI komutlarının listesini görüntülemek için aşağıdaki komutu çalıştırabilirsiniz.
aliyun ecs --help
ECS API işlemlerini çağırmak için aşağıdaki sözdizimini kullanın. Ayrıntılı parametreler için her işlemle ilgili belgelere bakın.
aliyun ecs <APIName> --<parameter1 value1> --<parameter2 value2> ...