Gestion des versions CLI AWS SAM - AWS Serverless Application Model
Mise à niveau de la CLI AWS SAM en coursDésinstallation de la CLI AWS SAMPasser de HomebrewGestion de la compilation nocturne de la CLI AWS SAMInstallation de la CLI AWS SAM dans un environnement virtuel à l'aide de pipGestion de la CLI AWS SAM avec HomebrewRésolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des versions CLI AWS SAM

Gérez les versions de votre interface de ligne de commande AWS Serverless Application Model (CLI AWS SAM) en les mettant à jour, en revenant à des versions antérieures ou en les désinstallant. Vous pouvez également télécharger et installer la compilation nocturne de la CLI AWS SAM.

Mise à niveau de la CLI AWS SAM en cours

Pour mettre à niveau la CLI AWS SAM sous Linux, suivez les instructions d'installation de Installation de la CLI  AWS SAM, mais ajoutez l'option --update à la commande d'installation, comme suit :

sudo ./sam-installation/install --update

La CLI AWS SAM doit être mise à niveau via la même méthode que celle utilisée pour l'installer. Nous vous recommandons d'utiliser le programme d'installation de packages pour installer et mettre à niveau la CLI AWS SAM.

Pour mettre à niveau la CLI AWS SAM à l'aide du programme d'installation de packages, installez la dernière version du package. Pour obtenir des instructions, veuillez consulter Installation de la CLI  AWS SAM.

Pour mettre à niveau la CLI AWS SAM, répétez à nouveau les étapes d'installation de Windows dans Installation de la CLI  AWS SAM.

Désinstallation de la CLI AWS SAM

Pour désinstaller la CLI AWS SAM sous Linux, vous devez supprimer le lien symbolique et le répertoire d'installation en exécutant les commandes suivantes :

  1. Localisez le lien symbolique et les chemins d'installation.

    • Utilisez la commande which pour trouver le lien symbolique.

      which sam

      Le résultat affiche le chemin d'accès où les binaires AWS SAM sont situés, par exemple :

       /usr/local/bin/sam

    • Utilisez la commande ls pour rechercher le répertoire vers lequel pointe le lien symbolique.

      ls -l /usr/local/bin/sam

      Dans l'exemple suivant, le répertoire d'installation est /usr/local/aws-sam-cli.

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam

  2. Supprimez le lien symbolique.

    sudo rm /usr/local/bin/sam

  3. Supprimez le répertoire d'installation.

    sudo rm -rf /usr/local/aws-sam-cli

Désinstallez la CLI AWS SAM par la même méthode que celle utilisée pour l'installer. Nous vous recommandons d'utiliser le programme d'installation de packages pour installer la CLI AWS SAM.

Si vous avez installé la CLI AWS SAM à l'aide du programme d'installation de packages, suivez ces étapes pour la désinstaller.

Pour désinstaller la CLI AWS SAM

  1. Supprimez le programme CLI AWS SAM en modifiant et en exécutant ce qui suit : 

    $ sudo rm -rf /path-to/aws-sam-cli

    1. sudo : si votre utilisateur dispose d'autorisations d'écriture pour l'emplacement où le programme CLI AWS SAM est installé, sudo n'est pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

    2. /path-to : chemin d'accès vers l'emplacement d'installation du programme CLI AWS SAM. L'emplacement par défaut est /usr/local.

  2. Supprimez le $PATH de la CLI AWS SAM en modifiant et en exécutant ce qui suit : 

    $ sudo rm -rf /path-to-symlink-directory/sam

    1. sudo : si votre utilisateur dispose d'autorisations d'écriture pour $PATH, sudo n'est pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

    2. path-to-symlink-directory— Votre variable d'$PATHenvironnement. L'emplacement par défaut est /usr/local/bin.

  3. Procédez comme suit pour vérifier que la CLI AWS SAM est bien désinstallée : 

    $ sam --version
command not found: sam

Pour désinstaller la CLI AWS SAM en utilisant les paramètres Windows, procédez aux étapes suivantes :

  1. Dans le menu Démarrer, recherchez « Ajouter ou supprimer des programmes ».

  2. Sélectionnez le résultat nommé Interface de ligne de commande AWS SAM et cliquez sur Uninstall (Désinstaller) pour lancer le programme de désinstallation.

  3. Confirmez que vous souhaitez désinstaller la CLI AWS SAM.

Passer de l'utilisation de Homebrew pour gérer la CLI AWS SAM

