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 AWS Serverless Application Model commande (AWS SAMCLI) par le biais de la mise à niveau, de la rétrogradation et de la désinstallation. 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

Le AWS SAMCLI doit être mis à niveau en utilisant la même méthode que celle utilisée pour l'installer. Nous vous recommandons d'utiliser le programme d'installation du package pour installer et mettre à niveau le AWS SAMCLI.

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 effectuer la mise à niveau AWS SAMCLI, répétez les étapes d'installation de Installer la CLI  AWS SAM Windows.

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

      La sortie indique le chemin où se trouvent AWS SAM les fichiers binaires, 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 du package pour installer le AWS SAMCLI.

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. AWS SAMCLI$PATHSupprimez-le 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 le AWS SAMCLI.

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

Si vous avez l'habitude Homebrew d'installer et de mettre à niveau le AWS SAMCLI, nous vous recommandons d'utiliser une méthode AWS compatible. 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 Installer 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 Installer 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 du package natif pour installer le AWS SAMCLI. 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, AWS SAM CLI le support pourPython 3.7. 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

À compter de septembre 2023, le programme d'Homebrewinstallation AWS géré pour le AWS SAMCLI (aws/tap/aws-sam-cli) ne AWS sera plus maintenu. 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' AWS SAMCLIHomebrewinstallation 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

    Une fois l'installation réussie du AWS SAMCLI, vous devriez voir le résultat suivant :

    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'Homebrewinstallation AWS géré (aws/tap/aws-sam-cli) et que vous préférez continuer à l'utiliserHomebrew, nous vous recommandons de passer au programme d'Homebrewinstallation géré par la communauté (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 Homebrew version AWS gérée de AWS SAMCLI :

    $ brew uninstall aws-sam-cli

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

    $ which sam
sam not found

  3. Supprimez le AWS SAMCLI robinet AWS géré :

    $ 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. Supprimez les fichiers mis en cache pour le programme d'installation AWS géré :

    $ brew cleanup aws/tap

  5. Mettre à jour Homebrew et toutes les formules :

    $ brew update

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

    $ 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 du AWS SAMCLI, consultezRésolution des problèmes de la CLI AWS SAM.