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 AWS Serverless Application Model comandos (AWS SAMCLI) mediante la actualización, la degradación 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

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 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 actualizarla AWS SAMCLI, repita de Instala la AWS SAM CLI nuevo los pasos de instalación de 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 AWS SAM los binarios, 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. Le recomendamos que utilice el instalador del paquete para instalar el AWS SAMCLI.

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 su usuario tiene permisos de escritura en el lugar donde está instalado el AWS SAMCLI programa, no sudo es obligatorio. De lo contrario, se requiere el sudo.

    2. /path-to— Ruta de acceso al lugar donde instaló el AWS SAMCLI programa. 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, no sudo es obligatorio. De lo contrario, se requiere el sudo.

    2. path-to-symlink-directory— Tu variable de $PATH entorno. 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 SAM Interfaz de línea de comandos de y, a continuación, selecciona Desinstalar para iniciar el desinstalador.

  3. Confirme que desea desinstalar el AWS SAMCLI.

Cambia de usar Homebrew para administrar la AWS SAM CLI

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 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. Descargue el instalador del paquete desde sam-cli-nightlyel aws-sam-cli GitHubrepositorio.

  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. Descargue el instalador del paquete para su plataforma desde sam-cli-nightlyel aws-sam-cli GitHubrepositorio.

  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 el AWS SAMCLI. 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, AWS SAM CLI dejará de ofrecer soporte paraPython 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 Homebrew instalador AWS gestionado de AWS SAMCLI (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

En estas instrucciones se utiliza el AWS SAMCLI Homebrew instalador 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 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, 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 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, 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. Desinstale la Homebrew versión AWS gestionada de AWS SAMCLI:

    $ brew uninstall aws-sam-cli

  2. Comprueba 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. Comprueba 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.