Administración de versiones de AWS SAM CLI - AWS Serverless Application Model
Actualización de AWS SAM CLIDesinstalación de la AWS SAM CLICambiar de HomebrewAdministrar la compilación nocturna de la CLI de AWS SAMInstalación de la CLI de AWS SAM en un entorno virtual mediante pipAdministración de CLI de AWS SAM con la HomebrewResolución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administración de versiones de AWS SAM CLI

Administre las versiones de la interfaz de línea de comandos de AWS Serverless Application Model (AWS SAM CLI) mediante la actualización, el cambio a versiones anteriores y la desinstalación. Si lo deseas, puedes descargar e instalar la versión nocturna de AWS SAM CLI.

Actualización de AWS SAM CLI

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

sudo ./sam-installation/install --update

La AWS SAM CLI debes actualizarse mediante el mismo método utilizado para instalarlo. Se recomienda AWS SAM CLI utilizar el instalador del paquete para instalar y actualizar la  .

Para actualizar la AWS SAM CLI mediante el instalador de paquetes, instala la última versión del paquete. Para obtener instrucciones, consulta Instalación de la AWS SAM CLI.

Para actualizar la AWS SAM CLI repita de nuevo los pasos de instalación de Instala la AWS SAM CLI en Windows.

Desinstalación de la AWS SAM CLI

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

  1. Busca 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 los comandos AWS SAM, por ejemplo:

       /usr/local/bin/sam

    • Busca 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. Elimina el enlace simbólico.

    sudo rm /usr/local/bin/sam

  3. Elimina el directorio de instalación.

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

Desinstala la AWS SAM CLI con el mismo método que utilizó para instalarla. Se recomienda utilizar el instalador del paquete para instalar la AWS SAM CLI.

Si instalaste la AWS SAM CLI mediante el instalador del paquete, sigue estos pasos para desinstalarlo.

Para desinstalar la AWS SAM CLI

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

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

    1. sudo: si tu 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 instalaste la CLI de AWS SAM. La ubicación predeterminada es /usr/local.

  2. Elimina el AWS SAM CLI $PATH modificando y ejecutando lo siguiente: 

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

    1. sudo: si tu 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 entorno $PATH. La ubicación predeterminada es /usr/local/bin.

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

    $ sam --version
command not found: sam

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

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

  2. Elige el resultado denominado AWS SAMInterfaz de línea de comandos de y, a continuación, selecciona Desinstalar para iniciar el desinstalador.

  3. Confirma que deseas desinstalar la AWS SAM CLI.

Cambia de usar Homebrew para administrar la AWS SAM CLI

Si utilizas Homebrew para instalar y actualizar la AWS SAM CLI, le recomendamos que utiliza 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 Instala la AWS SAM CLI para instalar la CLI de AWS SAM mediante un método compatible.

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

Puedes descargar e instalar la compilación nocturna de la CLI de AWS SAM. Contienes una versión preliminar del código de la CLI de AWS SAM que puedes ser menos estable que la versión de producción. Una vez instalada, puedes usar la compilación nocturna con el comando sam-nightly. Puedes 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 contienes 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, sigue estas instrucciones:

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

Cómo instalar la compilación nocturna de AWS SAM CLI

  1. Descarga el instalador del paquete desde sam-cli-nightly en el repositorio aws-sam-cli de GitHub.

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

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

Cómo instalar la compilación nocturna de la AWS SAM CLI

  1. Descarga el instalador del paquete para su plataforma desde sam-cli-nightly en el repositorio aws-sam-cli de GitHub.

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

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, sigue los mismos pasos que en Instala la AWS SAM CLI, pero utiliza en su lugar el enlace de descarga de la compilación nocturna.

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

SAM CLI, version 1.20.0.dev202103151200

Cambia del Homebrew al instalador del paquete

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

Para cambiar del Homebrew al instalador de paquetes

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

    $ brew uninstall aws-sam-cli-nightly

  2. Comprueba 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 la CLI de AWS SAM. Si debes utilizar pip, le recomendamos que instala 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, la CLI de AWS SAM dejará de ofrecer soporte para Python 3.7. Para obtener más información, consulta 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 eliges, crea un entorno virtual y asígnale un nombre.

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

  2. Activa 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. Instala la CLI de AWS SAM en el entorno virtual.

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

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

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

  5. Puedes utilizar el comando deactivate para salir del entorno virtual. Siempre que inicies una sesión nueva, debes 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 instalador Homebrew gestionado por AWS para la CLI de AWS SAM (aws/tap/aws-sam-cli). Para seguir utilizándolo Homebrew, puedes 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.

Te recomendamos que utilices 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 instalador AWS SAM de la Homebrew de CLI gestionado por la comunidad. Para obtener más asistencia, consulta el repositorio homebrew-core.

Para instalar la CLI de AWS SAM

  1. Ejecuta lo siguiente:

    $ brew install aws-sam-cli

  2. Verificar la instalación:

    $ sam --version

    Tras una instalación correcta de la CLI de AWS SAM, deberías ver un resultado similar al 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, ejecuta 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, sigue estos pasos para desinstalarla.

Para desinstalar la AWS SAM CLI

  1. Ejecuta lo siguiente:

    $ brew uninstall aws-sam-cli

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

    $ sam --version
command not found: sam

Cambiar al instalador Homebrew gestionado por la comunidad

Si utilizaste el instalador Homebrew gestionado por AWS (aws/tap/aws-sam-cli) y prefieres seguir utilizando Homebrew, te recomendamos que cambies al instalador Homebrew gestionado por la comunidad (aws-sam-cli).

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

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

Sigue estas instrucciones para ejecutar cada comando de forma individual.

Para cambiar al instalador Homebrew gestionado por la comunidad

  1. Desinstala la versión Homebrew gestionada por AWS de la CLI de AWS SAM:

    $ brew uninstall aws-sam-cli

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

    $ which sam
sam not found

  3. Quite el grifo gestionado AWS de la CLI de AWS SAM:

    $ 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. Elimina 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. Instala la versión gestionada por la comunidad de la CLI de AWS SAM:

    $ brew install aws-sam-cli

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

    $ sam --version
SAM CLI, version 1.94.0

Resolución de problemas

Si encuentras errores al instalar o utilizar la CLI de AWS SAM, consulta Solución de problemas para AWS SAM CLI.