Crée et gère un groupe de mise à l'échelle à l'aide d'un fichier de configuration.
Description de l'opération
L'opération ApplyScalingGroup prend en charge le format de définition de ressource Kubernetes Deployment pour créer rapidement des groupes de mise à l'échelle Elastic Container Instance (ECI). Elle prend également en charge les annotations étendues ECI pour les fichiers YAML Kubernetes. Pour plus d'informations, consultez la section « Annotations prises en charge ».
Mappage entre les configurations YAML et les groupes de mise à l'échelle : le nom d'un groupe de mise à l'échelle est mappé par le tuple namespace, kind et name dans la définition YAML. Dans une même région, une même configuration YAML ne peut être mappée qu'au même groupe de mise à l'échelle. Exemple : si vous utilisez une configuration YAML de Deployment nommée nginx dans l'espace de noms par défaut, elle est mappée à un groupe de mise à l'échelle nommé k8s_default_Deployment_nginx dans la même région.
Logique de gestion des groupes de mise à l'échelle basée sur les configurations YAML :
Si le groupe de mise à l'échelle mappé à la configuration YAML existe, le groupe de mise à l'échelle est mis à jour en fonction de la configuration YAML.
Si le groupe de mise à l'échelle mappé à la configuration YAML n'existe pas, un groupe de mise à l'échelle correspondant est créé en fonction de la configuration YAML.
Précautions \n\n1. Si la configuration YAML ne spécifie pas les annotations VPC, vSwitch et groupe de sécurité, le système crée automatiquement un VPC par défaut, crée un vSwitch par défaut dans le VPC et crée le groupe de sécurité Auto Scaling par défaut ess-default-sg. Par défaut, la stratégie du groupe de sécurité autorise le trafic sur les ports TCP 22 et 3389, ainsi que le protocole ICMP (IPv4). Si vous avez d'autres exigences en matière de ports et de protocoles, vous pouvez modifier la stratégie du groupe de sécurité.\n2. Lorsque vous utilisez une image publique, vous devez activer l'accès au réseau public et configurer les paramètres de l'annotation de pod k8s.aliyun.com/eci-with-eip pour activer l'adresse IP élastique (EIP).\n3. Une fois que l'opération ApplyScalingGroup applique la configuration YAML, le groupe de mise à l'échelle et la configuration de mise à l'échelle prennent effet immédiatement. Si replicas est défini sur une valeur supérieure à 0, la création automatique de ressources est déclenchée.
Annotations prises en charge\nLes annotations sont référencées à partir de Annotation de pod ECI.\n|Paramètre|Exemple|Description|\n|-----|-----|-----|\n|k8s.aliyun.com/ess-scaling-group-min-size|1|Le nombre minimum d'instances dans le groupe de mise à l'échelle. Valeur par défaut : 0.\n|k8s.aliyun.com/ess-scaling-group-max-size|20|Le nombre maximum d'instances dans le groupe de mise à l'échelle. Valeur par défaut : max(replicas, 30).\n|k8s.aliyun.com/eci-ntp-server|100.100..|Le serveur NTP.\n|k8s.aliyun.com/eci-use-specs|2-4Gi|Les spécifications de l'instance, telles que 2 vCPU et 4 Gio de mémoire. Pour plus d'informations, consultez Créer un pod en utilisant plusieurs types d'instances.\n|k8s.aliyun.com/eci-vswitch|vsw-bp1xpiowfm5vo8o3c****|L'identifiant du vSwitch. Vous pouvez spécifier plusieurs vSwitch pour implémenter la fonctionnalité de zone multi-active.\n|k8s.aliyun.com/eci-security-group|sg-bp1dktddjsg5nktv****|L'identifiant du groupe de sécurité. Exigences : Vous pouvez spécifier un ou plusieurs groupes de sécurité. Un maximum de cinq groupes de sécurité peut être spécifié.
Les groupes de sécurité spécifiés doivent appartenir au même VPC.
Les groupes de sécurité spécifiés doivent être du même type.
\n|k8s.aliyun.com/eci-sls-enable|"false"|Indique si la collecte des journaux doit être désactivée. La valeur false indique que la collecte des journaux est désactivée.
Vous pouvez spécifier un ou plusieurs groupes de sécurité. Un maximum de cinq groupes de sécurité peut être spécifié.
Les groupes de sécurité spécifiés doivent appartenir au même VPC.
Les groupes de sécurité spécifiés doivent être du même type.
Lorsque vous collectez des journaux à l'aide de CRD Simple Log Service, si vous n'avez pas besoin de collecter des journaux pour des pods spécifiques, vous pouvez configurer cette annotation pour désactiver la fonctionnalité de collecte des journaux. Cela empêche le système de créer automatiquement Logtail et de gaspiller des ressources.
\n|k8s.aliyun.com/eci-spot-strategy|SpotAsPriceGo|La stratégie d'enchère pour l'instance spot. Valeurs valides :SpotWithPriceLimit : vous utilisez des paramètres personnalisés pour le prix horaire maximum de l'instance spot. Dans ce cas, vous devez définir k8s.aliyun.com/eci-spot-price-limit.
SpotAsPriceGo : le système place automatiquement des enchères en fonction du prix réel du marché actuel.
Ce paramètre prend effet uniquement lorsque les paramètres de k8s.aliyun.com/eci-spot-strategy sont SpotWithPriceLimit.
\n|k8s.aliyun.com/eci-with-eip|"true"|Indique si une EIP doit être créée et attachée automatiquement. La valeur true indique qu'une EIP est automatiquement créée et attachée.\n|k8s.aliyun.com/eci-data-cache-bucket|default|Le compartiment de DataCache. Ce paramètre est requis lorsque vous utilisez DataCache pour créer un pod.\n|k8s.aliyun.com/eci-data-cache-pl|PL1|Le niveau de performance (PL) du disque cloud créé sur la base de DataCache.Par défaut, un SSD standard ESSD est utilisé, et le PL par défaut est PL1.
\n|k8s.aliyun.com/eci-data-cache-provisionedIops|"40000"|Les IOPS de lecture et d'écriture provisionnés du disque cloud ESSD AutoPL. Valeurs valides : 0 à min{50000, 1000 × Capacité - Performance de base}. Performance de base = min{1800 + 50 × Capacité, 50000}. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.Si cette annotation est ajoutée, le disque cloud créé sur la base de DataCache est un disque cloud ESSD AutoPL.
\n|k8s.aliyun.com/eci-data-cache-burstingEnabled|"true"|Indique si la fonctionnalité de rafale doit être activée pour le disque cloud ESSD AutoPL. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.Si cette annotation est ajoutée, le disque cloud créé sur la base de DataCache est un disque cloud ESSD AutoPL.
\n|k8s.aliyun.com/eci-custom-tags|"env:test,name:alice"|La chaîne d'étiquette attachée au pod. Vous pouvez attacher jusqu'à trois étiquettes. Séparez la clé d'étiquette et la valeur d'étiquette par un caractère deux-points demi-chasse, et séparez plusieurs étiquettes par un caractère virgule demi-chasse.Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
ess:ApplyScalingGroup |
create |
*Toutes les ressources.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| Content |
string |
Oui |
Le contenu du fichier de configuration. |
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 |
Non |
L'identifiant de la région. |
cn-hangzhou |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Schéma de la réponse. |
||
| RequestId |
string |
L'identifiant de la requête. |
CC107349-57B7-4405-B1BF-9BF5AF7F**** |
| ScalingGroupId |
string |
L'identifiant du groupe de mise à l'échelle appliqué. |
asg-bp1igpak5ft1flyp**** |
Exemples
JSON format
{
"RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
"ScalingGroupId": "asg-bp1igpak5ft1flyp****"
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.