Gérer AWS SAM CLI versions - AWS Serverless Application Model
Mise à niveau du AWS SAM CLIDésinstallation du AWS SAM CLIPasser de HomebrewGérer le AWS SAM CLI construction nocturneInstallation du AWS SAM CLI dans un environnement virtuel en utilisant pipGérer le AWS SAM CLI 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.

Gérer AWS SAM CLI versions

Gérez votre interface de ligne de AWS Serverless Application Model commande (AWS SAM CLI) versions via la mise à niveau, la rétrogradation et la désinstallation. Vous pouvez éventuellement télécharger et installer le AWS SAM CLI construction nocturne.

Mise à niveau du AWS SAM CLI

Pour mettre à niveau le AWS SAM CLI sous Linux, suivez les instructions d'installation indiquées dansInstallation du AWS SAM CLI, mais ajoutez l'--updateoption à la commande d'installation, comme suit :

sudo ./sam-installation/install --update

Le AWS SAM CLI 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 SAM CLI.

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

Pour mettre à niveau le AWS SAM CLI, répétez les étapes d'installation de Installez le AWS SAM CLI Windows.

Désinstallation du AWS SAM CLI

Pour désinstaller le AWS SAM CLI 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 le AWS SAM CLI 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 le AWS SAM CLI.

Si vous avez installé le AWS SAM CLI à l'aide du programme d'installation du package, procédez comme suit pour le désinstaller.

Pour désinstaller le AWS SAM CLI

  1. Supprimez le AWS SAM CLI programmez 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 sur l'endroit où AWS SAM CLI le programme est installé, n'sudoest pas requis. Dans le cas contraire, la valeur sudo est obligatoire.

    2. /path-to— Chemin d'accès à l'endroit où vous avez installé le AWS SAM CLI programme. L'emplacement par défaut est /usr/local.

  2. Supprimez le AWS SAM CLI $PATHen 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, ce n'sudoest 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. Vérifiez que le AWS SAM CLI est désinstallé en exécutant ce qui suit : 

    $ sam --version
command not found: sam

Pour désinstaller le AWS SAM CLI à l'aide des paramètres Windows, procédez comme suit :

  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 SAM CLI.

Arrêtez d'utiliser Homebrew pour gérer le AWS SAM CLI

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

Pour ne plus utiliser Homebrew

  1. Suivez les instructions Désinstaller un HomebrewAWS SAM CLI installée de désinstallation du Homebrew version gérée.

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

Gérer le AWS SAM CLI construction nocturne

Vous pouvez télécharger et installer le AWS SAM CLI construction nocturne. Il contient une version préliminaire du AWS SAM CLI code 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 et utiliser à la fois les versions de production et de construction nocturne du AWS SAM CLI 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 du AWS SAM CLI construction nocturne

Pour installer le AWS SAM CLI Construisez tous les soirs, suivez ces instructions.

Vous pouvez installer la version de construction nocturne du AWS SAM CLI sur le Linux plate-forme x86_64 utilisant le programme d'installation du package.

Pour installer le AWS SAM CLI construction nocturne

  1. Téléchargez le programme d'installation du package depuis sam-cli-nightlyle aws-sam-cli GitHub référentiel.

  2. Suivez les étapes d'installation du AWS SAM CLIpour installer le package nightly build.

Vous pouvez installer la version de construction nocturne du AWS SAM CLI on macOS, en utilisant le programme d'installation du package nightly build.

Pour installer le AWS SAM CLI construction nocturne

  1. Téléchargez le programme d'installation du package pour votre plateforme depuis sam-cli-nightlyle aws-sam-cli GitHub référentiel.

  2. Suivez les étapes d'installation du AWS SAM CLIpour installer le package nightly build.

La version de construction nocturne du AWS SAM CLI est disponible via ce lien de téléchargement : AWS SAM CLI construction nocturne. Pour installer la compilation nocturne sur Windows, exécutez les mêmes étapes que celles décrites dans Installez le AWS SAM CLI, 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 programme d'installation du package

Si vous utilisez Homebrew pour installer et mettre à niveau le AWS SAM CLI compilez tous les soirs et si vous souhaitez passer à l'installation du package, procédez comme suit.

Pour passer de Homebrew au programme d'installation du package

  1. Désinstallez le Homebrew installé AWS SAM CLI construction nocturne.

    $ brew uninstall aws-sam-cli-nightly

  2. Vérifiez que le AWS SAM CLI nightly build est désinstallé en exécutant ce qui suit :

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

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

Installation du AWS SAM CLI dans un environnement virtuel en utilisant pip

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

Note

Au 24 octobre 2023, le AWS SAM CLI met fin à la prise en charge de Python 3.7. Pour en savoir plus, consultezAWS SAM CLI interruption du support pour Python 3.7.

Pour installer le AWS SAM CLI 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 le AWS SAM CLI dans votre environnement virtuel.

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

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

    (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.

Gérer le AWS SAM CLI avec Homebrew

Note

À partir de septembre 2023, AWS nous ne maintiendrons plus AWS le Homebrew installateur pour le AWS SAM CLI (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, tous Homebrew commande vers laquelle les références aws/tap/aws-sam-cli seront redirigéesaws-sam-cli.

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

Installation du AWS SAM CLI utilisant Homebrew

Note

Ces instructions utilisent la communauté gérée AWS SAM CLI Homebrew installateur. Pour assistance complémentaire, consultez le référentiel homebrew-core.

Pour installer le AWS SAM CLI

  1. Exécutez les commandes suivantes :

    $ brew install aws-sam-cli

  2. Vérifier l'installation :

    $ sam --version

    Après une installation réussie du AWS SAM CLI, vous devriez voir un résultat comme celui-ci :

    SAM CLI, version 1.94.0

Mise à niveau du AWS SAM CLI utilisant Homebrew

Pour mettre à niveau le AWS SAM CLI utilisant Homebrew, exécutez la commande suivante :

$ brew upgrade aws-sam-cli

Désinstaller un HomebrewAWS SAM CLI installée

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

Pour désinstaller le AWS SAM CLI

  1. Exécutez les commandes suivantes :

    $ brew uninstall aws-sam-cli

  2. Vérifiez que le AWS SAM CLI est désinstallé en exécutant ce qui suit :

    $ sam --version
command not found: sam

Passage à la gestion communautaire Homebrew installer (programme d'installation)

Si vous utilisez le AWS gestionnaire Homebrew installer (aws/tap/aws-sam-cli) et préférez continuer à utiliser Homebrew, nous vous recommandons de passer à la version gérée par la communauté Homebrew installateur (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 à la gestion par la communauté Homebrew installer (programme d'installation)

  1. Désinstallez le AWS gestionnaire Homebrew version du AWS SAM CLI:

    $ brew uninstall aws-sam-cli

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

    $ which sam
sam not found

  3. Supprimer le AWS géré AWS SAM CLI robinet :

    $ 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é du AWS SAM CLI:

    $ brew install aws-sam-cli

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

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