Ajouter une version à un Distributor package

Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

Dans le volet de navigation, choisissez Distributor.

Sur le Distributor page d'accueil, choisissez le package auquel vous souhaitez ajouter une autre version.

Sur la page Add version (Ajouter une version), sélectionnez Simple.

Pour Version name (Nom de version), saisissez un nom de version. Le nom de version de la nouvelle version doit être différent des noms des anciennes versions. Les noms de version peuvent comporter 512 caractères au maximum et ne peuvent pas contenir de caractères spéciaux.

Pour S3 bucket name (Nom du compartiment S3), sélectionnez un compartiment S3 existant dans la liste. Il peut s'agir du même compartiment que celui que vous avez utilisé afin de stocker les fichiers installables pour les versions antérieures, mais les noms de fichier installable doivent être différents pour éviter d'écraser les fichiers installables existants dans le compartiment.

Pour S3 key prefix (Préfixe de clé S3), entrez le sous-dossier du compartiment dans lequel vos ressources installables sont stockées.

Pour Upload software (Charger des logiciels), recherchez les fichiers de logiciels installables que vous voulez attacher à la nouvelle version. Les fichiers installables de versions existantes ne sont pas automatiquement copiés vers une nouvelle version ; vous devez charger les fichiers installables de versions antérieures du package si vous voulez que les mêmes fichiers installables fassent partie de la nouvelle version. Vous pouvez charger plusieurs fichiers de logiciel en une seule action.

Pour Target platform (Plateforme cible), vérifiez que la plateforme de système d'exploitation cible pour chaque fichier installable est correcte. Si le système d'exploitation indiqué n'est pas correct, sélectionnez le système d'exploitation approprié dans la liste déroulante.

Dans le flux de travail de gestion des versions Simple, comme vous chargez chaque fichier installable une seule fois, des étapes supplémentaires sont nécessaires pour cibler un seul fichier sur plusieurs systèmes d'exploitation. Par exemple, si vous téléchargez un fichier logiciel installable nomméLogtool_v1.1.1.rpm, vous devez modifier certaines valeurs par défaut dans le flux de travail simple pour indiquer Distributor pour cibler le même logiciel sur les systèmes d'exploitation Amazon Linux et Ubuntu. Vous pouvez effectuer l'une des actions suivantes pour contourner cette limite.

Pour Platform version (Version de plateforme), vérifiez que la version de plateforme de système d'exploitation est _any, une version majeure suivie d'un caractère générique (7.*), ou la version de système d'exploitation exacte spécifique à laquelle vous souhaitez que votre logiciel s'applique. Pour plus d'informations sur la spécification d'une version de plateforme, consultez l'étape 4 de Étape 2 : Création du manifeste JSON du package.

Pour Architecture, sélectionnez l'architecture de processeur correcte pour chaque fichier installable dans la liste déroulante. Pour plus d'informations sur les architectures prises en charge, consultez Architectures et plateformes de package prises en charge.

(Facultatif) Développez les scripts et passez en revue les scripts d'installation et de désinstallation qui Distributor génère pour votre logiciel installable.

Pour ajouter d'autres fichiers de logiciels installables à la nouvelle version, sélectionnez Add software (Ajouter des logiciels). Sinon, accédez à l'étape suivante.

(Facultatif) Développez le manifeste et passez en revue le manifeste JSON du package qui Distributor génère pour votre logiciel installable. Si vous avez modifié des informations relatives à vos logiciels installables depuis que vous avez commencé cette procédure, comme la version de plateforme ou la plateforme cible, sélectionnez Generate manifest (Générer un manifeste) pour afficher le manifeste de package mis à jour.

Vous pouvez modifier le manifeste manuellement si vous souhaitez cibler un logiciel installable pour plusieurs systèmes d'exploitation, comme décrit à l'étape 9. Pour plus d'informations sur la modification du manifeste, consultez Étape 2 : Création du manifeste JSON du package.

Lorsque vous avez fini d'ajouter des logiciels et de vérifier les données de plateforme cible, de version et d'architecture, sélectionnez Add version (Ajouter une version).

