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.
Rubriques
- Mise à niveau de la CLI AWS SAM en cours
- Désinstallation de la CLI AWS SAM
- Passer de l'utilisation de Homebrew pour gérer la CLI AWS SAM
- Gestion de la compilation nocturne de la CLI AWS SAM
- Installation de la CLI AWS SAM dans un environnement virtuel à l'aide de pip
- Gestion de la CLI AWS SAM avec Homebrew
- Résolution des problèmes
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 :
-
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
-
-
Supprimez le lien symbolique.
sudo rm /usr/local/bin/sam
-
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
-
Supprimez le programme CLI AWS SAM en modifiant et en exécutant ce qui suit :
$
sudo
rm -rf/path-to
/aws-sam-cli-
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. -
/path-to
: chemin d'accès vers l'emplacement d'installation du programme CLI AWS SAM. L'emplacement par défaut est/usr/local
.
-
-
AWS SAMCLI
$PATH
Supprimez-le en modifiant et en exécutant ce qui suit :$
sudo
rm -rf/path-to-symlink-directory
/sam-
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. -
path-to-symlink-directory
— Votre variable d'$PATH
environnement. L'emplacement par défaut est/usr/local/bin
.
-
-
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 :
-
Dans le menu Démarrer, recherchez « Ajouter ou supprimer des programmes ».
-
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.
-
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
-
Suivez les instructions décrites dans Désinstaller un Homebrew installé CLI AWS SAM pour désinstaller la version gérée par Homebrew.
-
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
-
Téléchargez le programme d'installation du sam-cli-nightly
package depuis le aws-sam-cli GitHubréférentiel. -
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
-
Téléchargez le programme d'installation du package pour votre plate-forme depuis sam-cli-nightly
le aws-sam-cli GitHubréférentiel. -
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 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
-
Désinstallez la compilation nocturne de la CLI AWS SAM installée par Homebrew.
$
brew uninstall aws-sam-cli-nightly
-
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 -
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
-
À partir du répertoire de départ de votre choix, créez un environnement virtuel et nommez-le.
-
Activer l'environnement virtuel
-
Installez la CLI AWS SAM dans votre environnement virtuel.
(venv) $
pip install --upgrade aws-sam-cli
-
Vérifiez que la CLI AWS SAM est installée correctement.
(venv) $
sam --version
SAM CLI, version1.94.0
-
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
-
Exécutez les commandes suivantes :
$
brew install aws-sam-cli
-
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
-
Exécutez les commandes suivantes :
$
brew uninstall aws-sam-cli
-
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
-
Désinstallez la Homebrew version AWS gérée de AWS SAMCLI :
$
brew uninstall aws-sam-cli
-
Vérifiez que la CLI AWS SAM a été désinstallée :
$
which sam
sam not found -
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
-
Supprimez les fichiers mis en cache pour le programme d'installation AWS géré :
$
brew cleanup aws/tap
-
Mettre à jour Homebrew et toutes les formules :
$
brew update
-
Installez la version gérée par la communauté de AWS SAMCLI :
$
brew install aws-sam-cli
-
Vérifiez que la CLI AWS SAM est correctement installée :
$
sam --version
SAM CLI, version1.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.