

Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).

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.

# Implementación en Cuentas de AWS y VPCs
<a name="deploy-environments"></a>

Con [CodeCatalyst los flujos de trabajo](workflow.md), puedes implementar aplicaciones y otros recursos para segmentar Cuenta de AWS s y Amazon VPCs en la AWS nube. Para habilitar estas implementaciones, debe configurar los CodeCatalyst entornos.

Un CodeCatalyst *entorno*, que no debe confundirse con un [entorno de desarrollo](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html), define la Amazon VPC de destino Cuenta de AWS y opcional a la que se conecta un CodeCatalyst [flujo de trabajo](workflow.md). Un entorno también define la [función de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que necesita un flujo de trabajo para acceder a los AWS servicios y recursos de la cuenta de destino.

Puede configurar varios entornos y asignarles nombres, como desarrollo, pruebas, almacenamiento provisional y producción. Al realizar un despliegue en estos entornos, la información sobre los despliegues aparece en las pestañas **Actividad de CodeCatalyst despliegue** y **Objetivos de despliegue** del entorno.

## ¿Cómo empiezo a utilizar los entornos?
<a name="deploy-environments-get-started"></a>

Los pasos generales para agregar y usar un CodeCatalyst entorno son los siguientes:

1. En tu CodeCatalyst espacio, **conecta una o más AWS cuentas**. Durante este proceso, añada los roles de IAM que requiere su flujo de trabajo para acceder a los recursos de la Cuenta de AWS. Para obtener más información, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md).

1. En su CodeCatalyst proyecto, **cree un entorno** que incluya una de las funciones de Cuenta de AWS s e IAM del paso 1. Para obtener más información, consulte [Creación de un entorno](deploy-environments-creating-environment.md).

1. En tu CodeCatalyst proyecto, en un flujo de trabajo, **añade una [acción](workflows-actions.md) que apunte al entorno** que creaste en el paso 2. Para obtener más información, consulte [Cómo añadir una acción a un flujo de trabajo](workflows-add-action.md).

   Ahora ha configurado un entorno. La acción ahora puede implementar recursos en la Cuenta de AWS especificada en el entorno.

**nota**  
También puede añadir una Amazon VPC al entorno. Para obtener más información, consulte [Agregar conexiones de VPC para un espacio](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) en la *Guía de CodeCatalyst administración* y. [Asociación de una VPC a un entorno](deploy-environments-associate-vpc.md)

## ¿Puede haber varios entornos dentro de un único flujo de trabajo?
<a name="deploy-environments-multiple"></a>

Sí. Si un flujo de trabajo incluye varias acciones, a cada una de ellas se le puede asignar un entorno. Por ejemplo, puede tener un flujo de trabajo que incluya dos acciones de implementación: una asignada a un entorno de `my-staging-enviroment` y otra asignada a un entorno de `my-production-environment`.

## ¿Qué acciones de flujo de trabajo admiten entornos?
<a name="deploy-environments-supported"></a>

Cualquier acción de flujo de trabajo que despliegue recursos en la AWS nube o se comunique con AWS los servicios por otros motivos (como la supervisión y la generación de informes) es compatible con los entornos.

## ¿Qué acciones permiten que se muestre la información de implementación? CodeCatalyst
<a name="deploy-environments-supported-targets"></a>

De las acciones de flujo de trabajo compatibles con los entornos, solo unas pocas permiten que su información de despliegue aparezca en las páginas de **actividad** de **despliegue y objetivos** del despliegue de la CodeCatalyst consola.

Las siguientes acciones del flujo de trabajo permiten que se muestre su información de implementación:
+ Pila ** CloudFormation de implementación**: para obtener más información, consulte [Implementación de una CloudFormation pila](deploy-action-cfn.md)
+ **Implementar en Amazon ECS**: para obtener más información, consulte [Implementación en Amazon ECS con un flujo de trabajo](deploy-action-ecs.md)
+ **Implementar el clúster de Kubernetes**: para obtener más información, consulte [Implementación en Amazon EKS con un flujo de trabajo](deploy-action-eks.md)
+ **AWS CDK implementar**: para obtener más información, consulte [Implementación de una AWS CDK aplicación con un flujo de trabajo](cdk-dep-action.md)

## Regiones admitidas
<a name="deploy-environments-supported-regions"></a>

La página **Entornos** puede mostrar los recursos de cualquier región de AWS .

## ¿Es obligatorio disponer de un entorno?
<a name="deploy-environments-optional-or-mandatory"></a>

