Conceptos sobre los repositorios de código fuente
Aquí tiene algunos conceptos que debe conocer al utilizar repositorios de código fuente en CodeCatalyst.
Temas
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.
Los repositorios de código fuente son específicos de los proyectos en los que se crean o se vinculan en un espacio. No se puede compartir un repositorio entre proyectos ni se puede 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 código fuente asociados a ese proyecto de acuerdo con los permisos otorgados a esos roles. Para obtener más información, consulte Concesión de acceso en los roles de usuario.
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.
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.
Puede optar por clonar una ramificación existente de su repositorio de código fuente en su entorno de desarrollo o puede optar por crear una nueva ramificación 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 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.
Cuando se trabaja con entornos de desarrollo integrados (IDE), las PAT equivalen a una contraseña de Git. Proporcione el PAT cuando se le solicite una contraseña al configurar sus IDE para usarlos con un repositorio de Git. Para obtener más información acerca de cómo conectar su IDE a un repositorio basado en Git, consulte la documentación de su IDE.
Ramificaciones
Una ramificación es un puntero o una referencia a una confirmación en Git y en CodeCatalyst. Puede usar ramificaciones para organizar su trabajo. Por ejemplo, puede utilizar ramificaciones para separar el trabajo en una versión de los archivos nueva o diferente sin que ello afecte al trabajo en otras ramificaciones. Puede utilizar las ramificaciones para desarrollar nuevas características, guardar una versión específica del proyecto y mucho más. Un repositorio de código fuente puede tener una ramificación o varias ramificaciones. Al crear un proyecto con una plantilla, el repositorio de código fuente creado para el proyecto contiene archivos de ejemplo en una ramificación llamada main. La ramificación llamada main es la ramificación predeterminada de su repositorio.
Ramificaciones predeterminadas
Los repositorios de código fuente de CodeCatalyst tienen una ramificación predeterminada, independientemente de cómo se creen. Si decide crear un proyecto con un esquema, el repositorio de código fuente creado para ese proyecto incluye un archivo README.md además de un código de muestra, unas definiciones de flujo de trabajo y otros recursos. Si crea un repositorio de código fuente sin utilizar un esquema, se añade un archivo README.md como primera confirmación y se crea una ramificación predeterminada por usted como parte de la creación del repositorio. Esta ramificación 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 ramificación que se usa como predeterminada. Para obtener más información, consulte Administración de la ramificación predeterminada de un repositorio.
No puede eliminar la ramificación predeterminada de un repositorio de código fuente. Los resultados de búsqueda solo incluyen los resultados de la ramificación predeterminada.
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.
Las confirmaciones de un repositorio de código fuente de CodeCatalyst son instantáneas del contenido y de los comentarios y cambios en el contenido de su repositorio. También se pueden añadir etiquetas de Git a las confirmaciones para identificar fácilmente confirmaciones específicas.
Solicitudes de extracción
Una solicitud de extracción es la forma principal de que usted y otros usuarios puedan revisar, realizar comentarios y combinar los cambios en el código de una ramificación a otra en un repositorio de código fuente. Puede utilizar las solicitudes de extracción para revisar de forma colaborativa los cambios en el código relacionados con pequeños cambios o correcciones, incorporación de características importantes o versiones nuevas del software publicado. En una solicitud de extracción, puede revisar los cambios entre las ramificaciones de origen y destino o las diferencias entre las revisiones de esas ramificaciones. Puede añadir comentarios a líneas individuales de cambios en el 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 el extremo de la ramificación de origen y el extremo de la ramificación de destino. Una vez creada la solicitud de extracción, la diferencia mostrada será aquella entre la revisión de la solicitud de extracción seleccionada y la confirmación que se encontraba en el extremo de la ramificación de destino cuando se creó la solicitud de extracción. Para obtener más información sobre las diferencias y las bases de combinación en Git, consulte git-merge-base
Revisiones
Una revisión es una versión actualizada de una solicitud de extracción. Cada vez que se envía una solicitud de extracción a la ramificación de origen se crea una revisión que contiene los cambios realizados en las confirmaciones incluidas en ese envío. Puede ver las diferencias entre revisiones de una solicitud de extracción de forma adicional a las diferencias entre las ramificaciones de origen y destino. Para obtener más información, consulte Revisión del código con solicitudes de extracción en Amazon CodeCatalyst.
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.
sugerencia
Para ver rápidamente cómo se pueden utilizar los flujos de trabajo en un proyecto, cree un proyecto con un esquema. Cada esquema implementa un flujo de trabajo funcional que puede revisar, ejecutar y probar.
Un repositorio de código fuente 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 código fuente 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 esquema, ya dispondrá de los archivos de configuración almacenados en el repositorio de código fuente creado por usted como parte del proyecto. Esta información de configuración se almacena en una carpeta denominada .codecatalyst en la ramificación predeterminada del repositorio. Siempre que se crea una ramificación a partir de la ramificación predeterminada, se crea una copia de esta carpeta y su configuración, además de todos los demás archivos y carpetas de esa ramificación.
