Features, scenarios, and common operations of Cloud Assistant - Elastic Compute Service

Fonctionnalités

Opérations par lots : Exécutez des commandes simultanément sur plusieurs instances. L'exécution est isolée pour chaque instance ; un échec sur l'une n'affecte pas les autres.
Téléchargement de fichiers : Envoyez des fichiers de configuration, des scripts ou d'autres ressources vers vos instances.
Commandes publiques : Utilisez des scripts et des plugins prédéfinis pour des tâches courantes telles que les audits de sécurité, l'application de correctifs du système d'exploitation et l'installation d'applications.
Commandes paramétrées : Définissez des paramètres personnalisés ou intégrés pour créer des modèles de commande réutilisables. Un seul modèle peut servir plusieurs scénarios en injectant différentes valeurs au moment de l'exécution.
Sécurité et contrôle : Cloud Assistant n'initie jamais d'actions de manière autonome ; vous conservez le contrôle total sur chaque opération.

Cas d'utilisation

Déploiement de logiciels : Poussez du code d'application, des mises à jour de configuration ou des correctifs urgents vers un parc d'instances en une seule opération.
Application de correctifs de sécurité : Déployez des correctifs du système d'exploitation ou des mises à jour de sécurité sur toutes les instances sans avoir à vous connecter individuellement à chacune d'elles.
Gestion du cycle de vie des logiciels : Gérez les cycles de vie du développement logiciel sur vos instances.
Configuration des instances : Modifiez les noms d'hôte ou réinitialisez les identifiants utilisateur par lot.
Surveillance des processus : Interrogez l'état des processus ou la santé des services sur plusieurs instances et centralisez la collecte des résultats.
Gestion des packages : Récupérez et installez des mises à jour depuis des dépôts OSS ou YUM.

Opérations courantes

Le tableau suivant associe les tâches courantes à leur documentation et aux références API correspondantes.

Tâche

Documentation

API

Installer l'agent

Install Cloud Assistant Agent

InstallCloudAssistant, DescribeCloudAssistantStatus

Utiliser le SDK

Exécuter des commandes à l'aide d'un SDK

--

Créer une commande

Create a command

RunCommand, CreateCommand

Exécuter une commande

Run a command

RunCommand, InvokeCommand

Vérifier les résultats

Afficher les résultats d'exécution et résoudre les problèmes courants

DescribeInvocations, DescribeInvocationResults

Modifier une commande

Modify a command

--

Cloner une commande

Clone a command

--

Arrêter une commande

Stop a command

StopInvocation

Supprimer une commande

Delete a command

DeleteCommand

Remarque

Cloud Assistant Agent est préinstallé sur les instances ECS créées à partir d'images publiques après le 1er décembre 2017.

Prérequis pour les instances

Les instances doivent être dans l'état Running.
Cloud Assistant Agent doit être installé. L'agent est préinstallé sur les instances créées à partir d'images publiques après le 1er décembre 2017. Pour les images personnalisées ou les images Alibaba Cloud Marketplace, vérifiez la compatibilité et installez Cloud Assistant Agent manuellement si nécessaire.

Systèmes d'exploitation pris en charge

Linux

Alibaba Cloud Linux
CentOS 6, 7, 8 et versions ultérieures
CoreOS
Debian 8, 9, 10 et versions ultérieures
OpenSUSE
Red Hat 5, 6, 7 et versions ultérieures

Remarque
Red Hat nécessite une installation manuelle du package RPM. Consultez la rubrique Install Cloud Assistant Agent.
SUSE Linux Enterprise Server 11, 12, 15 et versions ultérieures
Ubuntu 12, 14, 16, 18 et versions ultérieures
FreeBSD 11, 12, 13, 14 et versions ultérieures

Windows

Windows Server 2012, 2016, 2019 et versions ultérieures

Limites de charge utile et de paramètres

Toutes les tailles indiquées se rapportent à la charge utile encodée en Base64.

Opération

Taille maximale

Créer une commande

18 Ko

Exécuter immédiatement (enregistrer la commande)

18 Ko

Exécuter immédiatement (sans enregistrer)

24 Ko

Télécharger un fichier

32 Ko

Chaque commande prend en charge jusqu'à 20 paramètres personnalisés.

Matrice de compatibilité des fonctionnalités

Certaines fonctionnalités nécessitent une version minimale de Cloud Assistant Agent.

Fonctionnalité

Version minimale (Linux)

Version minimale (Windows)

Rapport de pulsation de l'agent

1.0.2.458

1.0.0.149

Distribution de fichiers

1.0.2.569

1.0.0.149

Exécution en tant qu'utilisateur spécifique

2.2.0.106

2.1.0.50

Exécution au prochain démarrage

2.2.0.46

2.1.0.50

Exécution à chaque démarrage

2.2.0.46

2.1.0.50

Prise en charge de Session Manager

2.2.3.196

2.1.3.196

Tâches planifiées (expressions Rate/At)

