ApplyScalingGroup - - Alibaba Cloud Dokümantasyon Merkezi

Operation description

ApplyScalingGroup işlemini çağırarak Elastic Container Instance türünde ölçeklendirme gruplarını kolayca oluşturabilirsiniz. Ölçeklendirme gruplarının kaynakları Kubernetes Deployment YAML dosyalarında tanımlanır. Bu işlemi, Kubernetes Deployment YAML dosyalarındaki esnek konteyner örnekleri için ek açıklamaları genişletmek üzere de çağırabilirsiniz. Daha fazla bilgi için bu konudaki "Desteklenen ek açıklamalar" bölümüne bakın.

YAML dosyaları ve ölçeklendirme grupları arasındaki eşleme: Bir YAML dosyasındaki ad alanı (namespace), tür (kind) ve ad (name) üçlüsünü bir ölçeklendirme grubu adıyla eşleyebilirsiniz. Bir bölgede, bir YAML dosyası ile bir ölçeklendirme grubu arasında bire bir eşleme ilişkisi bulunur. Örneğin, bir bölgede ölçeklendirme grubu oluşturmak için varsayılan ad alanında NGINX adlı Kubernetes Deployment YAML dosyasını kullanırsanız, eşlenen ölçeklendirme grubunun benzersiz adı k8s_default_Deployment_nginx olur.

Bir ölçeklendirme grubunu yönetmek için aşağıdaki mantığa dayalı olarak bir Kubernetes Deployment YAML dosyası kullanabilirsiniz:

Mevcut bir ölçeklendirme grubunun Kubernetes Deployment YAML dosyanızla bir eşleme ilişkisi varsa, YAML dosyasını kullanarak ölçeklendirme grubunu güncelleyebilirsiniz.
Kubernetes Deployment YAML dosyanızla eşleme ilişkisine sahip bir ölçeklendirme grubu yoksa, YAML dosyasını kullanarak kolayca bir ölçeklendirme grubu oluşturabilirsiniz.

Kubernetes Deployment YAML dosyanızda sanal özel bulut (VPC), vSwitch, güvenlik grubu veya ek açıklama belirtmezseniz sistem, varsayılan vSwitch'lere sahip varsayılan bir VPC oluşturur ve Auto Scaling'in varsayılan ess-default-sg güvenlik grubunu kullanır. Varsayılan olarak, güvenlik grubu kuralı İletim Kontrol Protokolü (TCP) tabanlı 22 ve 3389 numaralı bağlantı noktalarındaki trafiğe izin verir ve IPv4 adresleri için İnternet Kontrol İletisi Protokolünü (ICMP) etkinleştirir. Diğer bağlantı noktalarını veya protokolleri etkinleştirmek isterseniz özel güvenlik grubu kuralları oluşturabilirsiniz.
Genel bir görüntü kullanmak istiyorsanız, İnternet erişimi özelliğini etkinleştirmeli ve esnek IP adresi (EIP) özelliğini etkinleştirmek için k8s.aliyun.com/eci-with-eip pod ek açıklamasını yapılandırmalısınız.
Bir Kubernetes Deployment YAML dosyasını uygulamak için ApplyScalingGroup işlemini çağırdıktan sonra, ölçeklendirme grubu anında Etkin (Enabled) durumuna ve ölçeklendirme yapılandırması anında Aktif (Active) durumuna geçer. YAML dosyasında belirttiğiniz kopya sayısı 0'dan büyükse, esnek konteyner örnekleri otomatik olarak oluşturulur.

Desteklenen ek açıklamalar

Ek açıklamalar hakkında daha fazla bilgi için ECI Pod Ek Açıklamaları belgesine bakın.

Ek açıklama	Örnek	Açıklama
k8s.aliyun.com/ess-scaling-group-min-size	1	Oluşturmak istediğiniz ölçeklendirme grubunun minimum boyutu. Varsayılan değer: 0.
k8s.aliyun.com/ess-scaling-group-max-size	20	Oluşturmak istediğiniz ölçeklendirme grubunun maksimum boyutu. Varsayılan değer: maksimum kopya sayısı veya 30 değerlerinden hangisi daha büyükse o.
k8s.aliyun.com/eci-ntp-server	100.100..	Ağ Zaman Protokolü (NTP) sunucusunun IP adresi.
k8s.aliyun.com/eci-use-specs	2-4Gi	2 vCPU ve 4 GiB bellek teknik özellikleri. Daha fazla bilgi için Birden fazla teknik özellik belirterek pod oluşturma konusuna bakın.
k8s.aliyun.com/eci-vswitch	vsw-bp1xpiowfm5vo8o3c****	vSwitch kimliği. Birden fazla bölge belirtmek için birden fazla vSwitch belirtebilirsiniz.
k8s.aliyun.com/eci-security-group	sg-bp1dktddjsg5nktv****	Güvenlik grubu kimliği. Bu ek açıklamayı yapılandırmadan önce aşağıdaki gereksinimlere dikkat edin: Bir veya daha fazla güvenlik grubu belirtebilirsiniz. Her ölçeklendirme grubu için en fazla beş güvenlik grubu belirtebilirsiniz. Birden fazla güvenlik grubu belirtirseniz, güvenlik gruplarının aynı VPC'ye ait olması gerekir. Birden fazla güvenlik grubu belirtirseniz, güvenlik gruplarının aynı türde olması gerekir.
k8s.aliyun.com/eci-sls-enable	"false"	Değeri false olarak ayarlarsanız günlük toplama özelliği devre dışı bırakılır.

