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.

Conceptos de repositorio de fuentes

Estos son algunos conceptos que debe conocer al trabajar con los repositorios de CodeCatalyst código fuente.

Proyectos

Un proyecto representa un esfuerzo colaborativo CodeCatalyst que apoya las tareas y los equipos de desarrollo. Una vez que tengas un proyecto, puedes añadir, actualizar o eliminar usuarios y recursos, personalizar el panel de control del proyecto y supervisar el progreso del trabajo de tu equipo. Puede tener varios proyectos dentro de un espacio.

Los repositorios de origen son específicos de los proyectos en los que los creas o enlazas en un espacio. No puedes compartir un repositorio entre proyectos ni puedes vincular un repositorio a más de un proyecto en un espacio. Los usuarios con el rol de colaborador o administrador de proyectos en un proyecto pueden interactuar con los repositorios de origen asociados a ese proyecto de acuerdo con los permisos otorgados a esos roles. Para obtener más información, consulte Concesión de acceso con roles de usuario.

Repositorios de origen

Un repositorio de código fuente es el lugar donde se almacenan de forma segura el código y los archivos de un proyecto. También almacena el historial de versiones de los archivos. De forma predeterminada, el repositorio de origen se comparte con los demás usuarios CodeCatalyst del proyecto. Puedes tener más de un repositorio de código fuente para un proyecto. Puedes crear repositorios de código fuente para proyectos en CodeCatalyst él, o puedes elegir vincular un repositorio de código fuente existente hospedado por otro servicio si ese servicio es compatible con una extensión instalada. Por ejemplo, puedes vincular un GitHub repositorio a un proyecto después de instalar la extensión GitHub Repositories. Para obtener más información, consulte Almacenar el código fuente en los repositorios de un proyecto en CodeCatalyst y Inicio rápido: instalar extensiones, conectar proveedores y vincular recursos en CodeCatalyst.

Entornos de desarrollo

Un entorno de desarrollo es un entorno de desarrollo basado en la nube que puede utilizar CodeCatalyst para trabajar rápidamente en 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 archivo de desarrollo en el repositorio de código fuente de su proyecto. Si no tiene un archivo de desarrollo en su repositorio de código fuente, se aplicará automáticamente un archivo de desarrollo predeterminado. El devfile predeterminado incluye herramientas para los marcos y lenguajes de programación más utilizados. De forma predeterminada, un entorno de desarrollo está configurado para tener un procesador de 2 núcleos, 4 GB y 16 GiB de almacenamiento persistente. RAM

Puede optar por clonar una rama existente de su repositorio de código fuente en su entorno de desarrollo o puede optar por crear una nueva rama como parte de la creación del entorno de desarrollo.

Tokens de acceso personal (PATs)

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

Cuando se trabaja con entornos de desarrollo integrados (IDEs), PATs son el equivalente a una contraseña de Git. Introduce la contraseña PAT cuando se te pida al configurar tu repositorio de Git IDE para que funcione con un repositorio de Git. Para obtener más información sobre cómo conectarte IDE con un repositorio basado en Git, consulta la documentación de tuIDE.

Ramificaciones

Una rama es un puntero o referencia a una confirmación en Git y en CodeCatalyst. Puedes usar ramas para organizar tu trabajo. Por ejemplo, puede usar las ramas para trabajar en una versión nueva o diferente de los archivos sin que ello afecte a los archivos de otras ramas. Puedes usar las ramas para desarrollar nuevas funciones, almacenar una versión específica de tu proyecto y mucho más. Un repositorio de origen puede tener una rama o varias ramas. Al crear un proyecto con una plantilla, el repositorio de origen creado para el proyecto contiene archivos de ejemplo en una rama llamada main. La rama principal es la rama predeterminada del repositorio.

Ramas predeterminadas

Los repositorios de origen CodeCatalyst tienen una rama predeterminada, independientemente de cómo los cree. Si eliges crear un proyecto con una plantilla, el repositorio de origen creado para ese proyecto incluye un README archivo.md además de código de ejemplo, definiciones de flujo de trabajo y otros recursos. Si creas un repositorio de código fuente sin usar una plantilla, se añadirá un README archivo.md como primera confirmación y se creará una rama predeterminada como parte de la creación del repositorio. Esta rama predeterminada se denomina main. Esta ramificación predeterminada es la que se utiliza como base o ramificación predeterminada en los repositorios (repos) locales cuando los usuarios clonan el repositorio. Puede cambiar la rama que se usa como rama predeterminada. Para obtener más información, consulte Administrar la rama predeterminada de un repositorio.

No puedes eliminar la rama predeterminada de un repositorio de origen. Los resultados de la búsqueda solo incluyen los resultados de la rama predeterminada.

Confirmaciones

Una confirmación es un cambio en un archivo o conjunto de archivos. En la CodeCatalyst consola de Amazon, una confirmación guarda los cambios y los envía a un repositorio de origen. 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 del compromiso y cualquier mensaje incluido sobre el cambio. Para obtener más información, consulte Cómo entender los cambios en el código fuente con las confirmaciones en Amazon CodeCatalyst.

En el contexto de un repositorio fuente CodeCatalyst, las confirmaciones son instantáneas del contenido del repositorio y de los cambios en él. También puedes añadir etiquetas Git a las confirmaciones para identificar confirmaciones específicas.

Solicitudes de extracción

Una solicitud de incorporación de cambios es la principal forma en que tú y otros usuarios revisan, comentan y fusionan los cambios de código de una rama a otra en un repositorio de código fuente. Puedes usar las solicitudes de extracción para revisar los cambios en el código de forma colaborativa para comprobar si se han realizado cambios o correcciones menores, si se han incorporado funciones importantes o si se han introducido nuevas versiones del software que has publicado. En una solicitud de extracción, puedes revisar los cambios entre las sucursales de origen y destino o las diferencias entre las revisiones de esas sucursales. Puedes añadir comentarios a los cambios de líneas de código individuales, así como comentarios sobre la solicitud de extracción en general.

Revisiones

Una revisión es una versión actualizada de una solicitud de cambios. Cada envío a la rama de origen de una solicitud de incorporación de cambios crea una revisión que contiene los cambios realizados en las confirmaciones incluidas en ese envío. Puedes ver las diferencias entre las revisiones de una solicitud de cambios, además de las diferencias entre las ramas de origen y destino. Para obtener más información, consulte Revisar el código con solicitudes de cambios en Amazon CodeCatalyst.

Flujos de trabajo

Un flujo de trabajo es un procedimiento automatizado que describe cómo crear, probar e implementar el 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 deben realizar durante la ejecución de un flujo de trabajo. Un flujo de trabajo también define los eventos, o desencadenantes, que provocan el inicio del flujo de trabajo. Para configurar un flujo de trabajo, debe crear un archivo de definición del flujo de trabajo mediante el YAMLeditor visual o visual de la CodeCatalyst consola.

Un repositorio de origen también puede almacenar los archivos de configuración y otra información para los flujos de trabajo, las notificaciones, los problemas y otra información de configuración del proyecto. Los archivos de configuración se crean y almacenan en el repositorio de origen cuando se crean recursos que requieren archivos de configuración o cuando se especifica el repositorio como acción de origen para un flujo de trabajo. Si crea un proyecto a partir de un blueprint, ya dispondrá de los archivos de configuración almacenados en el repositorio de origen creado para usted como parte del proyecto. Esta información de configuración se almacena en una carpeta denominada .codecatalyst en la rama predeterminada del repositorio. Siempre que se crea una rama de la rama predeterminada, se crea una copia de esta carpeta y su configuración, además de todos los demás archivos y carpetas de esa rama.