Attendre Distributor pour terminer le téléchargement de votre logiciel et la création de la nouvelle version du package. Distributor indique l'état du téléchargement pour chaque fichier installable. Selon le nombre et la taille des colis que vous ajoutez, cela peut prendre quelques minutes. Distributor vous redirige automatiquement vers la page des détails du package, mais vous pouvez choisir d'ouvrir cette page vous-même une fois le logiciel téléchargé. La page des détails du package n'affiche pas toutes les informations relatives à votre package avant Distributor termine la création de la nouvelle version du package. Pour arrêter le chargement et la création de la version de package, sélectionnez Stop upload (Arrêter le chargement).

If Distributor Impossible de télécharger aucun des fichiers installables du logiciel, il affiche un message d'échec du téléchargement. Pour relancer le chargement, sélectionnez Retry upload (Réessayer le chargement). Pour plus d'informations sur la façon de résoudre les échecs de création de version de package, consultez Résolution des problèmes de AWS Systems Manager Distributor.

Lorsque Distributor a terminé de créer la nouvelle version du package, sur la page Détails du package, sous l'onglet Versions, affichez la nouvelle version dans la liste des versions de package disponibles. Définissez une version par défaut du package en choisissant une version, puis en choisissant Set default version (Définir la version par défaut).

Si vous ne définissez aucune version par défaut, c'est la version la plus récente du package qui est la version par défaut.

Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

Dans le volet de navigation, choisissez Distributor.

Sur le Distributor page d'accueil, choisissez le package auquel vous souhaitez ajouter une autre version, puis choisissez Ajouter une version.

Dans Version name (Nom de la version), saisissez la valeur exacte de l'entrée version de votre fichier manifeste.

Pour S3 bucket name (Nom du compartiment S3), sélectionnez un compartiment S3 existant dans la liste. Il peut s'agir du même compartiment que celui que vous avez utilisé afin de stocker les fichiers installables pour les versions antérieures, mais les noms de fichier installable doivent être différents pour éviter d'écraser les fichiers installables existants dans le compartiment.

Pour S3 key prefix (Préfixe de clé S3), entrez le sous-dossier du compartiment dans lequel vos ressources installables sont stockées.

Pour Manifest (Manifeste), sélectionnez Extract from package (Extraire depuis le package) pour utiliser un manifeste que vous avez chargé dans le compartiment S3 avec vos fichiers .zip.

(Facultatif) Si vous n'avez pas chargé votre JSON manifeste révisé dans le compartiment Amazon S3 dans lequel vous avez stocké vos fichiers .zip, choisissez Nouveau manifeste. Vous pouvez créer ou coller l'intégralité du manifeste dans le champ de l'JSONéditeur. Pour plus d'informations sur la façon de créer le JSON manifeste, consultezÉtape 2 : Création du manifeste JSON du package.

Lorsque vous avez fini avec le fichier manifeste, sélectionnez Add package version (Ajouter une version de package).

Sur la page Details (Détails) du package, dans l'onglet Versions, vous voyez s'afficher la nouvelle version dans la liste des versions de package disponibles. Définissez une version par défaut du package en choisissant une version, puis en choisissant Set default version (Définir la version par défaut).

Si vous ne définissez aucune version par défaut, c'est la version la plus récente du package qui est la version par défaut.

Exécutez la commande suivante pour modifier le AWS Systems Manager document contenant une entrée pour une nouvelle version du package. Remplacez document-name avec le nom de votre document. Remplacez amzn-s3-demo-bucket avec URL le JSON manifeste que vous avez copiéÉtape 3 : Chargement du package et du manifeste dans un compartiment Amazon S3. S3-bucket-URL-of-package est celui URL du compartiment Amazon S3 dans lequel l'ensemble du package est stocké. Remplacez version-name-from-updated-manifest avec la valeur de version dans le manifeste. Définissez le paramètre --document-version sur $LATEST pour que le document associé à cette version de package soit la dernière version du document.

aws ssm update-document \
    --name "document-name" \
    --content "S3-bucket-URL-to-manifest-file" \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-name-from-updated-manifest \
    --document-version $LATEST

Voici un exemple.

aws ssm update-document \
    --name ExamplePackage \
    --content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.1.1 \
    --document-version $LATEST

Exécutez la commande suivante pour vérifier que votre package a été mis à jour et afficher le manifeste du package. Remplacez package-name avec le nom de votre package, et éventuellement, document-version avec le numéro de version du document (différent de la version du package) que vous avez mis à jour. Si cette version de package est associée à la dernière version du document, vous pouvez spécifier $LATEST pour la valeur du paramètre facultatif --document-version.

aws ssm get-document \
    --name "package-name" \
    --document-version "document-version"