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.
Estos son algunos conceptos que debe conocer al trabajar con los repositorios de CodeCatalyst código fuente.
Temas
Proyectos
Un proyecto representa un esfuerzo colaborativo CodeCatalyst que apoya las tareas y 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, el repositorio fuente se comparte con los demás usuarios CodeCatalyst del proyecto. Puede 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 puedes usar CodeCatalyst para trabajar rápidamente en el código almacenado en los repositorios de código fuente de tu 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 () PATs
Un token de acceso personal (PAT) es similar a una contraseña. Está asociado a tu identidad de usuario para poder usarlo en todos los espacios y proyectos en los que se encuentren 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. PATs te representan CodeCatalyst y puedes gestionarlos en tu 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, 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. 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 rama es un puntero o 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 CodeCatalyst tienen una rama predeterminada, independientemente de cómo los crees. 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 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 de la confirmación 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 y los cambios en el contenido de tu 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 fusión en Git, consulta 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 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 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, debes 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 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.