Si vous utilisez Homebrew pour installer et mettre à niveau la CLI AWS SAM, nous vous recommandons d'utiliser une méthode prise en charge par AWS. Suivez ces instructions pour passer à une méthode prise en charge.

Pour passer de l'utilisation de Homebrew

  1. Suivez les instructions décrites dans Désinstaller un Homebrew installé CLI AWS SAM pour désinstaller la version gérée par Homebrew.

  2. Suivez les instructions décrites dans Installation de la CLI  AWS SAM pour installer la CLI AWS SAM à l’aide d’une méthode prise en charge.

Gestion de la compilation nocturne de la CLI AWS SAM

Vous pouvez télécharger et installer la compilation nocturne de la CLI AWS SAM. Celle-ci contient une version préliminaire du code de la CLI AWS SAM qui peut être moins stable que la version de production. Une fois installée, vous pouvez utiliser la compilation nocturne à l'aide de la commande sam-nightly. Vous pouvez installer à la fois les versions de production et de compilation nocturne de la CLI AWS SAM et les utiliser en même temps.

Note

La compilation nocturne ne contient pas de version préliminaire de l'image de compilation. Ainsi, la création de votre application sans serveur à l'aide de l'option --use-container utilise la dernière version de production de l'image de compilation.

Installation de la compilation nocturne de la CLI AWS SAM

Pour installer la compilation nocturne de la CLI AWS SAM, suivez ces instructions.

Vous pouvez installer la version de compilation nocturne de la CLI AWS SAM sur la plateforme Linux x86_64à l'aide du programme d'installation de packages.

Pour installer la compilation nocturne de la CLI AWS SAM

  1. Téléchargez le programme d'installation du sam-cli-nightlypackage depuis le aws-sam-cli GitHubréférentiel.

  2. Suivez les étapes d'installation de la CLI AWS SAM pour installer le package de compilation nocturne.

Vous pouvez installer la version de compilation nocturne de la CLI AWS SAM sur macOS à l'aide du programme d'installation du package de compilation nocturne.

Pour installer la compilation nocturne de la CLI AWS SAM

  1. Téléchargez le programme d'installation du package pour votre plate-forme depuis sam-cli-nightlyle aws-sam-cli GitHubréférentiel.

  2. Suivez les étapes d'installation de la CLI AWS SAM pour installer le package de compilation nocturne.

La version de compilation nocturne de la CLI AWS SAM est disponible via le lien de téléchargement suivant : compilation nocturne de la CLI AWS SAM. Pour installer la compilation nocturne sur Windows, exécutez les mêmes étapes que celles décrites dans Installation de la CLI  AWS SAM, mais utilisez plutôt le lien de téléchargement de compilation nocturne à la place.

Pour vérifier que vous avez installé la version de compilation nocturne, exécutez la commande sam-nightly --version. La sortie de cette commande est sous la forme 1.X.Y.dev<YYYYMMDDHHmm>, par exemple :

SAM CLI, version 1.20.0.dev202103151200

Passer de Homebrew au package d'installation

Si vous utilisez Homebrew pour installer et mettre à niveau la compilation nocturne de la CLI AWS SAM et souhaitez opter pour l'utilisation du programme d'installation de package, procédez comme suit.

Pour passer de Homebrew au package d'installation

  1. Désinstallez la compilation nocturne de la CLI AWS SAM installée par Homebrew.

    $ brew uninstall aws-sam-cli-nightly

  2. Procédez comme suit pour vérifier que la compilation nocturne de la CLI AWS SAM est bien désinstallée :

    $ sam-nightly --version
zsh: command not found: sam-nightly

  3. Suivez les étapes décrites dans la section précédente pour installer la compilation nocturne de la CLI AWS SAM.

Installation de la CLI AWS SAM dans un environnement virtuel à l'aide de pip

Nous vous recommandons d'utiliser le programme d'installation de packages natif pour installer la CLI AWS SAM. Si vous devez utiliser pip, nous vous recommandons d'installer la CLI AWS SAM dans un environnement virtuel. Cela garantit un environnement d'installation propre et un environnement isolé en cas d'erreurs.

Note

À compter du 24 octobre 2023, Python 3.7 n'est plus pris en charge par l'CLI AWS SAM. Pour en savoir plus, veuillez consulter la section Fin de la prise en charge de Python 3.7 par l'CLIAWS SAM.

