Administración de versiones de la CLI de AWS SAM

Administre las versiones de la interfaz de línea de AWS Serverless Application Model comandos (AWS SAMCLI) mediante la actualización, la degradación y la desinstalación. Si lo desea, puede descargar e instalar la versión nocturna de la CLI de AWS SAM.

Actualización de la CLI de AWS SAM

Linux

Para actualizar la CLI de AWS SAM en Linux, siga las instrucciones de instalación en Instalación de la CLI de AWS SAM, pero añada la opción--update al comando install de la siguiente manera:

sudo ./sam-installation/install --update

macOS

AWS SAMCLIDebe actualizarse mediante el mismo método utilizado para instalarlo. Se recomienda utilizar el instalador del paquete para instalar y actualizar el AWS SAMCLI.

Para actualizar la CLI de AWS SAM mediante el instalador de paquetes, instale la última versión del paquete. Para ver instrucciones, consulte Instalación de la CLI de AWS SAM.

Windows

Para actualizarla AWS SAMCLI, repita de Instale la CLIAWS SAM nuevo los pasos de instalación de Windows.

Desinstalación de la CLI de AWS SAM

Linux

Para desinstalar la CLI de AWS SAM en Linux, debe eliminar el enlace simbólico y el directorio de instalación ejecutando los siguientes comandos:

1. Busque el enlace simbólico y las rutas de instalación.

   • Utilice el comando which para encontrar el enlace simbólico:

     which sam

     El resultado muestra la ruta en la que se encuentran AWS SAM los binarios, por ejemplo:

      /usr/local/bin/sam

   • Busque el directorio al que apunta el enlace simbólico mediante el comando ls:

     ls -l /usr/local/bin/sam

     En el siguiente ejemplo, el directorio de instalación es /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. Elimine el enlace simbólico.

   sudo rm /usr/local/bin/sam

3. Elimine el directorio de instalación.

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

macOS

Desinstale la CLI de AWS SAM con el mismo método que utilizó para instalarla. Le recomendamos que utilice el instalador del paquete para instalar el AWS SAMCLI.

Si instaló la CLI de AWS SAM mediante el instalador del paquete, siga estos pasos para desinstalarlo.

Para desinstalar la CLI de AWS SAM

1. Elimine la CLI de AWS SAM modificando y ejecutando lo siguiente:

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

   1. sudo: si su usuario tiene permisos de escritura en el lugar donde está instalada la CLI de AWS SAM, sudo no es obligatorio. De lo contrario, se requiere el sudo.

   2. /path-to: ruta al lugar donde instaló la CLI de AWS SAM. La ubicación predeterminada es /usr/local.

2. Elimine el AWS SAMCLI $PATH modificando y ejecutando lo siguiente:

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

   1. sudo: si su usuario tiene permisos de escritura para $PATH, sudo no es obligatorio. De lo contrario, se requiere el sudo.

   2. path-to-symlink-directory— Su variable de $PATH entorno. La ubicación predeterminada es /usr/local/bin.

3. Compruebe que la CLI de AWS SAM está desinstalada ejecutando lo siguiente:

   $ sam --version
   command not found: sam

Windows

Para desinstalar la CLI de AWS SAM mediante la configuración de Windows, siga estos pasos:

1. En el menú Inicio, busque “Agregar o quitar programas”.

2. Elija el resultado denominado AWS SAM Interfaz de línea de comandos de y, a continuación, seleccione Desinstalar para iniciar el desinstalador.

3. Confirme que desea desinstalar el AWS SAMCLI.

Cambie de usar Homebrew para administrar la CLI de AWS SAM

Si la utiliza Homebrew para instalar y actualizar AWS SAMCLI, le recomendamos que utilice un método AWS compatible. Siga estas instrucciones para cambiar a un método compatible.

Para dejar de usar Homebrew

1. Siga las instrucciones que aparecen en Desinstalar una CLI de Homebrew instalada con AWS SAM para desinstalar la versión Homebrew gestionada.

