Conceptos de CodeCatalyst

Familiarícese con los conceptos clave que le ayudarán a acelerar la colaboración y el desarrollo de aplicaciones en Amazon CodeCatalyst. Estos conceptos incluyen términos utilizados en el control de código fuente, la integración y la entrega continuas (CI/CD), la creación de modelos y la configuración de los procesos de publicación automatizados.

Para obtener información conceptual adicional, consulte los siguientes temas:

Espacios de ID de creador de AWS en CodeCatalyst

El administrador del espacio invita a los usuarios a CodeCatalyst enviando correos electrónicos de invitación individuales desde la página de miembros. Los usuarios que están invitados a CodeCatalyst o que se registran en CodeCatalyst crean su propio ID de creador de AWS. El perfil se administra en ID de creador de AWS y se muestra como nombre de usuario e información de perfil en la configuración de usuario de CodeCatalyst.

Espacios que admiten la federación de identidades en CodeCatalyst

Usuarios que se han añadido a los usuarios y grupos de SSO de la instancia de IAM Identity Center y que se administran en el almacén de identidades y han sido invitados a su espacio a través del IAM Identity Center. El administrador del espacio sincroniza la página de miembros de CodeCatalyst para obtener las actualizaciones más recientes. Los usuarios inician sesión mediante el portal de inicio de sesión de SSO configurado en la instancia de IAM Identity Center de la empresa. Los espacios que admiten la federación de identidades se conectan a la instancia del almacén de identidades a través de la aplicación Identity Center y su asignación al ID del almacén de identidades.

Proyectos

Un proyecto representa una iniciativa de colaboración en CodeCatalyst que respalda las tareas y a los equipos de desarrollo. Una vez que tenga un proyecto, puede añadir, actualizar o eliminar usuarios y recursos, personalizar el panel del proyecto y supervisar el progreso del trabajo de su equipo. Puede tener varios proyectos dentro de un espacio.

Para obtener más información sobre los proyectos, consulte Organización del trabajo con proyectos en CodeCatalyst.

Proyectos

Un esquema es un sintetizador de proyectos que genera y amplía las dependencias y los archivos de soporte de las aplicaciones, además de crear el proyecto de CodeCatalyst en la consola. Puede elegir un tipo de proyecto de una selección de esquemas de CodeCatalyst, ver el archivo README y obtener una vista previa del repositorio del proyecto y los recursos que se generarán. El proyecto se genera a partir de la configuración básica especificada en el esquema. El esquema del proyecto se sintetiza periódicamente, lo que actualiza los archivos del proyecto, como las dependencias de software, y vuelve a generar los recursos. Los proyectos utilizan una herramienta llamada Projen para sintetizarlos mediante la sincronización de las últimas actualizaciones del proyecto y la generación de archivos de soporte. Estos archivos pueden incluir package.json, Makefile, eslint, etc., según el tipo y el lenguaje de la aplicación. Los esquemas de proyectos pueden generar archivos que respalden recursos de AWS como constructos de CDK, plantillas de AWS CloudFormation y plantillas de AWS Serverless Application Model.

Para obtener más información sobre los esquemas de proyectos, consulte Creación de un proyecto integral con esquemas de CodeCatalyst.

Conexiones de cuentas

Una conexión de cuenta asocia un espacio de CodeCatalyst con su Cuenta de AWS. Una vez configurada la conexión de su cuenta, la Cuenta de AWS estará disponible en el espacio. A continuación, puede añadir roles de IAM a CodeCatalyst para poder acceder a los recursos de su Cuenta de AWS. También puede utilizar estos roles para sus acciones de flujo de trabajo de CodeCatalyst.

Puede limitar los proyectos y recursos que tienen acceso a las conexiones de cuenta habilitando las conexiones de cuenta restringidas a proyectos. Las conexiones de cuenta restringidas a proyectos están conectadas a Cuentas de AWS a las que solo tienen acceso determinados proyectos del espacio. Esto permite a los equipos de un espacio restringir el uso de AWS para los recursos integrados de Cuentas de AWS por proyecto. Por ejemplo, la cuenta utilizada para los flujos de trabajo de implementación y las conexiones de VPC en proyectos específicos solo estará disponible con una conexión de cuenta restringida al proyecto. Para obtener más información, consulte Configuring project-restricted account connections.

Para obtener más información sobre las conexiones de cuenta, consulte Permisos de acceso a recursos de AWS con Cuentas de AWS conectadas.

Conexiones de VPC

Una conexión de VPC es un recurso de CodeCatalyst que contiene todas las configuraciones necesarias para que su flujo de trabajo acceda a una VPC. Los administradores del espacio pueden añadir sus propias conexiones de VPC en la consola de Amazon CodeCatalyst en nombre de los miembros del espacio. Al añadir una conexión de VPC, los miembros del espacio pueden ejecutar acciones de flujo de trabajo y crear entornos de desarrollo que cumplan las reglas de la red y puedan acceder a los recursos de la VPC asociada.

