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 del 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 tienes un devfile en tu repositorio de código fuente, se aplicará automáticamente un devfile 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 de RAM y 16 GiB de almacenamiento persistente.

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 (PAT)

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 en los que se encuentre CodeCatalyst. Las PATs se utilizan para acceder a CodeCatalyst recursos que incluyen entornos de desarrollo integrados (IDE) y repositorios de código fuente basados en Git. Las PAT te representan CodeCatalyst y puedes administrarlas en tu configuración de usuario. Un usuario puede tener más de una PAT. 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, los PAT caducan al cabo de un año.

Cuando se trabaja con entornos de desarrollo integrados (IDE), las PAT equivalen a una contraseña de Git. Proporcione la PAT cuando se le solicite una contraseña al configurar su IDE para que funcione con un repositorio de Git. Para obtener más información sobre cómo conectar el IDE con un repositorio basado en Git, consulte la documentación del IDE.

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 archivo README.md además de código de muestra, definiciones de flujo de trabajo y otros recursos. Si creas un repositorio de código fuente sin usar una plantilla, se añade un archivo README.md como primera confirmación y se crea 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.

sugerencia

Al crear una solicitud de extracción, la diferencia que se muestra es la diferencia entre la punta de la rama de origen y la punta de la rama de destino. Una vez creada la solicitud de extracción, la diferencia que se mostrará será entre la revisión de la solicitud de extracción que hayas elegido y la confirmación que estaba en la punta de la sucursal de destino cuando creaste la solicitud de extracción. Para obtener más información sobre las diferencias y las bases de fusión en Git, consulta git-merge-basela documentación de Git.

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 editor visual o YAML de la CodeCatalyst consola.

sugerencia

Para ver rápidamente cómo puedes usar los flujos de trabajo en un proyecto, crea un proyecto con un plano. Cada esquema implementa un flujo de trabajo funcional que puede revisar, ejecutar y experimentar.

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. Al crear 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.