Pour installer la CLI AWS SAM dans un environnement virtuel

  1. À partir du répertoire de départ de votre choix, créez un environnement virtuel et nommez-le.

    Linux / macOS
    $ mkdir project
$ cd project
$ python3 -m venv venv
    Windows
    > mkdir project
> cd project
> py -3 -m venv venv

  2. Activer l'environnement virtuel

    Linux / macOS
    $ . venv/bin/activate

    L'invite change pour vous indiquer que votre environnement virtuel est actif.

    (venv) $
    Windows
    > venv\Scripts\activate

    L'invite change pour vous indiquer que votre environnement virtuel est actif.

    (venv) >

  3. Installez la CLI AWS SAM dans votre environnement virtuel.

    (venv) $ pip install --upgrade aws-sam-cli

  4. Vérifiez que la CLI AWS SAM est installée correctement.

    (venv) $ sam --version
SAM CLI, version 1.94.0

  5. La commande deactivate vous permet de quitter l'environnement virtuel. Réactivez l'environnement chaque fois que vous démarrez une nouvelle session.

Gestion de la CLI AWS SAM avec Homebrew

Note

À partir de septembre 2023, AWS ne conservera plus le programme d'installation Homebrew géré par AWS pour la CLI AWS SAM (aws/tap/aws-sam-cli). Pour continuer à utiliser Homebrew, vous pouvez utiliser le programme d'installation géré par la communauté (aws-sam-cli). À partir de septembre 2023, toute commande Homebrew faisant référence à aws/tap/aws-sam-cli sera redirigée vers aws-sam-cli.

Nous vous recommandons d'utiliser nos méthodes d'installation et de mise à niveau.

Installation de la CLI AWS SAM à l'aide de Homebrew

Note

Ces instructions utilisent le programme d'installation Homebrew de la CLI AWS SAM géré par la communauté. Pour assistance complémentaire, consultez le référentiel homebrew-core.

Pour installer la CLI AWS SAM

  1. Exécutez les commandes suivantes :

    $ brew install aws-sam-cli

  2. Vérifier l'installation :

    $ sam --version

    Après l'installation réussie de la CLI AWS SAM, vous devriez voir une réponse générée semblable à la suivante :

    SAM CLI, version 1.94.0

Mise à niveau de la CLI AWS SAM à l'aide de Homebrew

Pour mettre à niveau la CLI AWS SAM à l'aide de Homebrew, exécutez la commande suivante :

$ brew upgrade aws-sam-cli

Désinstaller un Homebrew installé CLI AWS SAM

Si la CLI AWS SAM a été installée à l'aide de Homebrew, procédez comme suit pour la désinstaller.

Pour désinstaller la CLI AWS SAM

  1. Exécutez les commandes suivantes :

    $ brew uninstall aws-sam-cli

  2. Procédez comme suit pour vérifier que la CLI AWS SAM est bien désinstallée :

    $ sam --version
command not found: sam

Passer au programme d'installation géré par la communauté Homebrew

Si vous utilisez le programme d'installation AWS géré par Homebrew (aws/tap/aws-sam-cli) et préférez continuer à utiliser Homebrew, nous vous recommandons de passer au programme d'installation gérée par Homebrew (aws-sam-cli).

Pour passer dans une seule commande, exécutez la commande suivante :

$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli

Suivez ces instructions pour exécuter chaque commande individuellement.

Pour passer au programme d'installation géré par la communauté Homebrew

  1. Désinstallez la version Homebrew gérée par AWS de la CLI AWS SAM :

    $ brew uninstall aws-sam-cli

  2. Vérifiez que la CLI AWS SAM a été désinstallée :

    $ which sam
sam not found

  3. Supprimer l'appui CLI AWS SAM géré par AWS :

    $ brew untap aws/tap

    Si vous recevez un message d'erreur comme celui-ci, ajoutez l'option --force et réessayez.

    Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
aws-sam-cli-nightly

  4. Supprimer les fichiers mis en cache pour le programme d'installation géré par AWS :

    $ brew cleanup aws/tap

  5. Mettre à jour Homebrew et toutes les formules :

    $ brew update

  6. Installez la version de la CLI AWS SAM gérée par la communauté :

    $ brew install aws-sam-cli

  7. Vérifiez que la CLI AWS SAM est correctement installée :

    $ sam --version
SAM CLI, version 1.94.0

Résolution des problèmes

Si vous rencontrez des erreurs lors de l'installation ou de l'utilisation de la CLI AWS SAM, consultez Résolution des problèmes de la CLI AWS SAM.