Para obtener más información sobre las conexiones de VPC, consulte Managing Amazon Virtual Private Clouds en la Guía del administrador de CodeCatalyst.

ID de creador de AWS

Un ID de creador de AWS es una identidad personal que puede utilizar para registrarse e iniciar sesión en CodeCatalyst y en otras aplicaciones utilizadas en el proyecto. No es lo mismo que una Cuenta de AWS. Su ID de creador de AWS administra los metadatos, como el alias de usuario y la dirección de correo electrónico. Su ID de creador de AWS es una identidad única que respalda a los usuarios en todos los espacios de CodeCatalyst. Para obtener información sobre cómo acceder a su perfil de ID de creador de AWS, consulte Actualización de un perfil. Para obtener más información sobre ID de creador de AWS, consulte AWS Builder ID en la Referencia general de AWS.

Para obtener más información acerca cómo suscribirse e iniciar sesión, consulte Configuración e inicio de sesión en CodeCatalyst.

Perfiles de usuario en CodeCatalyst

Accede a su perfil de usuario de CodeCatalyst eligiendo la opción de perfil del menú desplegable que aparece debajo de sus iniciales de inicio de sesión en cualquier página de CodeCatalyst. Puede crear tokens de acceso personal (PAT) desde la página de su perfil, pero solo puede ver o eliminar los PAT con la AWS CLI. Su nombre de usuario es el alias que eligió cuando se registró. No puede cambiar su nombre de usuario. Para ver la página de perfil de otro usuario de CodeCatalyst, vaya a la pestaña Miembros de su proyecto y elija el usuario correspondiente.

Para acceder a su ID de creador de AWS, consulte su perfil de CodeCatalyst y, a continuación, elija ir a ID de creador de AWS. Se le redirigirá a su página de perfil de ID de creador de AWS. El nombre completo, la dirección de correo electrónico y la contraseña de su perfil se administran mediante su ID de creador de AWS, y puede editar esa información en la página ID de creador de AWS. Especificó esta información cuando se registró. Cuando esté listo para configurar la MFA para usar una aplicación de autenticación para iniciar sesión, utilizará la página ID de creador de AWS. Para obtener más información sobre cómo ver su perfil de ID de creador de AWS, consulte Actualización de un perfil.

Para obtener más información acerca cómo suscribirse e iniciar sesión, consulte Configuración e inicio de sesión en CodeCatalyst.

Repositorios de código fuente

Un repositorio de código fuente es donde almacena de manera segura el código y los archivos de su proyecto. Aquí también se almacena el historial de versiones de sus archivos. De forma predeterminada, un repositorio de código fuente se comparte con los demás usuarios de su proyecto de CodeCatalyst. Puede tener más de un repositorio de código fuente para un proyecto. Puede crear repositorios de código fuente para proyectos en CodeCatalyst, o puede decidir vincular un repositorio de código fuente existente alojado en otro servicio si ese servicio es compatible con una extensión instalada. Por ejemplo, puede vincular un repositorio de GitHub a un proyecto después de instalar la extensión GitHub Repositories. Para obtener más información, consulte Almacenamiento del código fuente en repositorios para un proyecto en CodeCatalyst y Inicio rápido: instalación de extensiones, conexión de proveedores y vinculación de recursos en CodeCatalyst.

Los repositorios de código fuente también son el lugar donde se almacena la información de configuración de su proyecto de CodeCatalyst, como el archivo de configuración que define los atributos y las acciones de su flujo de trabajo de CI/CD. Si crea su proyecto utilizando un esquema, se creará un repositorio de código fuente con la información de configuración del proyecto incluida en él. Si crea un proyecto vacío, debe crear un repositorio de código fuente para poder crear recursos que requieran información de configuración, como los flujos de trabajo.

Para conocer otros conceptos que pueden ayudarle a trabajar con los repositorios de código fuente y el control de código fuente, consulte Conceptos sobre los repositorios de código fuente.

Confirmaciones

Una confirmación es un cambio en un archivo o conjunto de archivos. En la consola de Amazon CodeCatalyst, una confirmación guarda los cambios y los envía a un repositorio de código fuente. La confirmación incluye información sobre el cambio, incluida la identidad del usuario que lo realizó, la fecha y hora del cambio, el título de la confirmación y cualquier mensaje incluido sobre el cambio. Para obtener más información, consulte Descripción de los cambios en el código fuente con las confirmaciones en Amazon CodeCatalyst.

En el contexto de un repositorio de código fuente de CodeCatalyst, las confirmaciones son instantáneas del contenido y de los cambios en el contenido del repositorio. Cada vez que un usuario confirma y envía un cambio, CodeCatalyst guarda información que incluye quién realizó el cambio, la fecha y la hora de la confirmación y los cambios realizados como parte de la confirmación. También se pueden añadir etiquetas de Git a las confirmaciones para identificar fácilmente confirmaciones específicas.