2. Siga las instrucciones que aparecen en Instale la CLIAWS SAM para instalar la CLI de AWS SAM mediante un método compatible.

Administrar la compilación nocturna de la CLI de AWS SAM

Puede descargar e instalar la compilación nocturna de la CLI de AWS SAM. Contiene una versión preliminar del código de la CLI de AWS SAM que puede ser menos estable que la versión de producción. Una vez instalada, puede usar la compilación nocturna con el comando sam-nightly. Puede instalar y usar la versión de producción y la versión de compilación nocturna de la CLI de AWS SAM al mismo tiempo.

nota

La compilación nocturna no contiene una versión preliminar de la imagen de compilación. Por eso, al crear una aplicación sin servidor con la opción --use-container, se utiliza la última versión de producción de la imagen de compilación.

Instalación de la compilación nocturna de la CLI de AWS SAM

Para instalar la compilación nocturna de la CLI de AWS SAM, siga estas instrucciones:

Linux

Puede instalar la versión de compilación nocturna de la CLI de AWS SAM en la plataforma Linux x86_64 mediante el instalador de paquetes.

Para instalar la compilación nocturna de la CLI de AWS SAM

1. Descargue el instalador del paquete desde sam-cli-nightlyel aws-sam-cli GitHubrepositorio.

2. Siga los pasos para instalar el paquete de compilación nocturna de la CLI de AWS SAM.

macOS

Puede instalar la versión de compilación nocturna de la CLI de AWS SAM en macOS mediante el instalador del paquete de compilación nocturna.

Para instalar la compilación nocturna de la CLI de AWS SAM

1. Descargue el instalador del paquete para su plataforma desde sam-cli-nightlyel aws-sam-cli GitHubrepositorio.

2. Siga los pasos para instalar el paquete de compilación nocturna de la CLI de AWS SAM.

Windows

La versión de compilación nocturna de la CLI de AWS SAM está disponible en este enlace de descarga: compilación nocturna de la CLI de AWS SAM. Para instalar la compilación nocturna en Windows, siga los mismos pasos que en Instale la CLIAWS SAM, pero utilice en su lugar el enlace de descarga de la compilación nocturna.

Para comprobar que ha instalado la versión de compilación nocturna, ejecute el comando sam-nightly --version. El resultado de este comando tiene el formato 1.X.Y.dev<YYYYMMDDHHmm>, por ejemplo:

SAM CLI, version 1.20.0.dev202103151200

Cambie del Homebrew al instalador del paquete

Si va a instalar Homebrew y actualizar la compilación nocturna de la CLI de AWS SAM y desea pasar a usar el instalador de paquetes, siga estos pasos.

Para cambiar del Homebrew al instalador de paquetes

1. Desinstale la Homebrew instalada de la CLI de AWS SAM.

   $ brew uninstall aws-sam-cli-nightly

2. Compruebe que la compilación nocturna de la CLI de AWS SAM esté desinstalada ejecutando lo siguiente:

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

3. Siga los pasos de la sección anterior para instalar la compilación nocturna CLI de AWS SAM.

Instalación de la CLI de AWS SAM en un entorno virtual mediante pip

Recomendamos utilizar el instalador de paquetes nativo para instalar el AWS SAMCLI. Si debe utilizar pip, le recomendamos que instale la CLI de AWS SAM en un entorno virtual. Esto garantiza un entorno de instalación limpio y un entorno aislado en caso de que se produzcan errores.

nota

A partir del 24 de octubre de 2023, AWS SAM CLI dejará de ofrecer soporte paraPython 3.7. Para obtener más información, consulte La CLI de AWS SAM deja de dar soporte para Python 3.7.

Para instalar la CLI de AWS SAM en un entorno virtual

1. Desde el directorio de inicio que elija, cree un entorno virtual y asígnele un nombre.

   Linux / macOS

   $ mkdir project
   $ cd project
   $ python3 -m venv venv

   Windows

   > mkdir project
   > cd project
   > py -3 -m venv venv

