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.
Sigue los pasos de este tutorial para aprender a trabajar con los repositorios de código fuente en Amazon CodeCatalyst.
La forma más rápida de empezar a trabajar con los repositorios de código fuente en Amazon CodeCatalyst es crear un proyecto con una plantilla. Al crear un proyecto con una plantilla, los recursos se crean automáticamente, incluido un repositorio de código fuente que incluya código de muestra. Puede usar este repositorio y este código de ejemplo para aprender a:
-
ver los repositorios de código fuente de un proyecto y explorar su contenido;
-
crear un entorno de desarrollo con una nueva ramificación en la que se pueda trabajar con el código;
-
cambiar un archivo y confirmar e insertar los cambios;
-
crear una solicitud de extracción y revisar los cambios de código con otros miembros del proyecto;
-
observar el flujo de trabajo del proyecto para crear y probar automáticamente los cambios en la ramificación de origen de la solicitud de extracción;
-
combinar los cambios de la ramificación de origen con la de destino y cerrar la solicitud de extracción;
-
observar cómo se compilan e implementan automáticamente los cambios combinados.
Para aprovechar al máximo este tutorial, puede invitar a otras personas a su proyecto para que puedan colaborar en una solicitud de extracción. También puedes explorar otras funciones CodeCatalyst, como la creación de incidencias y su asociación a una solicitud de extracción, o la configuración de las notificaciones y la recepción de alertas cuando se ejecute el flujo de trabajo asociado. Para una exploración completa de CodeCatalyst, consulteTutoriales de introducción.
Creación de un proyecto con un esquema
Crear un proyecto es el primer paso para la colaboración. Puede usar un esquema para crear su proyecto, lo que también creará un repositorio de código fuente con código de muestra y un flujo de trabajo que compilará e implementará automáticamente el código cuando lo cambie. En este tutorial, le mostraremos un proyecto creado con el esquema de Aplicación de una sola página, pero puede seguir los procedimientos de cualquier proyecto con un repositorio de código fuente. Asegúrese de elegir un rol de IAM o de añadir un rol de IAM si no lo tiene como parte de la creación del proyecto. Le recomendamos que utilice el CodeCatalystWorkflowDevelopmentRole-spaceNamerol de servicio para este proyecto.
Si ya tiene un proyecto, puede avanzar hasta el paso Visualización de los repositorios de un proyecto.
nota
Solo los usuarios con el rol de administrador del espacio o usuario avanzado pueden crear proyectos en él CodeCatalyst. Si no tiene este rol y necesita trabajar en un proyecto para este tutorial, pídale a alguien que tenga uno de estos roles que cree un proyecto por usted y lo añada al proyecto creado. Para obtener más información, consulte Concesión de acceso en los roles de usuario.
Creación de un proyecto con un esquema
-
En la CodeCatalyst consola, navega hasta el espacio en el que quieres crear un proyecto.
-
En el panel de control del espacio, seleccione Crear proyecto.
-
Seleccione Empezar con un esquema.
sugerencia
Puede elegir añadir un esquema proporcionando a Amazon Q los requisitos de su proyecto para que Amazon Q le sugiera un esquema. Para obtener más información, consulte Uso de Amazon Q para elegir un esquema al crear un proyecto o al añadir funciones y Prácticas recomendadas al utilizar Amazon Q para crear proyectos o añadir funciones con esquemas. Esta característica solo está disponible en la región Oeste de EE. UU. (Oregón).
Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio. Para obtener más información, consulte Managing generative AI features.
-
En la pestaña de CodeCatalyst planos o esquemas de espacio, elija un plano y, a continuación, elija Siguiente.
-
En Asignar nombre al proyecto, introduzca el nombre que desea asignar al proyecto y los nombres de los recursos asociados. El nombre debe ser único dentro de su espacio.
-
(Opcional) De forma predeterminada, el código fuente creado por el plano se almacena en un repositorio. CodeCatalyst También puede elegir almacenar el código fuente del esquema en un repositorio de terceros. Para obtener más información, consulte Añada funcionalidad a los proyectos con extensiones en CodeCatalyst.
importante
CodeCatalyst no admite la detección de cambios en la rama predeterminada de los repositorios enlazados. Para cambiar la rama predeterminada de un repositorio vinculado, primero debes desvincularlo CodeCatalyst, cambiar la rama predeterminada y volver a vincularlo. Para obtener más información, consulte Vincular GitHub repositorios, repositorios de Bitbucket, repositorios de GitLab proyectos y proyectos de Jira en CodeCatalyst.
Como práctica recomendada, asegúrese siempre de tener la última versión de la extensión antes de vincular un repositorio.
Realice una de las siguientes acciones en función del proveedor de repositorios de terceros que desee utilizar:
-
GitHub repositorios: Conecta una GitHub cuenta.
Seleccione el menú desplegable Avanzado, elija GitHub el proveedor del repositorio y, a continuación, elija la GitHub cuenta en la que desee almacenar el código fuente creado por el blueprint.
nota
Si vas a conectar una GitHub cuenta, debes crear una conexión personal para establecer un mapeo de identidad entre tu CodeCatalyst identidad y tu GitHub identidad. Para obtener más información, consulte Conexiones personales y Acceder a GitHub los recursos con conexiones personales.
-
Repositorios de Bitbucket: conéctese a un espacio de trabajo de Bitbucket.
Seleccione el menú desplegable Avanzado, elija Bitbucket como proveedor del repositorio y, a continuación, elija el espacio de trabajo de Bitbucket en el que desee almacenar el código fuente creado por el esquema.
-
GitLab repositorios: Conecta a un GitLab usuario.
Seleccione el menú desplegable Avanzado, elija GitLab el proveedor del repositorio y, a continuación, elija el GitLab usuario en el que desee almacenar el código fuente creado por el blueprint.
-
-
En Recursos del proyecto, configure los parámetros del esquema. Según el esquema, es posible que tenga la opción de asignar un nombre al repositorio de código fuente.
-
(Opcional) Para ver los archivos de definición con actualizaciones basadas en las selecciones de parámetros del proyecto que haya realizado, seleccione Ver código o Ver flujo de trabajo en Generar vista previa de proyecto.
-
(Opcional) Seleccione Ver detalles en la tarjeta del esquema para ver detalles específicos del esquema, como una descripción general de su arquitectura, las conexiones y los permisos necesarios y el tipo de recursos que crea.
-
Elija Crear proyecto.
La página de información general del proyecto se abre en cuanto se crea un proyecto o se acepta una invitación para participar en él y se completa el proceso de inicio de sesión. La página de información general de un proyecto nuevo no contiene incidencias pendientes ni solicitudes de extracción. Opcionalmente, puede elegir crear una incidencia y asignársela. También puede optar por invitar a otra persona al proyecto. Para obtener más información, consulte Crear un problema en CodeCatalyst y Invitación a un usuario a un proyecto.
Visualización de los repositorios de un proyecto
Como miembro de un proyecto, puede ver los repositorios de código fuente del proyecto. También puede decidir crear repositorios adicionales. Si alguien con el rol de administrador de Space ha instalado y configurado GitHub los repositorios, los repositorios de Bitbucket o la extensión de GitLab repositorios, también puedes añadir enlaces a repositorios de terceros en GitHub las cuentas, los espacios de trabajo de Bitbucket o los usuarios configurados para la extensión. GitLab Para obtener más información, consulte Creación de un repositorio de código fuente y Inicio rápido: instalar extensiones, conectar proveedores y vincular recursos en CodeCatalyst.
nota
En el caso de los proyectos creados con el esquema de aplicación de una sola página, el nombre predeterminado del repositorio de origen que contiene el código de ejemplo es. spa-app
Navegación a los repositorios de código fuente de un proyecto
-
Vaya al proyecto y lleve a cabo una de las siguientes acciones:
En la página de resumen del proyecto, elija el repositorio que desee de la lista y, a continuación, elija Ver repositorio.
-
En el panel de navegación, elija Código y, a continuación, elija Repositorios de origen. En Repositorios de origen, elija el nombre del repositorio en la lista. Puede filtrar la lista de repositorios escribiendo una parte del nombre en la barra de filtros.
-
En la página de inicio del repositorio, consulte el contenido del repositorio y la información sobre los recursos asociados, como el número de solicitudes de extracción y los flujos de trabajo. De forma predeterminada, se muestra el contenido de la ramificación predeterminada. Para cambiar la vista, seleccione otra ramificación en la lista desplegable.
La página de información general del repositorio incluye información sobre los flujos de trabajo y las solicitudes de extracción configurados para las ramificaciones de este repositorio y sus archivos. Si acaba de crear el proyecto, los flujos de trabajo iniciales para compilar, probar e implementar el código seguirán ejecutándose, ya que tardan unos minutos en completarse. Puede ver los flujos de trabajo relacionados y su estado seleccionando el número que aparece debajo de Flujos de trabajo relacionados, pero esto abrirá la página Flujos de trabajo en CI/CD. Para ver este tutorial, manténgase en la página de información general y explore el código en el repositorio. El contenido del archivo README.md se muestra en esta página, debajo de los archivos del repositorio. En Archivos, se muestra el contenido de la ramificación predeterminada. Puede cambiar la vista del archivo para mostrar el contenido de otra ramificación, si tiene una. La carpeta .codecatalyst contiene el código utilizado para otras partes del proyecto, como los archivos YAML del flujo de trabajo.
Para ver el contenido de las carpetas, seleccione la flecha que aparece junto al nombre de la carpeta para expandirla. Por ejemplo, elija la flecha situada junto a .src para ver los archivos de la aplicación web de una sola página contenida en esa carpeta. Para ver el contenido de un archivo, elíjalo en la lista. Se abrirá Ver archivos y podrá examinar el contenido de varios archivos. También puede editar archivos individuales en la consola, pero para editar varios archivos, deberá crear un entorno de desarrollo.
Creación de un entorno de desarrollo
Puedes añadir y cambiar archivos en un repositorio de origen de la CodeCatalyst consola de Amazon. Sin embargo, para trabajar de forma eficaz con varios archivos y ramificaciones, le recomendamos utilizar un entorno de desarrollo o clonar el repositorio en su equipo local. En este tutorial, crearemos un entorno AWS Cloud9 de desarrollo con una rama llamadadevelop. Puede elegir un nombre de ramificación diferente, pero si le pone a la ramificación el nombre develop, se ejecutará automáticamente un flujo de trabajo para compilar y probar el código cuando cree una solicitud de extracción más adelante en este tutorial.
sugerencia
Si decide clonar un repositorio de forma local en lugar de utilizar un entorno de desarrollo o de forma adicional a él, asegúrese de tener Git en su equipo local o de que su IDE incluya Git. Para obtener más información, consulte Configuración para trabajar con repositorios de código fuente.
Creación de un entorno de desarrollo con una nueva ramificación
Abre la CodeCatalyst consola en https://codecatalyst.aws/
. Vaya al proyecto donde quiera crear un entorno de desarrollo.
Seleccione el nombre del repositorio de la lista de repositorios de código fuente para el proyecto. Si lo prefiere, en el panel de navegación, seleccione Código y Repositorios de origen y elija el repositorio para el que quiera crear un entorno de desarrollo.
En la página de inicio del repositorio, seleccione Crear entorno de desarrollo.
Seleccione un IDE compatible en el menú desplegable. Para obtener más información, consulta Entornos de desarrollo integrados compatibles.
Elija el repositorio que desea clonar, elija Trabajar en una nueva ramificación, introduzca el nombre de la ramificación en el campo Nombre de ramificación, y elija una ramificación a partir de la cual crear la ramificación nueva en el menú desplegable Crear ramificación desde.
Si lo desea, añada un alias para el entorno de desarrollo.
Si lo desea, elija el botón de editar Configuración del entorno de desarrollo para editar la configuración informática, de almacenamiento o el tiempo de espera del entorno de desarrollo.
Seleccione Crear. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo mostrará Iniciando y la columna de estado mostrará Ejecutando una vez se haya creado el entorno de desarrollo. Se abrirá una nueva pestaña con su entorno de desarrollo en el IDE que elija. Puede editar el código y confirmar y enviar los cambios.
Una vez que haya creado el entorno de desarrollo, puede editar los archivos, confirmar los cambios y enviarlos a la ramificación test. En este tutorial, editará el contenido entre las etiquetas <p> del archivo App.tsx en la carpeta src para cambiar el texto que se muestra en la página web. Confirme y presione el cambio y, a continuación, regrese a la CodeCatalyst pestaña.
Para realizar e impulsar un cambio desde un entorno AWS Cloud9 de desarrollo
-
En AWS Cloud9, expande el menú de navegación lateral para buscar los archivos. Expanda
srcy abraApp.tsx. -
Realice un cambio en el texto dentro de las etiquetas
<p>. -
Guarde el archivo y después confirme e inserte los cambios mediante el menú de Git. Como alternativa, en la ventana del terminal, confirme e inserte los cambios con los comandos git commit y git push.
git commit -am "Making an example change" git pushsugerencia
Es posible que tenga que cambiar los directorios del terminal al directorio del repositorio de Git para poder ejecutar correctamente los comandos de Git.
Creación de una solicitud de extracción
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 este tutorial, crearás una solicitud de extracción para revisar los cambios que has realizado en la test sucursal en comparación con los de la sucursal principal. Al crear una solicitud de extracción en un proyecto creado con una plantilla, también se iniciarán los flujos de trabajo asociados, si los hubiera.
Creación de una solicitud de extracción
-
Vaya a su proyecto.
-
Realice una de las siguientes acciones:
-
En el panel de navegación, seleccione Código, seleccione Solicitudes de extracción y seleccione Crear solicitud de extracción.
-
En la página de inicio del repositorio, seleccione Más y, después, seleccione Crear solicitud de extracción.
-
En la página del proyecto, seleccione Crear solicitud de extracción.
-
-
En Repositorio de origen, asegúrese de que el repositorio de código fuente especificado sea el que contenga el código confirmado. Esta opción solo aparece si no ha creado la solicitud de extracción desde la página principal del repositorio.
-
En Ramificación de destino, elija la ramificación en la que quiera combinar el código después de revisarlo.
-
En Ramificación de origen, elija la ramificación que contenga el código confirmado.
-
En Título de la solicitud de extracción, introduzca un título que ayude a otros usuarios a entender qué es lo que hay que revisar y por qué.
-
(Opcional) En Descripción de la solicitud de extracción, proporcione información, como un enlace a las incidencias o una descripción de los cambios.
sugerencia
Puedes elegir Escribir una descripción para que yo genere CodeCatalyst automáticamente una descripción de los cambios incluidos en la solicitud de extracción. Puede realizar cambios en la descripción generada automáticamente después de añadirla a la solicitud de extracción.
Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio y no estén disponibles para las solicitudes de extracción en los repositorios vinculados. Para obtener más información, consulte Managing generative AI features.
-
(Opcional) En Problemas, seleccione Vincular problemas y, a continuación, elija un problema de la lista o introduzca su ID. Para desvincular un problema, seleccione el icono de desvinculación.
-
(Opcional) En Revisores obligatorios, seleccione Agregar revisores obligatorios. Elija en la lista miembros del proyecto para añadirlos. Los revisores obligatorios deben aprobar los cambios antes de poder combinar la solicitud de extracción en la ramificación de destino.
nota
No es posible agregar un revisor como revisor obligatorio y como revisor opcional. No es posible añadirse a uno mismo como revisor.
-
(Opcional) En Revisores opcionales, seleccione Agregar revisores opcionales. Elija en la lista miembros del proyecto para añadirlos. No es obligatorio que los revisores opcionales aprueben los cambios para poder combinar la solicitud de extracción en la ramificación de destino.
-
Revise las diferencias entre las ramificaciones. La diferencia que se muestra en una solicitud de extracción consiste en los cambios entre la revisión en la ramificación de origen y la base de combinación, que es la confirmación del encabezado en la ramificación de destino en el momento en que se creó la solicitud de extracción. Si no se muestra ningún cambio, es posible que las ramificaciones sean idénticas o que haya elegido la misma ramificación tanto para el origen como para el destino.
-
Cuando tenga claro que la solicitud de extracción contiene el código y los cambios que desea revisar, elija Crear.
nota
Una vez creada la solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a recursos, como archivos, utilizando el signo @ seguido del nombre del archivo.
Para ver la información sobre los flujos de trabajo asociados iniciados con la creación de esta solicitud de extracción, seleccione Información general y después revise la información en el área de Detalles de la solicitud de extracción, bajo Ejecuciones del flujo de trabajo. Para ver la ejecución del flujo de trabajo, selecciónela.
sugerencia
Si ha asignado a la ramificación un nombre diferente a develop, no se ejecutará automáticamente un flujo de trabajo para compilar y probar los cambios. Si quieres configurarlo, edita el archivo YAML del onPullRequestBuildAndTestflujo de trabajo. Para obtener más información, consulte Creación de un flujo de trabajo.
Puede comentar esta solicitud de extracción y pedir a otros miembros del proyecto que la comenten. También puede elegir agregar o cambiar los revisores opcionales u obligatorios. Puede optar por realizar más cambios en la ramificación de origen del repositorio y ver cómo esos cambios confirmados crean revisiones para la solicitud de extracción. Para obtener más información, consulte Revisión de una solicitud de extracción, Actualización de una solicitud de extracción, Revisar el código con solicitudes de cambios en Amazon CodeCatalyst y Visualización del estado y los detalles de la ejecución de un flujo de trabajo.
Combinación de una solicitud de extracción
Una vez que se haya revisado una solicitud de extracción y haya recibido la aprobación de los revisores necesarios, puedes fusionar su rama de origen con la de destino en la CodeCatalyst consola. Al combinar una solicitud de extracción, también se iniciarán los cambios en todos los flujos de trabajo asociados en la ramificación de destino. En este tutorial, fusionarás la rama de prueba con la principal, lo que iniciará una ejecución del onPushToMainDeployPipelineflujo de trabajo.
Combinación de una solicitud de extracción (consola)
-
En Solicitudes de extracción, seleccione la solicitud de extracción que creó en el paso anterior. En la solicitud de extracción, elija Combinar.
-
Elija entre las estrategias de combinación disponibles para la solicitud de extracción. Puede seleccionar o deseleccionar la opción para eliminar la ramificación de origen después de combinar la solicitud de extracción; después, seleccione Combinar. Una vez completada la combinación, el estado de la solicitud de extracción cambia a Combinado y deja de aparecer en la vista predeterminada de solicitudes de extracción. La vista predeterminada muestra las solicitudes de extracción con el estado Abierto. Las solicitudes de extracción combinadas se siguen pudiendo ver, pero no se pueden aprobar ni cambiar de estado.
nota
Si el botón Combinar no está activo o ves la etiqueta No se puede combinar, significa que un revisor obligatorio aún no ha aprobado la solicitud de extracción o la solicitud de extracción no se puede fusionar en la CodeCatalyst consola. Si hay algún revisor que no ha aprobado la solicitud de extracción, aparecerá el icono de reloj en Información general, en el área Detalles de la solicitud de extracción. Si todos los revisores obligatorios han aprobado la solicitud de extracción, pero el botón Combinar sigue inactivo, es posible que haya un conflicto de combinación o que haya superado la cuota de almacenamiento para el espacio. Puedes resolver los conflictos de fusión para la rama de destino en un entorno de desarrollo, insertar los cambios y, a continuación, fusionar la solicitud de extracción, o puedes resolver los conflictos y fusionar localmente y, a continuación, enviar la confirmación que contiene la fusión a. CodeCatalyst Para obtener más información, consulte Combinación de una solicitud de extracción (Git) y la documentación de Git.
Visualización del código implementado
Ahora es el momento de ver el código implementado originalmente que estaba en la ramificación predeterminada y los cambios combinados una vez que se hayan creado, probado e implementado automáticamente. Para ello, puede volver a la página de información general del repositorio y elegir el número situado junto al icono de los flujos de trabajo relacionados o, en el panel de navegación, seleccionar CI/CD y, a continuación, Flujos de trabajo.
Visualización del código implementado
-
En Flujos de trabajo, en
onPushToMainDeployPipeline, expanda Ejecuciones recientes.nota
Este es el nombre predeterminado del flujo de trabajo para los proyectos creados con el esquema de aplicación de una sola página.
-
La ejecución más reciente es la que se inició con la confirmación de la solicitud de extracción combinada con la ramificación
mainy es probable que muestre el estado En curso. Seleccione una ejecución completada correctamente de la lista para abrir los detalles de esa ejecución. -
Seleccione Variables. Copie el valor de AppURL. Esta es la URL de la aplicación web de una sola página implementada. Abra una nueva pestaña del navegador y pegue el valor para ver el código compilado e implementado. Deje la pestaña abierta.
-
Vuelva a la lista de ejecuciones del flujo de trabajo y espere a que se complete la ejecución más reciente. Cuando lo haga, regrese a la pestaña que abrió para ver la aplicación web y actualizar el navegador. Debería ver los cambios que haya realizado en la solicitud de extracción combinada.
Limpieza de recursos
Una vez que haya explorado cómo trabajar con un repositorio de código fuente y una solicitud de extracción, es posible que quiera eliminar los recursos que no necesite. No puede eliminar las solicitudes de extracción, pero puede cerrarlas. Puede eliminar cualquier ramificación que haya creado.
Si ya no necesita el repositorio de código fuente o el proyecto, también puede eliminar esos recursos. Para obtener más información, consulte Eliminación de un repositorio de código fuente y Eliminación de un proyecto.