Para obtener más información sobre las confirmaciones consulte Descripción de los cambios en el código fuente con las confirmaciones en Amazon CodeCatalyst.

Entornos de desarrollo

Un entorno de desarrollo es un entorno de desarrollo basado en la nube que puede utilizar en CodeCatalyst para trabajar rápidamente con el código almacenado en los repositorios de código fuente de su proyecto. Las herramientas del proyecto y las bibliotecas de aplicaciones incluidas en su entorno de desarrollo se definen mediante un devfile en el repositorio de código fuente de su proyecto. Si no tiene un devfile en su repositorio de código fuente, se aplicará automáticamente un devfile predeterminado. El devfile predeterminado incluye las herramientas para los marcos y lenguajes de programación más utilizados. De forma predeterminada, los entornos de desarrollo se crean con un procesador de 2 núcleos, 4 GB de RAM y 16 GiB de almacenamiento persistente.

Flujos de trabajo

Un flujo de trabajo es un procedimiento automatizado que describe cómo compilar, probar e implementar su código como parte de un sistema de integración y entrega continuas (CI/CD). Un flujo de trabajo define una serie de pasos o acciones que se realizan durante la ejecución de un flujo de trabajo. Un flujo de trabajo también define los eventos, o desencadenadores, que activan el inicio del flujo de trabajo. Para configurar un flujo de trabajo, debe crear un archivo de definición de flujo de trabajo mediante el editor visual o de YAML de la consola de CodeCatalyst.

Para obtener más información acerca de los flujos de trabajo, consulte Creación, pruebas e implementaciones con flujos de trabajo.

Acciones

Una acción es el componente principal de un flujo de trabajo y define una unidad lógica de trabajo, o una tarea, que se realiza durante la ejecución de un flujo de trabajo. Por lo general, un flujo de trabajo incluye varias acciones que se ejecutan de forma secuencial o paralela en función de cómo se hayan configurado.

Para obtener más información sobre las acciones, consulte Configuración de acciones de flujo de trabajo.

Problemas

Una incidencia es un registro que realiza un seguimiento del trabajo relacionado con el proyecto. Puede crear una incidencia para una característica, una tarea, un error o cualquier otro trabajo relacionado con un proyecto. Si utiliza un desarrollo ágil, una incidencia también puede describir una épica o historia de usuario.

Para obtener más información sobre las incidencias, consulte Seguimiento y organización de los trabajos con problemas en CodeCatalyst.

Tokens de acceso personal (PAT)

Un token de acceso personal (PAT) es similar a una contraseña. Está asociado a su identidad de usuario y se puede usar en todos los espacios y proyectos de CodeCatalyst. Las PAT se utilizan para acceder a los recursos de CodeCatalyst, que incluyen entornos de desarrollo integrados (IDE) y repositorios de código fuente basados en Git. Los PAT lo representan a usted en CodeCatalyst y puede administrarlos en su configuración de usuario. Un usuario puede tener más de un PAT. Los tokens de acceso personal solo se muestran una vez. Como práctica recomendada, asegúrese de guardarlos de forma segura en su equipo local. De forma predeterminada, los PAT caducan al cabo de un año.

Para obtener más información sobre los PAT, consulte Concesión de acceso al repositorio para usuarios mediante tokens de acceso personal.

Conexiones personales

Una conexión personal es una autorización entre su identidad de CodeCatalyst y su proveedor de código fuente externo, como GitHub. Las conexiones personales se usan para permitir que un usuario de CodeCatalyst añada repositorios de código fuente de terceros. Por ejemplo, puede conectar un repositorio de GitHub a un espacio de CodeCatalyst. Se instala una aplicación de conector instalada en la cuenta de GitHub para usarla con los repositorios designados por el propietario de la cuenta. Puede crear una conexión personal para una identidad de usuario (alias de CodeCatalyst) en todos los espacios de un tipo de proveedor específico, como GitHub. Las conexiones personales se asocian a su ID de creador de AWS o a su usuario de SSO.

Para obtener más información, consulte Acceso a los recursos de GitHub con conexiones personales.

Roles

Un rol define el acceso de un usuario a los recursos de un proyecto o un espacio y las acciones que puede realizar ese usuario. El rol de un usuario se elige cuando se invita a ese usuario a un proyecto. Hay roles de nivel de espacio y roles de nivel de proyecto en CodeCatalyst. Un usuario con un rol administrativo en el nivel correcto puede cambiar los roles asignados. Por ejemplo, un usuario con el rol de administrador del proyecto tiene control total sobre ese proyecto y puede cambiar los roles de los usuarios en ese proyecto. Para obtener más información sobre los roles disponibles y los permisos que tiene cada rol, consulte Concesión de acceso en los roles de usuario.

Para obtener más información acerca de los roles de , consulte Concesión de acceso en los roles de usuario.