2. Active el entorno virtual.

   Linux / macOS

   $ . venv/bin/activate

   El símbolo del sistema cambia para mostrar que el entorno virtual está activo.

   (venv) $ 

   Windows

   > venv\Scripts\activate

   El símbolo del sistema cambia para mostrar que el entorno virtual está activo.

   (venv) > 

3. Instale la CLI de AWS SAM en el entorno virtual.

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

4. Compruebe que la CLI de AWS SAM esté instalada correctamente.

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

5. Puede utilizar el comando deactivate para salir del entorno virtual. Siempre que inicie una sesión nueva, debe activar el entorno de nuevo.

Administración de CLI de AWS SAM con la Homebrew

nota

A partir de septiembre de 2023, AWS dejará de mantener el Homebrew instalador AWS gestionado de AWS SAMCLI (aws/tap/aws-sam-cli). Para seguir utilizándolo Homebrew, puede utilizar el instalador gestionado por la comunidad (aws-sam-cli). A partir de septiembre de 2023, cualquier comando Homebrew al que haga referencia a aws-sam-cli se redirigirá a aws/tap/aws-sam-cli.

Le recomendamos que utilice nuestros métodos de instalación y actualización compatibles.

Instalación de la CLI de AWS SAM mediante Homebrew

nota

Estas instrucciones utilizan el AWS SAMCLI Homebrew instalador administrado por la comunidad. Para obtener más asistencia, consulte el repositorio homebrew-core.

Para instalar la CLI de AWS SAM

1. Ejecute lo siguiente:

   $ brew install aws-sam-cli

2. Verificar la instalación:

   $ sam --version

   Tras una instalación correcta del AWS SAMCLI, debería ver un resultado como el siguiente:

   SAM CLI, version 1.94.0

Actualización de la CLI de AWS SAM utilizando Homebrew

Para actualizar la CLI de AWS SAM con Homebrew, ejecute el siguiente comando:

$ brew upgrade aws-sam-cli

Desinstalar una CLI de Homebrew instalada con AWS SAM

Si la CLI de AWS SAM se instaló utilizando Homebrew, siga estos pasos para desinstalarla.

Para desinstalar la CLI de AWS SAM

1. Ejecute lo siguiente:

   $ brew uninstall aws-sam-cli

2. Compruebe que la CLI de AWS SAM está desinstalada ejecutando lo siguiente:

   $ sam --version
   command not found: sam

Cambiar al instalador Homebrew gestionado por la comunidad

Si utiliza el Homebrew instalador AWS gestionado (aws/tap/aws-sam-cli) y prefiere seguir utilizándoloHomebrew, le recomendamos que cambie al Homebrew instalador gestionado por la comunidad (aws-sam-cli).

Para cambiar a un único comando, ejecute lo siguiente:

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

Siga estas instrucciones para ejecutar cada comando de forma individual.

Para cambiar al instalador Homebrew gestionado por la comunidad

1. Desinstale la Homebrew versión AWS gestionada de AWS SAMCLI:

   $ brew uninstall aws-sam-cli

2. Compruebe que la CLI de AWS SAM se haya desinstalado:

   $ which sam
   sam not found

3. Quite el AWS SAMCLI grifo AWS gestionado:

   $ brew untap aws/tap

   Si recibe un error como el siguiente, añada la opción --force e inténtelo de nuevo.

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

4. Elimine los archivos en caché del instalador AWS gestionado:

   $ brew cleanup aws/tap

5. Actualización de Homebrew y todas las fórmulas:

   $ brew update

6. Instale la versión gestionada por la comunidad de AWS SAMCLI:

   $ brew install aws-sam-cli

7. Compruebe que la CLI de AWS SAM se ha realizado correctamente:

   $ sam --version
   SAM CLI, version 1.94.0

Resolución de problemas

Si encuentra errores al instalar o utilizar la AWS SAMCLI, consulteSolución de problemas para AWS SAM CLI.