Belirli podların günlüklerini toplamak için Simple Log Service'e özel Özel Kaynak Tanımı (CRD) kullanmak istemiyorsanız, podlar için bu ek açıklamayı yapılandırabilir ve değeri false olarak ayarlayabilirsiniz. Bu, sistem tarafından oluşturulan Logtail'lerin neden olduğu kaynak israfını önler.| |k8s.aliyun.com/eci-spot-strategy|SpotAsPriceGo|Kesintili örnekler için teklif verme politikası. Geçerli değerler:

SpotWithPriceLimit: Örnekler, maksimum saatlik fiyatla kesintili örnekler olarak oluşturulur. Değeri SpotWithPriceLimit olarak ayarlarsanız, k8s.aliyun.com/eci-spot-price-limit ek açıklamasını yapılandırmanız gerekir.
SpotAsPriceGo: Örnekler, satın alma anındaki piyasa fiyatının teklif fiyatı olarak otomatik şekilde kullanıldığı kesintili örnekler olarak oluşturulur.

| |k8s.aliyun.com/eci-spot-price-limit|"0.5"|Kesintili örneklerin maksimum saatlik fiyatı. Bu değer en fazla üç ondalık basamağa kadar doğru olabilir.

Bu ek açıklama yalnızca k8s.aliyun.com/eci-spot-strategy ek açıklamasını SpotWithPriceLimit olarak ayarladığınızda etkili olur.| |k8s.aliyun.com/eci-with-eip|"true"|Değeri true olarak ayarlarsanız, otomatik olarak bir esnek IP adresi (EIP) oluşturulur ve her esnek konteyner örneğine bağlanır.| |k8s.aliyun.com/eci-data-cache-bucket|default|Veri önbelleklerinin bucket'ı. Veri önbelleklerine dayalı bir pod oluşturmak istiyorsanız bu ek açıklamayı yapılandırmalısınız.| |k8s.aliyun.com/eci-data-cache-pl|PL1|Veri önbelleklerine dayalı olarak oluşturmak istediğiniz bulut diskinin performans seviyesi (PL).

Varsayılan olarak kurumsal SSD'ler (ESSD'ler) oluşturulur. Varsayılan değer: PL1.| |k8s.aliyun.com/eci-data-cache-provisionedIops|"40000"|ESSD AutoPL diskinin sağlanan okuma/yazma IOPS değeri. Geçerli değerler: 0 ile min{50000, 1000 × Kapasite - Temel IOPS} arası. Temel IOPS = min{1.800 + 50 × Kapasite, 50.000}. Daha fazla bilgi için ESSD AutoPL diskleri konusuna bakın.

Bu ek açıklamayı yapılandırırsanız, veri önbelleklerine dayalı olarak oluşturulan bulut diski ESSD AutoPL türünde olur.| |k8s.aliyun.com/eci-data-cache-burstingEnabled|"true"|ESSD AutoPL disk için Burst özelliğinin etkinleştirilip etkinleştirilmediğini belirtir. Daha fazla bilgi için ESSD AutoPL diskleri konusuna bakın.

Bu ek açıklamayı yapılandırırsanız, veri önbelleklerine dayalı olarak oluşturulan bulut diski ESSD AutoPL türünde olur.| |k8s.aliyun.com/eci-custom-tags|"env:test,name:alice"|Her esnek konteyner örneğine eklemek istediğiniz etiketler. Her esnek konteyner örneği için en fazla üç etiket ekleyebilirsiniz. Etiket anahtarı ile etiket değerini iki nokta üst üste (:) ile ayırın. Birden fazla etiketi virgül (,) ile ayırın.|

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:ApplyScalingGroup

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
Content	string	Yes	Yapılandırma dosyasının içeriği.	apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80
RegionId	string	No	Bölge kimliği.	cn-hangzhou

Response elements

Element	Type	Description	Example
	object	Yanıt şeması.
RequestId	string	İstek kimliği.	CC107349-57B7-4405-B1BF-9BF5AF7F****
ScalingGroupId	string	Etkinleştirilen ölçeklendirme grubunun kimliği.	asg-bp1igpak5ft1flyp****

Examples

Success response

JSON format

{
  "RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "ScalingGroupId": "asg-bp1igpak5ft1flyp****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.