AWSToolkit for VS Code - Guía del usuario - Amazon
←
→
Transcripción del contenido de la página
Si su navegador no muestra la página correctamente, lea el contenido de la página a continuación
AWSToolkit for VS Code Guía del usuario AWSToolkit for VS Code: Guía del usuario Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Las marcas comerciales y la imagen comercial de Amazon no se pueden utilizar en relación con ningún producto o servicio que no sea de Amazon de ninguna manera que pueda causar confusión entre los clientes y que menosprecie o desacredite a Amazon. Todas las demás marcas comerciales que no son propiedad de Amazon son propiedad de sus respectivos propietarios, que pueden o no estar afiliados, conectados o patrocinados por Amazon.
AWSToolkit for VS Code Guía del usuario Table of Contents AWS Toolkit for Visual Studio Code ...................................................................................................... 1 ¿Qué es AWS Toolkit for Visual Studio Code? ................................................................................ 1 Información relacionada ............................................................................................................... 1 Configuración ..................................................................................................................................... 2 Instalación del Toolkit for VS Code ............................................................................................... 2 Prerequisites ...................................................................................................................... 2 Instalación del Toolkit for VS Code ....................................................................................... 3 Establecimiento de credenciales ................................................................................................... 4 Uso deAWScredenciales admitidas ....................................................................................... 4 Uso de un proceso de credenciales externo .......................................................................... 10 Conexión a AWS ...................................................................................................................... 10 Connect toAWSUso del Toolkit for VS Code ......................................................................... 10 Uso de variosAWSCuentas de con el Toolkit ........................................................................ 13 CHANDAWSRegiones de ........................................................................................................... 13 Agregue una región a laAWSExplorador de .......................................................................... 14 Ocultar una región en la listaAWSExplorador de .................................................................... 15 Configuración de su cadena de herramientas ................................................................................ 16 Configurar una cadena de herramientas para de.NET Core ..................................................... 16 Configurar una cadena de herramientas para Node.js ............................................................. 17 Configurar una cadena de herramientas para Python ............................................................. 17 Configurar una cadena de herramientas para Java ................................................................ 17 Configurar una cadena de herramientas para Go ................................................................... 17 Uso de su cadena de herramientas ..................................................................................... 18 Explorador del Toolkit for VS Code ..................................................................................................... 19 Componentes fundamentales de la interfaz de usuario ................................................................... 19 LaAWSExplorador de ........................................................................................................ 19 LaAWS CDKExplorador de ................................................................................................. 20 Ubicaciones de los comandos .................................................................................................... 20 Paleta de comandos de Visual Studio Code .......................................................................... 20 AWSExplorador deMenú .................................................................................................... 22 Trabajar con los servicios de AWS ...................................................................................................... 23 Características experimentales .................................................................................................... 23 AWSExplorador de .................................................................................................................... 23 Amazon API Gateway ....................................................................................................... 25 AWS App Runner ............................................................................................................. 25 Pilas de AWS CloudFormation ............................................................................................ 31 Amazon CloudWatch Logs ................................................................................................. 32 Amazon EventBridge ......................................................................................................... 34 Funciones AWS Lambda .................................................................................................... 37 Amazon S3 ...................................................................................................................... 43 AWS Systems Manager ..................................................................................................... 47 AWS Step Functions ......................................................................................................... 51 Recursos ......................................................................................................................... 58 Amazon ECS ........................................................................................................................... 61 Uso de IntelliSense para archivos de definición de tareas ....................................................... 62 AWS CDKExplorador de ............................................................................................................ 62 Aplicaciones de AWS CDK ................................................................................................. 63 AWS Serverless Application ....................................................................................................... 65 Supuestos y requisitos previos ............................................................................................ 65 Permisos de IAM para aplicaciones sin servidor .................................................................... 66 Creación de una nueva aplicación sin servidor (local) ............................................................. 66 Apertura de una aplicación sin servidor (local) ....................................................................... 67 Ejecución y depuración de una aplicación sin servidor desde una plantilla (local) ......................... 68 Implementar una aplicación sin servidor en elAWSCloud ......................................................... 69 iii
AWSToolkit for VS Code Guía del usuario Eliminación de una aplicación sin servidor de laAWSCloud ...................................................... 70 Ejecución y depuración de funciones Lambda directamente desde el código .............................. 71 Ejecución y depuración de recursos locales de Amazon API Gateway ....................................... 73 Opciones de configuración para depurar aplicaciones sin servidor ............................................ 75 Solución de problemas ...................................................................................................... 80 Seguridad ........................................................................................................................................ 83 Protección de datos .................................................................................................................. 83 Identity and Access Management ................................................................................................ 84 Registro y monitorización ........................................................................................................... 84 Validación de la conformidad ...................................................................................................... 85 Resiliencia ............................................................................................................................... 85 Seguridad de la infraestructura ................................................................................................... 86 Configuración y análisis de vulnerabilidades ................................................................................. 86 Historial de documentos ..................................................................................................................... 87 .................................................................................................................................................. lxxxix iv
AWSToolkit for VS Code Guía del usuario ¿Qué es AWS Toolkit for Visual Studio Code? AWS Toolkit for Visual Studio Code Esta es la guía del usuario paraAWSToolkit for VS Code. Si está buscando AWS Toolkit for Visual Studio, consulte la Guía del usuario de AWS Toolkit for Visual Studio. ¿Qué es AWS Toolkit for Visual Studio Code? El Toolkit for VS Code es una extensión de código abierto para el editor de Visual Studio Code (VS Code). Esta extensión facilita a los desarrolladores el desarrollo, la depuración local y la implementación de aplicaciones sin servidor que utilicen Amazon Web Services (AWS). Topics • Configuración del AWS Toolkit for Visual Studio Code (p. 2) • Navegación por el AWS Toolkit for Visual Studio Code (p. 19) • Trabajar con los servicios de AWS (p. 23) Información relacionada Consulte los siguientes recursos para obtener acceso al código fuente de este conjunto de herramientas o para ver los problemas abiertos en ese momento. • Código fuente • Identificador de problemas Para obtener más información acerca del editor de código de Visual Studio, visitehttps:// code.visualstudio.com/.. 1
AWSToolkit for VS Code Guía del usuario Instalación del Toolkit for VS Code Configuración del AWS Toolkit for Visual Studio Code Esta sección te ayuda a configurar el AWS Toolkit for Visual Studio Code. Proporciona información sobre cómo instalar y configurar el kit de herramientas, configurar tus credenciales y conectarte aAWS. Temas • Instalación de AWS Toolkit for Visual Studio Code (p. 2) • Establecimiento de credenciales para elAWS Toolkit for Visual Studio Code (p. 4) • Conexión a AWS través del AWS Toolkit for Visual Studio Code (p. 10) • CHANDAWSRegiones de (p. 13) • Configuración de su cadena de herramientas (p. 16) Instalación de AWS Toolkit for Visual Studio Code En esta sección se describe cómo instalar el AWS Toolkit for Visual Studio Code. Prerequisites Required Para poder instalar Toolkit for VS Code, debe contar con lo siguiente: • Una cuenta de Amazon Web ServicesPara obtener unAWSAcceda aAWSPágina de inicio de. SeleccionarCreación de unAWSCuenta, o bienInscripciones(si ya ha visitado el sitio anteriormente). Registrarse le permite usar todos los servicios ofrecidos por AWS. • Un sistema operativo compatible— El Toolkit for VS Code es compatible con Windows, Linux y macOS. • VS Code versión 1.42.0 o posterior— Intentamos mantener el Toolkit for VS Code actualizado con la versión predeterminada disponible enPágina de descarga VS Code. Optional Para poder utilizar algunas características del Toolkit for VS Code, debe contar con lo siguiente: • Desarrollo de código: SDK pertinente para el lenguaje que desea usar. Puede realizar la descarga en los siguientes enlaces o usar su administrador de paquetes favorito: • SDK para .NET: https://dotnet.microsoft.com/download • SDK para Node.js: https://nodejs.org/en/download • SDK para Python: https://www.python.org/downloads • SDK de Java:http://aws.amazon.com/corretto/ • SDK de Go:https://golang.org/doc/install • AWS SAMCLI— Este es unAWSHerramienta de la CLI de que facilita el desarrollo, las pruebas y el análisis locales de las aplicaciones sin servidor. Esto no es necesario para instalar el conjunto de herramientas. Sin embargo, le recomendamos que lo instale (así como Docker, que se describe a continuación) porque es necesario para cualquier funcionalidad de AWS Serverless Application Model (AWS SAM), como Creación de una nueva aplicación sin servidor (local) (p. 66). 2
AWSToolkit for VS Code Guía del usuario Instalación del Toolkit for VS Code Para obtener más información, consulte el artículo sobre instalación de la CLI de AWS SAM en la guía para desarrolladores de AWS Serverless Application Model. • Docker— ElAWS SAMLa CLI de requiere esta plataforma de contenedores de software de código abierto. Para obtener más información e instrucciones e descarga, consulte Docker. • Administrador de paquetes— Un gestor de paquetes para que pueda descargar y compartir el código de la aplicación. • .NET: NuGet • Node.js:npm • Python:pip • Java: GradleorMaven Instalación del Toolkit for VS Code 1. Inicie el editor de código VS. 2. En el navegadorBarra de actividadesEn el lado del editor de VS Code (Code), elija la opciónExtensionesIcono . Se abrirá el cuadroExtensiones, que permite acceder a VS Code Marketplace. 3. En el cuadro de búsqueda de Extensions (Extensiones), busque AWS Toolkit. Elija la entrada para ver la información detallada en el panel derecho. 4. En el panel derecho, elija Install (Instalar). 5. Una vez instalado, si se le pide que reinicie el editor, elija Reload Required (Volver a cargar obligatoriamente) para finalizar la instalación. Después de instalar el Toolkit for VS Code, debe configurar sucredenciales (p. 4)para permitirle acceder a suAWSdesde dentro de VS Code. 3
AWSToolkit for VS Code Guía del usuario Establecimiento de credenciales Establecimiento de credenciales para elAWS Toolkit for Visual Studio Code En esta sección se muestran los tipos de credenciales que puede utilizar con elAWSToolkit for VS Code. Ofrece información acerca de cómo obtener y configurar esas credenciales. Puede obtener credenciales a través deAWSy proporcionarlos al kit de herramientas mediante archivos de configuración. También puede obtener credenciales a través de un proceso de credenciales externo que no es compatible directamente conAWS. Temas • Uso deAWScredenciales admitidas (p. 4) • Uso de un proceso de credenciales externo (p. 10) Uso deAWScredenciales admitidas AWSse pueden proporcionar a laAWSToolkit for VS Code mediante el uso de suCompartidoAWSarchivo configo suCompartidoAWSarchivo de credenciales. Los métodos para utilizar estos archivos son los mismos que los de laAWS CLI. Para obtener información general acerca de cómo utilizar estos archivos, consulteArchivos de configuración y credencialesen laAWS Command Line InterfaceGuía del usuario de. Temas • ObtenciónAWSclaves de acceso (p. 4) • Configurar suAWScredenciales (p. 5) • Uso de credenciales de AWS SSO (p. 8) ObtenciónAWSclaves de acceso Para acceder a Amazon Web Services (AWS) con elAWS Toolkit for Visual Studio Code, debe configurar el conjunto de herramientas conAWSCredenciales de cuenta de Para hacerlo con unas credenciales soportadas por AWS, antes debe obtener las claves de acceso de AWS adecuadas. Para obtener más información acerca de los usuarios y de las credenciales, que queda fuera del alcance de esta guía, consulte los siguientes recursos: • AWSCredenciales de seguridad deen laReferencia general de Amazon Web Services • Introducción a la administración de identidades: Usuarios deen laIAM User Guide ¿Qué son losAWSclaves de acceso Las claves de acceso son las credenciales que le identifican en AWS y le permiten acceder programáticamente a los servicios y recursos de AWS. Las claves de acceso se pueden asociar a suAWSLa cuenta de (el «usuario raíz» de la cuenta de o con los usuarios que cree conAWS Identity and Access Management(IAM). Warning Como el usuario raíz es básicamente un administrador con acceso total a los servicios y recursos, le recomendamos crear primero un usuario de IAM con sólo los permisos requeridos para realizar 4
AWSToolkit for VS Code Guía del usuario Uso deAWScredenciales admitidas las tareas necesarias. A continuación, para sus credenciales, puede utilizar una clave de acceso que esté asociada con ese usuario. Para obtener más información, consulte .Crear un usuario de IAM en suAWSCuentaen laIAM User Guide. Una clave de acceso se compone de un ID de clave de acceso, que es análogo a un nombre de usuario, y una clave de acceso secreta, que es análoga a una contraseña. Esta clave de acceso se usa para firmar programáticamente las solicitudes que haga a AWS. Si no tiene claves de acceso, puede crearlas utilizando la AWS Management Console. Le recomendamos utilizar claves de acceso para un usuario de IAM en lugar de las claves de su usuario raíz de la cuenta de. Note Para crear claves de acceso, debe tener permisos para realizar las acciones de IAM requeridas. Para obtener más información, consulteConceder permisos de usuario de IAM para administrar la política de contraseñas y las credencialesen laIAM User Guide. Obtenga suAWSclaves de acceso 1. Abra la consola de IAM en https://console.aws.amazon.com/iam/. 2. En el menú de navegación, elija Users (Usuarios). 3. Seleccione su nombre de usuario de IAM (no la casilla de verificación) para ver los detalles. 4. En la pestaña Security credentials (Credenciales de seguridad), elija Create access key (Crear clave de acceso). 5. Para ver la nueva clave de acceso, elija Show (Mostrar). Las credenciales serán similares a las siguientes: • ID de clave de acceso: AKIAIOSFODNN7EXAMPLE • Clave de acceso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY 6. Para descargar el par de claves, elija Download .csv file (Descargar archivo .csv). Almacene las claves en un lugar seguro. Important • Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca por correo electrónico. No las comparta fuera de su organización, aunque reciba una petición que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a Amazon le pedirá nunca su clave secreta. • Si pierde la clave secreta, no podrá recuperarla. En su lugar, por motivos de seguridad, debe crear un nuevo par de claves y eliminar el anterior. Una vez que haya obtenido suAWS, puede usar las claves de accesoAWSToolkit for VS Code de para almacenarlos en suAWSo su archivo de configuración compartidoAWSarchivo de credenciales. Para saber cómo hacerlo, consulte Adición de suAWSclaves de acceso a su entorno (p. 6). Configurar suAWScredenciales Para acceder a Amazon Web Services (AWS) con elAWS Toolkit for Visual Studio Code, debe hacer que suAWSdisponibles para el kit de herramientas. Para utilizar las credenciales soportadas por AWS, siga leyendo este tema. Para utilizar un proceso de credenciales externas, consulte Uso de un proceso de credenciales externo (p. 10). Note Algunas características del Toolkit for VS Code, como la creación de una aplicación sin servidor, no requierenAWSCredenciales de . 5
AWSToolkit for VS Code Guía del usuario Uso deAWScredenciales admitidas Obtenga suAWSclaves de acceso Si aún no tiene claves de acceso de AWS adecuadas para guardarlas en su archivo de configuración compartido de AWS o en su archivo de credenciales compartido de AWS, debe obtenerlas ahora. Para ello, consulte ObtenciónAWSclaves de acceso (p. 4). Acerca de los compartidosAWSfiles El archivo de configuración compartido de AWS y el archivo de credenciales compartido de AWS se pueden utilizar para almacenar la información de configuración y credenciales para AWS. De forma predeterminada, estos archivos se encuentran en el directorio .aws dentro de su directorio principal y sus nombres son config y credentials, respectivamente. Para obtener más información, consulte¿Dónde se almacenan las opciones de configuración?en laAWS Command Line InterfaceGuía del usuario de. El Toolkit for VS Code localiza y usaAWSclaves de acceso a través de suAWSy su archivo de configuración compartidoAWSarchivo de credenciales. Este es el método que se utiliza en la AWS CLI y los AWS SDK. Las claves de acceso que se especifican en el Toolkit for VS Code se guardan en uno de estos archivos. Estos archivos compartidos pueden contener las credenciales de más de una cuenta de AWS, almacenadas como perfiles. Puede ser útil tener varias cuentas para proporcionar a los desarrolladores y los administradores recursos independientes para el desarrollo y para el lanzamiento y la publicación, por ejemplo. Adición de suAWSclaves de acceso a su entorno Si ya ha configurado suAWS(por ejemplo, mediante el uso de la herramientaAWS CLI), el Toolkit for VS Code detectará automáticamente esas credenciales y las pondrá a disposición del conjunto de herramientas. Si aún no ha configurado suAWS, o si desea incluirAWSPuede hacerlo a través del Toolkit for VS Code, como se muestra aquí. Note Como alternativa a estos procedimientos, puede utilizar el comando aws configure de la AWS CLI para añadir unas credenciales de AWS al entorno. También puede utilizaraws configurePara establecer el valor predeterminadoAWSRegión, que es necesaria para ciertas operaciones como crear una aplicación sin servidor. Crear el archivo compartidoAWSarchivo de credenciales • Si ya tiene un archivo de credenciales compartido de AWS, puede ir directamente al siguiente procedimiento (p. 7). • Si ya tiene unAWS Configurary desea utilizarlo, puede ir directamente a lasiguiente procedimiento (p. 7). • Si solo tienes unAWS Configurarpero no desea utilizarlo, primero debe crear unaAWSmediante técnicas que son normales para el sistema operativo. A continuación, puede pasar al siguiente procedimiento (p. 7). Siga estos pasos para crear el archivo de credenciales compartido de AWS. 1. Abra el código VS. 2. Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso directo: 6
AWSToolkit for VS Code Guía del usuario Uso deAWScredenciales admitidas • Pulse Windows y Linux: pulseCtrl+Mayús+P. • macOS: PulseMayús+Comando+P. 3. SearchAWSy elijaAWS: Crear perfil de credenciales. 4. Especifique un nombre para el perfil inicial. 5. Escriba el ID de clave de acceso para las credenciales. Si no tiene un ID de clave de acceso, consulte ObtenciónAWSclaves de acceso (p. 4). 6. Especifique la clave de acceso secreta para las credenciales. Si no tiene una clave de acceso secreta, consulte ObtenciónAWSclaves de acceso (p. 4). Después de completar este procedimiento, puede comprobar el archivo de credenciales compartido de AWS; para ello, ábralo directamente o lleve a cabo los tres primeros pasos del siguiente procedimiento (sin hacer ninguna actualización). Actualizar uno de sus archivos compartidos Siga estos pasos para añadir un nuevo perfil a un archivo de configuración compartido de AWS o a un archivo de credenciales compartido de AWS. También puede actualizar un perfil existente. 1. Abrir código VS. 2. Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso directo: • Pulse Windows y Linux: pulseCtrl+Mayús+P. • macOS: PulseMayús+Comando+P. 3. SearchAWSy elijaAWS: Crear perfil de credenciales. 7
AWSToolkit for VS Code Guía del usuario Uso deAWScredenciales admitidas 4. Cuando uno o ambos archivos compartidos se abra en el editor de VS Code, agregue o actualice un perfil. 5. Cuando haya terminado de actualizar el archivo, guárdelo. Agregar perfiles de credenciales adicionales Puede añadir perfiles y credenciales adicionales. Para ello, abra el cuadro de diálogoPaleta de comandos dely elijaAWS: Crear perfil de credenciales. Esto abrirá el archivo de credenciales En esta página, puede agregar un nuevo perfil debajo de su primer perfil, como en el siguiente ejemplo: # Amazon Web Services Credentials File used by AWS CLI, SDKs, and tools # This file was created by the AWS Toolkit for Visual Studio Code extension. # # Your AWS credentials are represented by access keys associated with IAM users. # For information about how to create and manage AWS access keys for a user, see: # https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html # # This credential file can store multiple access keys by placing each one in a # named "profile". For information about how to change the access keys in a # profile or to add a new profile with a different access key, see: # https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html # [Profile1_Name] # The access key and secret key pair identify your account and grant access to AWS. aws_access_key_id = AKIAIOSFODNN7EXAMPLE # Treat your secret key like a password. Never share your secret key with anyone. Do # not post it in online forums, or store it in a source control system. If your secret # key is ever disclosed, immediately use IAM to delete the access key and secret key # and create a new key pair. Then, update this file with the replacement key details. aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY [Profile2_Name] aws_access_key_id = AKIAI44QH8DHBEXAMPLE aws_secret_access_key = je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY Uso de credenciales de AWS SSO Para conectar conAWS Single Sign-On(AWS SSO), debe cumplir los siguientes requisitos previos: 1. HabilitarAWS SSO— Esto incluye elegir el origen de su identidad y configurarAWS SSOAcceso a laAWScuentas. Para obtener más información, consulteIntroducciónen laAWS Single Sign-OnGuía del usuario de. 2. Adición de unAWS SSOPerfil de— ConAWS SSO, defina un perfil con nombre en el archivo de credenciales o la configuración que utiliza para recuperar credenciales temporales para suAWSaccount. 8
AWSToolkit for VS Code Guía del usuario Uso deAWScredenciales admitidas La definición de perfil especifica la propiedadAWS SSO portal de usuariosasí como elAWSLa cuenta y el rol de IAM asociado al usuario que solicita acceso. Para agregarAWS SSOPerfil de El siguiente procedimiento muestra cómo añadir unaAWS SSOa su perfilcredentialsorconfigfile. Agregar unAWS SSOa su archivo de credenciales en VS Code 1. Abra el código VS. 2. Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso directo: • Pulse Windows y Linux: pulseCtrl+Mayús+P. • macOS: PulseMayús+Comando+P. 3. SearchAWSy elijaAWS: Crear perfil de credenciales. Esto abrirá el archivo de credenciales 4. En elcredentialsorconfigarchivo, en[default], agregue una plantilla para unAWS SSOPerfil de. A continuación se muestra un perfil de ejemplo: ... Named profile in credentials file ... [profile sso-user-1] sso_start_url = https://example.com/start sso_region = us-east-2 sso_account_id = 123456789011 sso_role_name = readOnly region = us-west-2 Important No utilice la palabraPerfil deCuando cree una entrada en el archivo de credenciales Esto se debe a que el archivo de credenciales usa un formato de denominación diferente que el archivo de configuración. Incluir la palabra de prefijoprofileSolo cuando configure un perfil con nombre en el archivo de configuración. Cuando asigne valores para su perfil, tenga en cuenta lo siguiente: • sso_start_url: la URL que apunta a laAWS SSOportal de usuarios • sso_region— ElAWSRegión que contiene suAWS SSOhost de portal Esto puede ser diferente de laAWSRegión especificada más adelante en el valor predeterminadoregionParámetro de. • sso_account_id— ElAWSEl ID de la cuenta de que contiene el rol de IAM con el permiso que desea conceder a esteAWS SSOusuario. • sso_role_name— El nombre del rol de IAM que define los permisos que tiene el usuario cuando utiliza este perfil para obtener credenciales a través deAWS SSO. • region— El valor predeterminadoAWSRegión que estaAWS SSOel usuario iniciará sesión. Inicie sesión conAWS SSO Al iniciar sesión con unAWS SSO, el navegador predeterminado se inicia en el portal especificado. Debe verificar suAWS SSOantes de que pueda acceder a suAWSrecursos en VS Code. Tenga en cuenta que si sus credenciales caducan, tendrá que repetir el proceso de conexión para obtener nuevas credenciales temporales. 9
AWSToolkit for VS Code Guía del usuario Uso de un proceso de credenciales externo Uso de un proceso de credenciales externo Si tiene un proceso para generar o buscar credenciales que no es directamente compatible con laAWS, puede configurar elAWSToolkit for VS Code de use ese proceso en lugar de cualquieralmacenadoAWScredenciales (p. 4). El método para especificar un proceso de credenciales externo es el mismo que para elAWS CLI, y consiste en agregar uncredential_processdefinición a suCompartidoAWSarchivo config. Para obtener información detallada acerca de cómo hacerlo, consulteObtención de credenciales con un proceso externoen laAWS Command Line InterfaceGuía del usuario de. Conexión a AWS través del AWS Toolkit for Visual Studio Code Para interactuar con Amazon Web Services (AWS) a través delAWS Toolkit for Visual Studio CodeDebe establecer una conexión conAWS. Connect toAWSUso del Toolkit for VS Code 1. Abra el código VS. 2. Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso directo: • Pulse Windows y Linux:Ctrl+Mayús+P. • macOS: PulseMayús+Comando+P. 3. Search forAWSy elijaAWS: Connect toAWS. 4. Elija un perfil de la lista. Si no tiene configurado un perfil de credenciales, se le pedirá que configure uno. Busque una ventana emergente en la esquina inferior derecha del editor. Elija Yes (Sí) y, a continuación, siga el asistente 10
AWSToolkit for VS Code Guía del usuario Connect toAWSUso del Toolkit for VS Code de configuración para introducir un nombre de perfil, el ID de clave de acceso y la clave de acceso secreta. Para obtener información, consulte Configurar suAWScredenciales (p. 5). Note Si desea proporcionar un proceso de credenciales externas en lugar de utilizar credenciales soportadas por AWS, elija No (No) y consulte Uso de un proceso de credenciales externo (p. 10) en su lugar. 5. Abra el iconoAWS: Explorador deBarra lateral, que llamamosAWSExplorador dePara comprobar la conexión. Verá una lista deAWSRegiones (si tieneha hecho visible cualquier Regiones (p. 14)en laAWSExplorador de) o un mensaje para agregar Regiones a laAWSExplorador de. Antesagregar Regiones (p. 13)a laAWSExplorador deVerá lo siguiente. 11
AWSToolkit for VS Code Guía del usuario Connect toAWSUso del Toolkit for VS Code Después de agregar Regiones a laAWSExplorador deVerá algo parecido a lo siguiente. 12
AWSToolkit for VS Code Guía del usuario Uso de variosAWSCuentas de con el Toolkit Uso de variosAWSCuentas de con el Toolkit Es posible que tenga variosAWSCuentas de a las que desee acceder desde el Toolkit for VS Code. Puede ser útil tener varias cuentas para proporcionar a los desarrolladores y los administradores recursos independientes para el desarrollo y para el lanzamiento y la publicación, por ejemplo. Los conjuntos de credenciales de AWS se almacenan como perfiles en el archivo de configuración de AWS o en el archivo de credenciales compartidas de AWS. Para elegir otro conjunto de credenciales, siga los pasos del procedimiento anterior y elija un perfil diferente. CHANDAWSRegiones de Al configurar sus credenciales, el iconoAWS Toolkit for Visual Studio Codeselecciona y muestra automáticamente el valor predeterminadoAWSRegión para esas credenciales en elAWSExplorador de. En este tema se describe cómo cambiar la lista de Regiones que se muestra en elAWSExplorador de. 13
AWSToolkit for VS Code Guía del usuario Agregue una región a laAWSExplorador de Agregue una región a laAWSExplorador de 1. Para abrir la Command Palette (Paleta de comandos), vaya a la barra de menús, elija View (Ver) y seleccione Command Palette (Paleta de comandos). O bien utilice las siguientes teclas de acceso directo: • Para Windows y Linux: PulseCtrl+Mayús+P. • macOS: PulseMayús+Comando+P. 2. Search forAWSy elijaAWS: Mostrar región en el Explorador. 3. Elija la región que desea añadir aAWSExplorador de. Note La lista contiene sólo las regiones que están disponibles para agregar a la listaAWSExplorador de. Las regiones que ya ha agregado no aparecen en la lista. 4. Compruebe que la región aparece ahora enAWSExplorador de. 14
AWSToolkit for VS Code Guía del usuario Ocultar una región en la listaAWSExplorador de Ocultar una región en la listaAWSExplorador de 1. Elija el iconoAWSen el iconoBarra de actividadespara abrirAWSExplorador de. 2. Elija una de las regiones de la lista y abra su menú contextual. 15
AWSToolkit for VS Code Guía del usuario Configuración de su cadena de herramientas 3. SeleccionarHide Region from the Explorer. Configuración de su cadena de herramientas LaAWS Toolkit for Visual Studio Codeadmite varios idiomas que puede usar para interactuar conAWS. En este tema describe cómo configurar la cadena de herramientas para cada uno de estos idiomas. Configurar una cadena de herramientas para de.NET Core 1. Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3). 2. Instalación delextensión C #. Esta extensión permite que VS Code depure las aplicaciones .NET Core. 3. Abra unAWS Serverless Application Model(AWS SAM), ocrear uno (p. 66). 4. Abra la carpeta que contienetemplate.yaml. 16
AWSToolkit for VS Code Guía del usuario Configurar una cadena de herramientas para Node.js Configurar una cadena de herramientas para Node.js Al depurar un fuction TypeScript Lambda directamente desde el código fuente (la configuración de lanzamiento»target«:»code«), el compilador TypeScript debe instalarse globalmente. Para obtener más información acerca de la instalación de esta, consulteTypeScripten https://www.npmjs.com/. 1. Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3). 2. Abra unAWS SAMaplicación, ocrear uno (p. 66). 3. Abra la carpeta que contienetemplate.yaml. Configurar una cadena de herramientas para Python 1. Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3). 2. Instalación delExtensión de Python para Visual Studio Code. Esta extensión permite VS Code depurar aplicaciones Python. 3. Abra unAWS SAMaplicación, ocrear uno (p. 66). 4. Abra la carpeta que contienetemplate.yaml. 5. Abra un terminal en la raíz de su aplicación y configurevirtualenvEjecutándosepython -m venv ./.venv. Note Solo tiene que configurarvirtualenvuna vez por sistema. 6. ActivatevirtualenvEjecute una de las siguientes acciones: • Bash shell:./.venv/Scripts/activate • PowerShell:./.venv/Scripts/Activate.ps1 Configurar una cadena de herramientas para Java 1. Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3). 2. Instalación delExtensión Java y Java 11. Esta extensión permite que VS Code reconozca funciones Java. 3. Instalación delextensión del depurador Java. Esta extensión permite a VS Code depurar aplicaciones Java. 4. Abra unAWS SAMaplicación, ocrear uno (p. 66). 5. Abra la carpeta que contienetemplate.yaml. Configurar una cadena de herramientas para Go 1. Asegúrese de que dispone de laAWSToolkit for VS CodeInstalado (p. 3). 2. Go 1.14 o superior es necesario para depurar las funciones Go Lambda. 3. Instalación delGo extensión. Note Se requiere la versión 0.25.0 o superior para depurar los tiempos de ejecución de Go1.15+. 4. Instale las herramientas Go mediante elPaleta de comandos: a. En la paleta de comandos, elijaGo: Install/Update Tools. 17
AWSToolkit for VS Code Guía del usuario Uso de su cadena de herramientas b. En el conjunto de casillas de verificación, seleccionedlvygopls. 5. Abra unAWS SAMaplicación, ocrear uno (p. 66). 6. Abra la carpeta que contienetemplate.yaml. Uso de su cadena de herramientas Una vez que haya configurado su cadena de herramientas, puede usarlo paraEjecutar o depurar (p. 68)elAWS SAMrevisiones de. 18
AWSToolkit for VS Code Guía del usuario Componentes fundamentales de la interfaz de usuario Navegación por el AWS Toolkit for Visual Studio Code En este tema se describe cómo navegar por el AWS Toolkit for Visual Studio Code. Asegúrese de instalar el conjunto de herramientas (p. 2) antes de leer este tema. Para obtener información general acerca de la interfaz de usuario (UI) de Visual Studio Code, consulte laDocumentación de IUPara VS Code. Componentes fundamentales de la interfaz de usuario Los siguientes son los componentes básicos de la interfaz de usuario delAWSToolkit for VS Code. LaAWSExplorador de • La imagen siguiente muestra los componentes básicos de la interfaz de usuario delAWSExplorador de. Consulte Uso deAWSServicios deAWSExplorador de (p. 23) para obtener más información sobre lo que puede hacer con él. LaAWSExplorador dese conoce más formalmente como elAWS: Explorador de la barra lateral. 19
AWSToolkit for VS Code Guía del usuario LaAWS CDKExplorador de LaAWS CDKExplorador de • La imagen siguiente muestra los componentes básicos de la interfaz de usuario delAWS CDKExplorador de. Consulte Uso delAWS CDKExplorador de (p. 62) para obtener más información sobre lo que puede hacer con él. Esta es una documentación preliminar para una característica en versión de vista previa. Está sujeta a cambios. Ubicaciones de los comandos Encontrará los comandos del Toolkit for VS Code (Code) en varias ubicaciones. Paleta de comandos de Visual Studio Code La paleta de comandos de VS Code (Code) contiene todos los comandos que puede utilizar para trabajar conAWSServicios de . Para ver estos comandos, abra la paleta de comandos de VS Code (Code) en laVistaMenú de. O bien utilice los siguientes accesos directos: • Windows y Linux: pulseCtrl+Mayús+P. • macOS: pulseMayús+Comando+P. 20
AWSToolkit for VS Code Guía del usuario Paleta de comandos de Visual Studio Code A continuación, puede filtrar por»AWS«. 21
AWSToolkit for VS Code Guía del usuario AWSExplorador deMenú AWSExplorador deMenú LaAWSExplorador detiene unaMás accionesMenú que contiene los comandos que se usan más habitualmente para trabajar conAWSServicios de . 22
AWSToolkit for VS Code Guía del usuario Características experimentales Trabajar con los servicios de AWS El AWS Toolkit for Visual Studio Code le permite ver y trabajar con varios servicios de AWS. Supone que ya hainstalado y configurado (p. 2)el Toolkit for VS Code de su sistema. Temas • Uso de características experimentales (p. 23) • Uso deAWSServicios deAWSExplorador de (p. 23) • Trabajar con Amazon Elastic Container Service (p. 61) • Uso delAWS CDKExplorador de (p. 62) • Trabajo con aplicaciones sin servidor (p. 65) Uso de características experimentales Las funciones experimentales ofrecen acceso anticipado a las funciones delAWS Toolkit for Visual Studio Codeantes de ser liberados oficialmente. Warning Dado que las características experimentales se siguen probando y actualizando, pueden tener problemas de usabilidad. Además, las características experimentales pueden eliminarse delAWS Toolkit for Visual Studio Codesin previo aviso. Puede habilitar las funciones experimentales para específicasAWSservicios en elAWSConjunto de herramientasSección sobre de laConfiguraciónen el IDE de código VS. 1. Para editarAWSconfiguración en VS Code, elijaArchivo,Preferencias,Configuración. 2. En el navegadorConfiguraciónpanel, expandirExtensionesy eligeAWSConjunto de herramientas. 3. BajoAWS: Experiments, seleccione las casillas de verificación de las funciones experimentales a las que desea acceder antes de su lanzamiento. Si desea desactivar una función experimental, desactive la casilla de verificación correspondiente. Uso deAWSServicios deAWSExplorador de LaAWSExplorador deOfrece una vista de algunas de lasAWSservicios con los que puede trabajar al utilizar elAWS Toolkit for Visual Studio Code. Vea una perspectiva general de laAWSExplorador deen lanavegación (p. 19)tema. En esta sección se ofrece información sobre cómo obtener acceso a laAWSExplorador deen VS Code. Supone que ya hainstalado y configurado (p. 2)el Toolkit for VS Code de su sistema. Algunos puntos importantes: • Si el conjunto de herramientas está instalado y configurado correctamente, debería ver elementos en laAWSExplorador de. Para ver lasAWSExplorador de, elige elAWSen elBarra de actividades. 23
AWSToolkit for VS Code Guía del usuario AWSExplorador de Por ejemplo: • Para algunas características, se requieren permisos de AWS específicos. Por ejemplo, para ver elAWS Lambdafunciones deAWScuenta, las credenciales que configuró enEstablecimiento de credenciales (p. 4)debe incluir al menos permisos Lambda de solo lectura. Consulte los temas siguientes para obtener más información acerca de los permisos que necesita cada característica. • Si quieres interactuar conAWSservicios que no son visibles inmediatamente en elAWSExplorador de, puedes ir aMás recursosy elige entre cientos de recursos que se pueden agregar a la interfaz. Por ejemplo, puede elegirAWS::CodeArtifact::Repositoryde la selección de los tipos de recursos disponibles. Después de agregar este tipo de recurso aMás recursos, puede ampliar la entrada para ver una lista de recursos que crean diferentes repositorios CodeArtifact con sus propias propiedades y atributos. Además, puede describir las propiedades y atributos de los recursos de las plantillas con formato JSON, que se pueden guardar para crear nuevos recursos en elAWSCloud. Temas • Uso de Amazon API Gateway (p. 25) • Uso de AWS App Runner con AWS Toolkit for Visual Studio Code (p. 25) • Uso de pilas de AWS CloudFormation (p. 31) • Trabajo con CloudWatch Logs mediante elAWS Toolkit for Visual Studio Code (p. 32) • Trabajo con Amazon EventBridge (p. 34) • Trabajo con funciones de AWS Lambda (p. 37) • Trabajo con Amazon S3 (p. 43) • Trabajo con documentos de Systems Manager Automation (p. 47) • Uso de AWS Step Functions (p. 51) 24
AWSToolkit for VS Code Guía del usuario Amazon API Gateway • Usar recursos de (p. 58) Uso de Amazon API Gateway Puede explorar y ejecutar recursos remotos de API Gateway en su conexiónAWScuenta utilizando elAWS Toolkit for Visual Studio Code. Note Esta característica no admite la depuración. Para explorar y ejecutar recursos remotos de API Gateway 1. En el navegadorAWSExplorador de, eligeAPI Gatewaypara ampliar el menú. Se enumeran los recursos de API Gateway remota. 2. Busque el recurso de API Gateway que desee invocar, abra su menú contextual (haga clic con el botón derecho) y, a continuación, elijaCómo invocar elAWS. 3. En el formulario de parámetros, especifique los parámetros de invocación. 4. Para ejecutar el recurso API Gateway remoto, elijaInvocación. Los resultados se muestran en la opciónSalida de código VSvista. Uso de AWS App Runner con AWS Toolkit for Visual Studio Code AWS App Runnerproporciona una forma rápida, sencilla y rentable de implementar desde el código fuente o una imagen de contenedor directamente en una aplicación web escalable y segura en elAWSCloud. Con él, no es necesario aprender nuevas tecnologías, decidir qué servicio informático utilizar o saber cómo aprovisionar y configurarAWSde AWS. Puede usarAWS App Runnercrear y administrar servicios basados en unimagen de origenorCódigo fuente de .. Si usas una imagen de origen, puedes elegir una imagen de contenedor pública o privada que se almacena en un repositorio de imágenes. App Runner admite los siguientes proveedores de repositorios de imágenes: • Amazon Elastic Container Registry (Amazon ECR): Almacena imágenes privadas en su cuenta de AWS. • Amazon Elastic Container Registry Público (Amazon ECR Público): Almacena imágenes legibles públicamente. Si elige la opción de código fuente, puede desplegarla desde un repositorio de código fuente mantenido por un proveedor de repositorios compatible. Actualmente, App Runner admiteGitHubcomo proveedor de repositorio de código fuente. Prerequisites Para interactuar con App Runner mediante elAWS Toolkit for Visual Studio Coderequiere lo siguiente: • Una cuenta de AWS. • Una versión deAWS Toolkit for Visual Studio Codeque cuenta conAWS App Runner Además de estos requisitos básicos, asegúrese de que todos los usuarios relevantes de IAM tengan permisos para interactuar con el servicio App Runner. También necesitas obtener información específica 25
AWSToolkit for VS Code Guía del usuario AWS App Runner sobre tu fuente de servicio, como el URI de la imagen del contenedor o la conexión al repositorio de GitHub. Necesitará esta información al crear el servicio de App Runner. Configuración de permisos de IAM para App Runner La forma más sencilla de conceder los permisos necesarios para App Runner es adjuntar un existenteAWSpolítica gestionada a los pertinentesAWS Identity and Access Management(IAM), específicamente un usuario o grupo. App Runner proporciona dos políticas administradas que puede asociar a los usuarios de IAM: • AWSAppRunnerFullAccess: Permite a los usuarios realizar todas las acciones de App Runner. • AWSAppRunnerReadOnlyAccess: permite a los usuarios mostrar y ver detalles acerca de los recursos de App Runner. Además, si elige un repositorio privado de Amazon Elastic Container Registry (Amazon ECR) como origen de servicio, debe crear el siguiente rol de acceso para su servicio de App Runner: • AWSAppRunnerServicePolicyForECRAccess: permite a App Runner acceder a imágenes de Amazon Elastic Container Registry (Amazon ECR) de su cuenta. Puede crear este rol automáticamente al configurar la instancia de servicio con VS CodePaleta de comandos del. Note LaFunción de servicio de AWS para ApprunnerLa función vinculada a un servicio permiteAWS App RunnerPara completar las siguientes tareas: • Envíe registros en los grupos de registros de Amazon CloudWatch Logs. • Cree reglas de Amazon CloudWatch Events para suscribirse a Amazon Elastic Container Registry (Amazon ECR). No necesita crear manualmente el rol vinculado al servicio . Al crear unAWS App Runneren laAWS Management Consoleo mediante operaciones de API a las que se llamaAWS Toolkit for Visual Studio Code,AWS App Runnercrea este rol vinculado al servicio por usted. Para obtener más información, consulteAdministración de identidades y acceso para App Runneren laAWS App RunnerGuía para desarrolladores. Obtener fuentes de servicio para App Runner Puede usarAWSApp Runner para implementar servicios desde una imagen o código fuente de origen. Source image Si va a implementar desde una imagen de origen, puede obtener un enlace al repositorio de esa imagen desde un privado o público.AWSregistro de imágenes. • Registro privado de Amazon ECR: Copie el URI de un repositorio privado que utiliza la consola de Amazon ECR enhttps://console.aws.amazon.com/ecr/repositories. • Registro público de Amazon ECR: Copie el URI de un repositorio público que utiliza Amazon ECR Public Gallery enhttps://gallery.ecr.aws/. Note También puede obtener el URI de un repositorio privado de Amazon ECR directamente desdeAWSExplorador deen Toolkit for VS Code: 26
AWSToolkit for VS Code Guía del usuario AWS App Runner • OpenAWSExplorador dey amplíe elECRnodo para ver la lista de repositorios para esoAWSRegión . • Haga clic con el botón derecho en un repositorio y elijaURI de copia del repositorioPara copiar el enlace al portapapeles. Especifica el URI del repositorio de imágenes al configurar la instancia de servicio con VS CodePaleta de comandos del Para obtener más información, consulteServicio App Runner basado en una imagen de origenen laAWS App RunnerGuía para desarrolladores. Source code Para que el código fuente se implemente en unAWS App Runner, ese código debe almacenarse en un repositorio de Git mantenido por un proveedor de repositorios compatible. App Runner admite un proveedor de repositorios de código fuente: GitHub. Para obtener información sobre el modo de configurar un repositorio de GitHub, consulte laDocumentación de introducciónen GitHub. Para implementar tu código fuente en un servicio de App Runner desde un repositorio de GitHub, App Runner establece una conexión con GitHub. Si tu repositorio es privado (es decir, no es accesible públicamente en GitHub), debes proporcionar detalles de conexión a App Runner. Important Para crear conexiones de GitHub, debes usar la consola de App Runner (https:// console.aws.amazon.com/apprunner) para crear una conexión que vincule GitHub aAWS. Puede seleccionar las conexiones que están disponibles en elConexiones de GitHubal configurar la instancia de servicio con VS CodePaleta de comandos del. Para obtener más información, consulteAdministración de conexiones de App Runen laAWS App RunnerGuía para desarrolladores. La instancia de servicio App Runner proporciona un tiempo de ejecución administrado que permite crear y ejecutar el código.AWS App Runneradmite actualmente los siguientes tiempos de ejecución: • Tiempo de ejecución administrado de Python • Tiempo de ejecución administrado de Node.js Como parte de la configuración del servicio, proporciona información sobre cómo se crea e inicia el servicio App Runner. Puede introducir esta información mediante elPaleta de comandos delo especificar un formato YAMLArchivo de configuración App Runner. Los valores de este archivo indican a App Runner cómo crear e iniciar el servicio y proporcionar contexto en tiempo de ejecución. Incluye la configuración de red y las variables de entorno relevantes. El archivo de configuración se llamaapprunner.yaml. Se añade automáticamente al directorio raíz del repositorio de la aplicación. Pricing Se le cobran los recursos informáticos y de memoria que utiliza la aplicación. Además, si automatiza las implementaciones, también pagará una tarifa mensual fija por cada aplicación que cubre todas las implementaciones automatizadas de ese mes. Si optas por implementar desde el código fuente, también pagas una tarifa de compilación por el tiempo que tarda App Runner en crear un contenedor a partir de tu código fuente. Para obtener más información, consulte Precios de AWS App Runner. 27
AWSToolkit for VS Code Guía del usuario AWS App Runner Temas • Crear servicios de App Runner (p. 28) • Administración de servicios de App Run (p. 30) Crear servicios de App Runner Puede crear un servicio de App Runner en Toolkit for VS Code mediante elAWSExplorador dey VS CodePaleta de comandos del. Después de elegir crear un servicio en un determinadoAWSRegión, pasos numerados proporcionados por elPaleta de comandos delle guiará durante el proceso de configuración de la instancia de servicio en la que se ejecuta la aplicación. Antes de crear un servicio de App Runner, asegúrese de que ha completado elRequisitos previos de (p. 25). Esto incluye proporcionar los permisos de IAM pertinentes y confirmar el repositorio de origen específico que desea implementar. Para crear un servicio de App Runner 1. OpenAWSExplorador de, si aún no está abierto. 2. Haga clic derecho enApp Runnernodo y eligeCrear un servicio. LaPaleta de comandos delmuestra. 3. ParaSeleccione un tipo de ubicación de código fuente, eligeECRorRepositorio. Si eligeECR, especifica una imagen de contenedor en un repositorio mantenido por Amazon Elastic Container Registry. Si eligeRepositorio, especifica un repositorio de código fuente que mantiene un proveedor de repositorios compatible. Actualmente, App Runner admiteGitHubcomo proveedor de repositorio de código fuente. Despliegue desde ECR 1. ParaSeleccionar o introducir un repositorio de imágenes, elija o introduzca la URL del repositorio de imágenes que mantiene su registro privado de Amazon ECR o la Galería pública de Amazon ECR. Note Si especifica un repositorio de Amazon ECR Public Gallery, asegúrese de que las implementaciones automáticas estén desactivadas porque App Runner no admite implementaciones automáticas para una imagen en un repositorio público de ECR. Las implementaciones automáticas se desactivan de forma predeterminada y esto se indica cuando el icono de laPaleta de comandos delel encabezado presenta una línea diagonal a través de él. Si eligió activar las implementaciones automáticas, un mensaje le informa de que esta opción puede generar costes adicionales. 2. Si el archivo dePaleta de comandos delStep informa de queNo se han encontrado etiquetas, debe retroceder un paso para seleccionar un repositorio que contenga una imagen de contenedor etiquetada. 3. Si utiliza un registro privado de Amazon ECR, necesita el rol de acceso ECR,Función de acceso ECR de AppRunner, que permite a App Runner acceder a imágenes de Amazon Elastic Container Registry (Amazon ECR) de su cuenta. Elija el icono «+» en elPaleta de comandos delencabezado para crear automáticamente este rol. (No se requiere un rol de acceso si la imagen se almacena en Amazon ECR Public, donde las imágenes están disponibles públicamente). 4. ParaPuerto, introduzca el puerto IP utilizado por el servicio (Puerto8000, por ejemplo). 5. Paraconfigurar variables de entorno, puede especificar un archivo que contenga variables de entorno que se utilizan para personalizar el comportamiento de la instancia de servicio. O puede omitir este paso. 28
También puede leer