Un entorno es obligatorio si la acción de flujo de trabajo a la que se le asigna despliega recursos en la AWS nube o se comunica con AWS los servicios por otros motivos (como la supervisión y la generación de informes).

Por ejemplo, si tiene una acción de compilación que crea una aplicación pero no necesita comunicarse con su VPC Cuenta de AWS o con Amazon VPC, no necesita asignar un entorno a la acción. Sin embargo, si la acción de compilación envía registros al CloudWatch servicio de Amazon que tengas Cuenta de AWS, la acción debe tener un entorno asignado. 

**Topics**
+ [¿Cómo empiezo a utilizar los entornos?](#deploy-environments-get-started)
+ [¿Puede haber varios entornos dentro de un único flujo de trabajo?](#deploy-environments-multiple)
+ [¿Qué acciones de flujo de trabajo admiten entornos?](#deploy-environments-supported)
+ [¿Qué acciones permiten que se muestre la información de implementación? CodeCatalyst](#deploy-environments-supported-targets)
+ [Regiones admitidas](#deploy-environments-supported-regions)
+ [¿Es obligatorio disponer de un entorno?](#deploy-environments-optional-or-mandatory)
+ [Creación de un entorno](deploy-environments-creating-environment.md)
+ [Asociación de un entorno a una acción](deploy-environments-add-app-to-environment.md)
+ [Asociación de una VPC a un entorno](deploy-environments-associate-vpc.md)
+ [Asociar un hombre Cuenta de AWS con un entorno](deploy-environments-associate-account.md)
+ [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md)

# Creación de un entorno
<a name="deploy-environments-creating-environment"></a>

Siga estas instrucciones para crear un entorno que pueda asociar posteriormente a una acción de flujo de trabajo.

**Antes de empezar**

Necesitará lo siguiente:
+ Un CodeCatalyst espacio. Para obtener más información, consulte [Configuración e inicio de sesión en CodeCatalystConfiguración e inicio de sesión en CodeCatalyst](setting-up-topnode.md).
+ Un CodeCatalyst proyecto. Para obtener más información, consulte [Creación de un proyecto con un esquema](projects-create.md#projects-create-console-template).
+ Una conexión de AWS cuenta que incluye las funciones de IAM a las que necesitará acceder AWS tu acción de flujo de trabajo. Para obtener más información sobre la creación de una conexión de cuenta, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md). Puede utilizar como máximo una conexión de cuenta por entorno.
**nota**  
Puede crear un entorno sin una conexión de cuenta; sin embargo, tendrá que volver y añadir la conexión más adelante.
+ Uno de los siguientes CodeCatalyst roles:
  + **Administrador del espacio**
  + **Administrador del proyecto**
  + **Colaborador**
**nota**  
Si tiene el **rol Colaborador**, podrá crear un entorno, pero no podrá asociarlo a una conexión de Cuenta de AWS . Deberás pedirle a alguien con el rol de **administrador del espacio** o **administrador del proyecto** que asocie el entorno a una Cuenta de AWS conexión.

   Para obtener más información acerca de los permisos y roles, consulte [Concesión de permisos de proyecto a los usuarios](projects-members.md).

**Creación de un entorno**

1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Entornos**.

1. En **Nombre del entorno**, introduzca un nombre, como **Production** o **Staging**.

1. En **Tipo de entorno**, seleccione una de las siguientes opciones:
   + **No producción**: un entorno en el que puede probar la aplicación para asegurarse de que funcione según lo previsto antes de moverla a producción.
   + **Producción**: un entorno “en vivo” que está disponible públicamente y que aloja la aplicación finalizada.

     Si elige **Producción**, aparecerá el distintivo **Producción** en la interfaz de usuario junto a cualquier acción a la que esté asociado el entorno. El distintivo le ayuda a saber rápidamente qué acciones se están implementando en producción. Aparte de la apariencia del distintivo, no hay diferencias entre los entornos de producción y los que no son de producción.

1. (Opcional) En **Descripción**, escriba una descripción, como **Production environment for the hello-world app**.

1. En **Cuenta de AWS Conexión (opcional)**, elija la conexión de AWS cuenta que desee asociar a este entorno. Las acciones del flujo de trabajo que estén asignadas al entorno podrán conectarse a la Cuenta de AWS asociada. Para obtener más información sobre la creación de Cuenta de AWS conexiones en CodeCatalyst, consulte[Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md).

   Si la Cuenta de AWS conexión que desea usar no aparece en la lista, es posible que se deba a que no está permitida en su proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.

1. En **Rol de IAM predeterminado**, elija el rol de IAM que desea asociar a este entorno. Las acciones de flujo de trabajo a las que se asigne este entorno heredarán esta función de IAM y podrán utilizarla para conectarse a los servicios y recursos de su entorno. Cuenta de AWS

   Si necesita asignar el entorno a varias acciones y esas acciones requieren roles de IAM distintos de los que se especifican aquí de forma predeterminada, puede especificar los distintos roles en la pestaña **Configuración** de cada acción mediante la opción **Cambiar rol**. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).

   Si la función de IAM que desea usar como predeterminada no aparece en la lista, es posible que se deba a que aún no la ha agregado a su Cuenta de AWS conexión. Para añadir un rol de IAM a una conexión de cuenta, consulte [Adición de roles de IAM a las conexiones de cuentas](ipa-connect-account-addroles.md).

1. (Opcional) En **Conexión de VPC**, elija la conexión de VPC que desee asociar a este entorno. Para obtener más información sobre la creación de conexiones de VPC, consulte Gestión de [Amazon Virtual Private Clouds](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) en la Guía * CodeCatalyst del administrador de Amazon*.

   Si la conexión de VPC que quieres usar no aparece en la lista, puede que se deba a que incluye una Cuenta de AWS conexión que no está permitida en tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.

1. Seleccione **Crear** entorno. CodeCatalyst crea un entorno vacío.

**Siguientes pasos**
+ Ahora que ha creado un entorno, puede asociarlo a una acción del flujo de trabajo. Para obtener más información, consulte [Asociación de un entorno a una acción](deploy-environments-add-app-to-environment.md).

# Asociación de un entorno a una acción
<a name="deploy-environments-add-app-to-environment"></a>

Al asociar un entorno a una [acción de flujo de trabajo compatible](deploy-environments.md#deploy-environments-supported), el entorno Cuenta de AWS, la función de IAM predeterminada y la Amazon VPC opcional se asignan a la acción. A continuación, la acción puede conectarse e implementarse en la Cuenta de AWS con el rol de IAM y también conectarse a Amazon VPC opcional.

Siga estas instrucciones para asociar un entorno a una acción.

## Paso 1: asociación del entorno a una acción de flujo de trabajo
<a name="deploy-environments-add-app-to-environment-assoc"></a>

Utilice el siguiente procedimiento para asociar un entorno a una acción de flujo de trabajo.

------
#### [ Visual ]

**Asociación de un entorno a una acción de flujo de trabajo mediante el editor visual**

1. [Abra la CodeCatalyst consola en https://codecatalyst.aws/.](https://codecatalyst.aws/)

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Elija **Visual**.

1. En el diagrama de flujo de trabajo, elija una acción que sea compatible con los entornos. Para obtener más información, consulte [¿Qué acciones permiten que se muestre la información de implementación? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).

1. Seleccione la pestaña **Configuración** y especifique la información en el campo **Entorno**, de la siguiente manera.

   **Entorno**

   Especifique el CodeCatalyst entorno que se va a utilizar con la acción. La acción se conecta a Cuenta de AWS la Amazon VPC opcional especificada en el entorno elegido. La acción utiliza la función de IAM predeterminada especificada en el entorno para conectarse a Cuenta de AWS, y utiliza la función de IAM especificada en la [conexión de Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) para conectarse a la Amazon VPC.
**nota**  
Si el rol de IAM predeterminado no tiene los permisos necesarios para la acción, puede configurarla para que utilice un rol diferente. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).

   Para obtener más información sobre los entornos, consulte [Implementación en Cuentas de AWS y VPCs](deploy-environments.md) y [Creación de un entorno](deploy-environments-creating-environment.md).

1. (Opcional) Cambie el rol de IAM asociado a la acción. Es posible que desee cambiar el rol si contiene un conjunto de permisos incorrecto para la acción.

    Para cambiar el rol:

   1. **En la sección ¿Qué hay de nuevo? *my-environment*** y selecciona el icono de puntos suspensivos verticales (![\[Ellipsis.\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/images/flows/elipsis.png)).

   1. Seleccione una de las siguientes opciones:
      +  **Cambiar el rol**. Seleccione esta opción para cambiar el rol de IAM utilizado por esta acción y solo por esta acción. Otras acciones seguirán utilizando el rol de IAM predeterminado especificado en su entorno asociado. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).
      +  **Editar entorno**. Seleccione esta opción para cambiar el rol de IAM predeterminado que se muestra en el entorno. Si elige esta opción, la acción (y cualquier otra acción asociada al mismo entorno) comienza a utilizar el nuevo rol de IAM predeterminado.
**importante**  
Tenga cuidado al actualizar el rol de IAM predeterminado. Si los permisos del rol no son suficientes para todas las acciones que comparten el entorno, es posible que se produzcan errores en las acciones.

1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.

1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.

------
#### [ YAML ]

**Asociación de un entorno a una acción de flujo de trabajo mediante el editor de YAML**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Elija **YAML**.

1. En la acción de flujo de trabajo que desea asociar a un entorno, añada un código similar al siguiente:

   ```
   action-name:
     Environment:
       Name: environment-name
   ```

   Para obtener más información, consulte el tema [Tipos de acción](workflows-actions.md#workflows-actions-types). Este tema contiene enlaces a la documentación de cada acción, incluida su referencia de YAML.

1. (Opcional) Si desea que la acción utilice un rol diferente del rol de IAM predeterminado que aparece en el entorno, añada una sección `Connections:` que incluya el rol que quiere usar. Para obtener más información, consulte [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).

1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.

1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.

------

## Paso 2: cumplimentación de la página de actividades de implementación
<a name="deploy-environments-add-app-to-environment-run"></a>

Tras asociar un entorno a una acción de flujo de trabajo, puede rellenar las páginas **Actividad de despliegue** y **Destino del despliegue** en la sección **Entornos** de la CodeCatalyst consola con información sobre el despliegue. Siga estas instrucciones para rellenar estas páginas.

**nota**  
Solo unas pocas acciones permiten que su información de despliegue se muestre en la CodeCatalyst consola. Para obtener más información, consulte [¿Qué acciones permiten que se muestre la información de implementación? CodeCatalyst](deploy-environments.md#deploy-environments-supported-targets).

**Para añadir información de despliegue a CodeCatalyst**

1. Si la ejecución de un flujo de trabajo no se inició automáticamente cuando realizó los cambios en [Paso 1: asociación del entorno a una acción de flujo de trabajo](#deploy-environments-add-app-to-environment-assoc), inicie una ejecución manualmente de la siguiente manera:

   1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

   1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

   1. Seleccione **Ejecutar**.

   La ejecución del flujo de trabajo inicia una nueva implementación, lo que hace CodeCatalyst que se agregue información de implementación a CodeCatalyst.

1. Compruebe que la actividad de despliegue se haya agregado a la CodeCatalyst consola:

   1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Entornos**.

   1. Elija su entorno (por ejemplo, `Production`).

   1. Seleccione la pestaña **Actividad de implementación** y compruebe que aparezca una implementación con el **estado** **CORRECTO**. Esto indica que un flujo de trabajo ejecutado implementó correctamente los recursos de la aplicación.

   1. Seleccione la pestaña **Destinos de implementación** y compruebe que aparecen los recursos de la aplicación.

# Asociación de una VPC a un entorno
<a name="deploy-environments-associate-vpc"></a>

Cuando se configura una acción con un entorno que tiene una conexión de VPC, la acción se ejecutará conectada a la VPC, respetando las reglas de red y los recursos de acceso especificados por la VPC asociada. Uno o varios entornos pueden utilizar la misma conexión de VPC.

Siga estas instrucciones para asociar una conexión de VPC a un entorno.

**Asociación de una conexión de VPC a un entorno**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Entornos**.

1. Elija su entorno (por ejemplo, `Production`).

1. Elija la pestaña de **Propiedades del entorno**.

1. Elija **Administrar la conexión de VPC**, elija la conexión de VPC que desee y elija **Confirmar**. Esto asocia la conexión de VPC seleccionada a este entorno.
**nota**  
Si la conexión de VPC que quieres usar no aparece en la lista, puede que se deba a que incluye una Cuenta de AWS conexión que no está permitida en tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalystdel administrador de Amazon*.

Para obtener más información, consulte [Gestión de Amazon Virtual Private Clouds](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) en la *Guía CodeCatalyst del administrador*.

# Asociar un hombre Cuenta de AWS con un entorno
<a name="deploy-environments-associate-account"></a>

Utilice las siguientes instrucciones para Cuenta de AWS asociar y a un entorno. Al Cuenta de AWS asociar un a un entorno, las acciones del flujo de trabajo que estén asignadas al entorno podrán conectarse al Cuenta de AWS.

Para obtener más información sobre las conexiones de cuenta, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md).

**Antes de empezar**

Necesitará lo siguiente:
+ Una conexión de AWS cuenta que incluya las funciones de IAM a las que necesitará acceder AWS tu acción de flujo de trabajo. Para obtener más información sobre la creación de una conexión de cuenta, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md). Puede utilizar como máximo una conexión de cuenta por entorno.
+ Uno de los siguientes CodeCatalyst roles: **administrador del espacio o administrador** **del proyecto**. Para obtener más información, consulte [Concesión de permisos de proyecto a los usuarios](projects-members.md).

**Para asociar y Cuenta de AWS a un entorno**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Entornos**.

1. Elija su entorno (por ejemplo, `Production`).

1. Elija **Editar entorno**.

1. En **Propiedades del entorno**, en la lista desplegable **Cuenta de AWS conexión (opcional)**, elija la Cuenta de AWS que desee.

   Si la Cuenta de AWS conexión que quieres usar no aparece en la lista, puede que se deba a que no está permitida en tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.

1. En **Rol de IAM predeterminado**, elija el rol de IAM que desea asociar a este entorno. Las acciones de flujo de trabajo a las que se asigne este entorno heredarán esta función de IAM y podrán utilizarla para conectarse a los servicios y recursos de su entorno. Cuenta de AWS

   Si la función de IAM que desea usar como predeterminada no aparece en la lista, es posible que se deba a que aún no la ha agregado a su Cuenta de AWS conexión. Para añadir un rol de IAM a una conexión de cuenta, consulte [Adición de roles de IAM a las conexiones de cuentas](ipa-connect-account-addroles.md).

# Cambio del rol de IAM de una acción
<a name="deploy-environments-switch-role"></a>

De forma predeterminada, al asociar un [entorno](deploy-environments.md) a una acción de flujo de trabajo, la [acción](workflows-actions.md) hereda el rol de IAM predeterminado especificado en el entorno. Puede cambiar este comportamiento para que la acción utilice un rol diferente. Es posible que desee que una acción utilice un rol diferente si al rol de IAM predeterminado le faltan los permisos que la acción necesita para funcionar en la nube de AWS .

Para asignar un rol de IAM diferente a una acción, puede usar la opción **Cambiar rol** en el editor visual o la propiedad `Connections:` en el editor de YAML. El nuevo rol invalida el rol de IAM predeterminado especificado en el entorno, lo que le permite mantener el rol de IAM predeterminado tal como está. Es posible que desee mantener el rol de IAM predeterminado tal como está si hay otras acciones que lo utilizan.

Siga estas instrucciones para configurar una acción que utilice un rol de IAM diferente del especificado en su entorno.

------
#### [ Visual ]

**Asignación de un rol de IAM diferente a una acción (editor visual)**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Seleccione la casilla que representa la acción cuyo rol de IAM desea actualizar.

1. Elija la pestaña **Configuración**.

1. En la **sección ¿Qué hay*my-environment*?** selecciona el icono de puntos suspensivos verticales (![\[Ellipsis.\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/images/flows/elipsis.png)).

1. Elija **Cambiar rol**.

1. En el cuadro de diálogo **Cambiar rol**, en la lista desplegable **Rol de IAM**, elija el rol de IAM que desee que utilice la acción. Este rol invalidará el rol de IAM predeterminado del entorno. Si el rol que quiere usar no está en la lista, asegúrese de haberlo añadido a su espacio. Para obtener más información, consulte [Adición de roles de IAM a las conexiones de cuentas](ipa-connect-account-addroles.md).

   El rol elegido aparece ahora en la sección **¿Qué hay? *my-environment*** cuadro junto con la insignia **Definido en el flujo de trabajo**. El rol también aparece en el archivo de definición del flujo de trabajo, en la sección `Connections:`.

1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.

1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.

------
#### [ YAML ]

**Asignación de un rol de IAM diferente a una acción (editor de YAML)**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Elija el proyecto.

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Elija **YAML**.

1. En la acción del flujo de trabajo en la que desee utilizar un rol de IAM diferente, añada una sección `Connections:` similar a la siguiente:

   ```
   action-name:
     Environment:
       Name: environment-name
       Connections: 
         - Name: account-connection-name
           Role: iam-role-name
   ```

   En el código anterior, *account-connection-name* sustitúyalo por el nombre de la [conexión de cuenta](ipa-connect-account.md) que contiene el rol de IAM y *iam-role-name* sustitúyelo por el nombre del rol de IAM que quieres que utilice la acción. Este rol invalidará el rol de IAM predeterminado del entorno. Asegúrese de haber añadido el rol a su espacio. Para obtener más información, consulte [Adición de roles de IAM a las conexiones de cuentas](ipa-connect-account-addroles.md).

   Para obtener más información, consulte el tema [Tipos de acción](workflows-actions.md#workflows-actions-types). Este tema contiene enlaces a la documentación de cada acción, incluida su referencia de YAML.

------