2.2.3.282

2.1.3.282

Tâches planifiées (Cron avec année/fuseau horaire)

2.2.3.282

2.1.3.282

Paramètres d'environnement intégrés

2.2.3.309

2.1.3.309

Noms d'instance comme paramètre

2.2.3.344

2.1.3.344

Arrêt ou redémarrage via le code de sortie

2.2.3.317

2.1.3.317

Exécution de conteneurs (par nom)

2.2.3.344

2.1.3.344

Exécution de conteneurs (par ID)

2.2.3.344

2.1.3.344

Facturation

Cloud Assistant est gratuit. Vous êtes facturé uniquement pour les ressources ECS (calcul, réseau, stockage) consommées lors de l'exécution des tâches. Consultez la rubrique Billing overview.

Surcoût des ressources

Cloud Assistant Agent a un impact minimal sur les performances des instances.

Ressource

Linux

Windows

CPU

< 1 % d'utilisation moyenne

Mémoire physique

~20 Mo

~30 Mo

E/S disque

Négligeable (pics uniquement lors des mises à niveau ou de l'enregistrement de scripts)

E/S réseau

Minime (trafic de pulsation)

État d'exécution des commandes

Cloud Assistant assure le suivi de l'exécution à deux niveaux : niveau instance (état par instance) et niveau invocation (état agrégé sur toutes les instances ciblées dans un lot).

Relationship between invocation status and instance-level status

État au niveau de l'instance

Ces états correspondent au champ InvocationStatus sous InvokeInstance dans l'API DescribeInvocations, ou au champ InvocationStatus dans l'API DescribeInvocationResults.

Code d'état

Description

Pending

Le système est en train de vérifier ou d'envoyer la commande.

Invalid

Type de commande ou paramètre non valide.

Aborted

Échec de l'envoi. L'instance doit être à l'état Running et la commande doit être livrée dans un délai d'une minute.

Running

La commande est en cours d'exécution sur l'instance.

Success

Terminée avec un code de sortie 0. Pour les tâches planifiées, la dernière exécution s'est terminée avec un code de sortie 0 et la planification est achevée.

Failed

Terminée avec un code de sortie non nul. Pour les tâches planifiées, un code de sortie non nul lors de la dernière exécution interrompt la tâche.

Error

Une exception s'est produite.

Timeout

Délai d'attente spécifié dépassé.

Cancelled

Annulée avant le début de l'exécution.

Stopping

Une demande d'arrêt a été envoyée ; l'exécution est en cours d'arrêt.

Stopped

Arrêtée manuellement.

Terminated

Interrompue pendant l'exécution.

Scheduled

En attente de la prochaine fenêtre d'exécution planifiée.

État au niveau de l'invocation

Pour les commandes par lots, Cloud Assistant agrège les états des instances en un seul état d'invocation renvoyé dans le champ InvocationStatus de l'API DescribeInvocations.

Code d'état

Règle d'agrégation

Pending

Au moins une instance est à l'état Pending.

Scheduled

Au moins une instance est à l'état Scheduled.

Running

Au moins une instance est à l'état Running.

Success

Toutes les instances ont terminé. Au moins une a signalé l'état Success. Pour les tâches immédiates, l'exécution s'est terminée avec un code de sortie 0. Pour les tâches planifiées, la dernière exécution s'est terminée avec un code de sortie 0 et la planification est achevée.

Failed

Toutes les instances ont terminé, mais aucune n'a réussi. Une instance est considérée comme ayant échoué si elle a signalé l'état Invalid, Aborted, Failed, Timeout ou Error.

Stopping

Au moins une instance est à l'état Stopping.

Stopped

Toutes les instances signalent l'état Stopped — toutes les tâches ont été annulées (Cancelled) ou interrompues (Terminated).

PartialFailed

Toutes les instances ont terminé avec des résultats mitigés : certaines ont réussi, tandis que d'autres ont échoué ou ont été arrêtées.

Autorisations (RAM)

Le compte Alibaba Cloud dispose par défaut d'un accès complet à Cloud Assistant. Pour un usage en production, créez un utilisateur RAM et accordez-lui uniquement les autorisations requises. Consultez la rubrique Accorder des autorisations à un utilisateur RAM pour utiliser Cloud Assistant.

Architecture de l'agent et structure des répertoires

Linux

Cloud Assistant Agent est installé dans le répertoire /usr/local/share/aliyun-assist/.

/usr/local/share/aliyun-assist/
- 2.x.x.xxx/ — Répertoire spécifique à la version (par exemple, 2.2.4.965/).
  - aliyun-service — Binaire principal de l'agent.
  - assist_daemon — Démon (watchdog) qui surveille aliyun-service et le redémarre en cas de plantage.
  - acs-plugin-manager — Utilitaire de gestion des plugins.
  - aliyun_assist_update — Utilitaire de mise à jour automatique.
  - aliyun_installer — Obsolète. Remplacé par acs-plugin-manager.
  - config/
    - GlobalSignRootCA.crt — Certificat racine pour la communication HTTPS.
    - hash_file — Hachages cryptographiques pour la vérification de l'intégrité.
  - init/
    - install, uninstall, clean — Scripts d'installation, de désinstallation et de nettoyage.
    - version — Version actuelle de l'agent.
  - log/
    - aliyun_assist_main.log — Fichier journal actif (jour en cours).
    - aliyun_assist_main.log.YYYYMMDD — Journaux archivés (rotation quotidienne).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin de collecte des informations système préinstallé.
- cache/
  - state_configs.json — Configuration mise en cache pour la collecte d'inventaire CloudOps Orchestration Service (OOS).
- config/
  - task_sign_certs/ — Clés publiques pour la vérification de la signature numérique des tâches.
- hybrid/
  - hardwareHash — Empreinte matérielle pour l'enregistrement des instances gérées.
- plugin/
  - installed_plugins.db — Base de données des plugins installés.
- work/
  - script/ — Répertoire de transit pour les scripts d'exécution.
    
    Remarque
    À partir de la version 2.x.3.704, Cloud Assistant n'enregistre plus les scripts d'exécution sur le disque par défaut. Activez manuellement la fonctionnalité d'enregistrement des scripts pour afficher les fichiers exécutés dans ce répertoire.
- region-id — ID de la région de l'instance.

Windows

Cloud Assistant Agent est installé dans le répertoire C:\ProgramData\aliyun\assist\.

C:\ProgramData\aliyun\assist\
- 2.x.x.xxx/ — Répertoire spécifique à la version (par exemple, 2.1.4.965).
  - aliyun_assist_service.exe — Binaire principal de l'agent.
  - acs-plugin-manager.exe — Utilitaire de gestion des plugins.
  - aliyun_assist_update.exe — Utilitaire de mise à jour automatique.
  - aliyun_installer.exe — Programme d'installation.
  - install.bat, install.exe — Scripts d'installation.
  - PatchGo.dll — Correctif d'exécution pour Windows Server 2008 afin d'atténuer la dérive de l'horloge Go.
  - version.ini — Configuration de la version de l'agent.
  - config/
    - GlobalSignRootCA.crt — Certificat racine pour la communication HTTPS.
    - hash_file — Hachages cryptographiques pour la vérification de l'intégrité.
  - log/
    - aliyun_assist_main.log — Fichier journal actif (jour en cours).
    - aliyun_assist_main.log.YYYYMMDD — Journaux archivés (rotation quotidienne).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin de collecte des informations système.
    - SessionManager — Plugin de gestion de session sans mot de passe.
    - installed_plugins.db — Base de données des plugins installés.
- cache/
  - state_configs.json — Configuration mise en cache pour la collecte d'inventaire OOS.
- config/
  - task_sign_certs/ — Clés publiques pour la vérification de la signature des tâches.
- hybrid/ — Données d'enregistrement des instances gérées.
- plugin/
  - installed_plugins.db — Base de données des plugins.
- work/
  - script/ — Répertoire de transit pour les scripts d'exécution.
    
    Remarque
    À partir de la version 2.x.3.704, Cloud Assistant n'enregistre plus les scripts d'exécution sur le disque par défaut. Activez manuellement la fonctionnalité d'enregistrement des scripts pour afficher les fichiers exécutés dans ce répertoire.
- config.ini — Configuration globale, y compris la version actuelle de l'agent.
- region-id — ID de la région de l'instance.
- version — Version actuelle de l'agent.

Termes

Terme

Description

Cloud Assistant

Le service. Disponible dans toutes les régions Alibaba Cloud.

Cloud Assistant Agent

Le binaire client sur chaque instance. Nom du processus : aliyun-service (Linux) ou aliyun_assist_service (Windows).

AssistDaemon

Un watchdog qui surveille et redémarre l'agent en cas de plantage. Disponible uniquement sous Linux. Nom du service : AssistDaemon. Chemin : /usr/local/share/assist-daemon/assist_daemon.

Répertoire de travail

Le chemin où les scripts sont temporairement mis en zone de transit (si l'enregistrement des scripts est activé). Linux : /tmp. Windows : <Chemin d'installation de Cloud Assistant>/work/script.

Commande

La charge utile d'opération envoyée à une instance. Types : Shell, PowerShell et Bat.

Paramètre personnalisé

Une variable définie avec la syntaxe {{key}}. Les valeurs sont injectées au moment de l'exécution à l'aide de {{"key":"value"}}. Utilisez des paramètres personnalisés pour créer des modèles de commande réutilisables et optimiser l'utilisation par rapport aux quotas régionaux. Cloud Assistant fournit également des paramètres d'environnement intégrés renseignés automatiquement au moment de l'exécution.

Exécution unique

Un événement d'exécution unique sur une ou plusieurs instances (également appelé invocation).

Exécution planifiée

Une commande configurée pour s'exécuter périodiquement.