Creación de un proyecto - Amazon CodeCatalyst
Creación de un proyecto vacíoCreación de un proyecto con un repositorio externo vinculadoCreación de un proyecto con un esquemaPrácticas recomendadas al utilizar Amazon Q para crear proyectos o añadir funciones con esquemasPrácticas recomendadas para utilizar esquemas en proyectosAdición de recursos y tareas a los proyectos creados

Amazon CodeCatalyst ya no está disponible para nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cómo migrar de CodeCatalyst.

Creación de un proyecto

Con los proyectos de CodeCatalyst, puede llevar a cabo tareas de desarrollo con repositorios y flujos de trabajo compartidos de integración continua o entrega continua (CI/CD), administrar recursos, hacer un seguimiento de los problemas y añadir usuarios.

Antes de crear un proyecto, debe tener el rol de administrador del espacio o usuario avanzado.

Creación de un proyecto vacío en Amazon CodeCatalyst

Puede crear un proyecto vacío sin recursos y añadir manualmente los recursos que desee más tarde.

Antes de crear un proyecto, debe tener el rol de administrador del espacio o usuario avanzado.

Para crear un proyecto vacío

  1. Vaya al espacio en el que desea crear un proyecto.

  2. En el panel de control del espacio, seleccione Crear proyecto.

  3. Elija Empezar desde cero.

  4. En Asigne un nombre a su proyecto, introduzca el nombre que desea asignar a su proyecto. El nombre debe ser único dentro de su espacio.

  5. Elija Crear proyecto.

Creación de un proyecto con un repositorio externo vinculado

Puede conservar el código fuente del proyecto en el proveedor externo que desee y seguir utilizando todas las características de CodeCatalyst, como los esquemas, la administración del ciclo de vida, los flujos de trabajo, etc. Para ello, puede crear un nuevo proyecto de CodeCatalyst que vincule a un repositorio de GitHub, un repositorio de Bitbucket o un repositorio de proyectos de GitLab. Luego, puede usar el repositorio de código fuente vinculado en el proyecto de CodeCatalyst.

Antes de crear un proyecto de CodeCatalyst, debe tener el rol de administrador del espacio o usuario avanzado. Para obtener más información, consulte Creación de un espacio y Invitación directa a un usuario a un espacio .

Para crear un proyecto en CodeCatalyst que se vincule a un repositorio de código fuente en la cuenta de GitHub, tendrá que completar las siguientes tres tareas:

  1. Instale la extensión Repositorios de GitHub, Repositorios de Bitbucket o Repositorios de GitLab. En un sitio externo, se le pedirá que se conecte a CodeCatalyst y que le conceda acceso al repositorio, lo que se hace durante el siguiente paso.

    importante

    Para instalar la extensión Repositorios de GitHub, Repositorios de Bitbucket o Repositorios de GitLab en el espacio de CodeCatalyst, debe iniciar sesión con una cuenta que tenga el rol de administrador del espacio en ese espacio.

  2. Conecte la cuenta de GitHub, el espacio de trabajo de Bitbucket, el usuario de GitLab a CodeCatalyst.

    importante

    Para conectar la cuenta de GitHub, el espacio de trabajo de Bitbucket o el usuario de GitLab a un espacio de CodeCatalyst, deberá tener el rol de administrador en el origen externo y el rol de administrador del espacio en CodeCatalyst.

    importante

    Tras instalar una extensión de repositorio, cualquier repositorio que vincule a CodeCatalyst tendrá el código indexado y almacenado en CodeCatalyst. Esto permitirá hacer búsquedas en el código desde CodeCatalyst. Para comprender mejor cómo funciona la protección de datos del código al utilizar repositorios vinculados en CodeCatalyst, consulte Data protection en la Guía del usuario de Amazon CodeCatalyst.

  3. Cree un proyecto de CodeCatalyst vinculado al repositorio de GitHub, el repositorio de Bitbucket o el repositorio de proyectos de GitLab.

    importante

    Puede vincular un repositorio de GitHub, un repositorio de Bitbucket o un repositorio de proyectos de GitLab como colaborador, pero para desvincular un repositorio externo debe ser administrador del espacio o administrador del proyecto. Para obtener más información, consulte Desvinculación de repositorios de GitHub, repositorios de Bitbucket, repositorios de proyectos de GitLab y proyectos de Jira en CodeCatalyst.

    importante

    CodeCatalyst no admite la detección de cambios en la ramificación predeterminada de los repositorios vinculados. Para cambiar la ramificación predeterminada de un repositorio vinculado, primero debe desvincularlo de CodeCatalyst, cambiar la ramificación predeterminada y volver a vincularla. Para obtener más información, consulte Vinculación de repositorios de GitHub, repositorios de Bitbucket, repositorios de proyectos de GitLab 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.

    nota

    • Un repositorio de GitHub, un repositorio de Bitbucket o un repositorio de proyectos de GitLab solo se pueden vincular a un proyecto de CodeCatalyst en un espacio.

    • En los proyectos de CodeCatalyst, no puede usar repositorios de GitHub, repositorios de Bitbucket ni repositorios de proyectos de GitLab que estén vacíos o archivados.

    • No puede vincular un repositorio de GitHub, un repositorio de Bitbucket ni un repositorio de proyectos de GitLab que tengan el mismo nombre que un repositorio de un proyectos de CodeCatalyst.

    • La extensión Repositorios de GitHub no es compatible con los repositorios de GitHub Enterprise Server.

    • La extensión Repositorios de Bitbucket no es compatible con los repositorios de Bitbucket Data Center.

    • La extensión Repositorios de GitLab no es compatible con los repositorios de proyectos autoadministrados de GitLab.

    • Con los repositorios vinculados, no puede usar las características Escribir descripción automáticamente ni Resumir comentarios. Estas características solo están disponibles en las solicitudes de extracción de CodeCatalyst.

Para obtener más información, consulte Adición de funcionalidad a proyectos mediante extensiones en CodeCatalyst.

Instalación de una extensión externa

  1. Vaya al espacio en el que desea crear un proyecto.

  2. En el panel de control del espacio, seleccione Crear proyecto.

  3. Seleccione Traer mi propio código.

  4. En Vincular repositorio existente, seleccione Repositorios de GitHub, Repositorios de Bitbucket o Repositorios de GitLab, en función del proveedor de repositorios externo que quiera usar. Se le solicitará que conecte la cuenta de GitHub, el espacio de trabajo de Bitbucket o la cuenta de GitLab si aún no lo ha hecho. Si la extensión externa que elija aún no está instalada, aparecerá un mensaje donde se le pedirá que haga la instalación.

  5. Si se le solicita, seleccione Instalar. Revise los permisos que requiere la extensión y, si quiere continuar, seleccione Instalar de nuevo.

Tras instalar la extensión externa, el siguiente paso consiste en conectar la cuenta de GitHub, el espacio de trabajo de Bitbucket o el usuario de GitLab al espacio de CodeCatalyst.

Conexión a CodeCatalyst de una cuenta de GitHub, un espacio de trabajo de Bitbucket o un usuario de GitLab

En función de la extensión externa que desee configurar, lleve a cabo una de las siguientes acciones:

  • Repositorios de GitHub: conéctese a una cuenta de GitHub.

    1. Elija Conectar cuenta de GitHub para ir al sitio externo de GitHub.

    2. Inicie sesión en su cuenta de GitHub con las credenciales correspondientes y seleccione la cuenta en la que desee instalar Amazon CodeCatalyst.

      sugerencia

      Si ya había conectado una cuenta de GitHub al espacio, no se le pedirá que vuelva a proporcionar autorización. En lugar de eso, aparecerá un cuadro de diálogo en el que se le preguntará dónde desea instalar la extensión, si participa como miembro o colaborador en más de un espacio de GitHub, o la página de configuración de la aplicación de Amazon CodeCatalyst, si solo pertenece a un espacio de GitHub. Configure la aplicación de acuerdo con el acceso al repositorio que desee permitir; luego, seleccione Guardar. Si el botón Guardar no está activo, haga algún cambio en la configuración e inténtelo de nuevo.

    3. Elija si quiere permitir que CodeCatalyst acceda a todos los repositorios actuales y futuros o seleccione los repositorios de GitHub específicos que quiera usar en CodeCatalyst. La opción predeterminada es incluir todos los repositorios de GitHub en la cuenta de GitHub, lo que incluye los repositorios futuros a los que CodeCatalyst accederá.

    4. Revise los permisos otorgados a CodeCatalyst y, a continuación, seleccione Instalar.

    Tras conectar la cuenta de GitHub a CodeCatalyst, se le llevará a la página de detalles de la extensión Repositorios de GitHub, donde podrá ver y administrar las cuentas de GitHub conectadas y los repositorios de GitHub vinculados.

  • Repositorios de Bitbucket: conéctese a un espacio de trabajo de Bitbucket.

    1. Seleccione Conectar espacio de trabajo de Bitbucket para ir al sitio externo de Bitbucket.

    2. Inicie sesión en su espacio de trabajo de Bitbucket con las credenciales correspondientes y revise los permisos otorgados a CodeCatalyst.

    3. En el menú desplegable Autorizar para el espacio de trabajo, seleccione el espacio de trabajo de Bitbucket al que desea que pueda acceder CodeCatalyst y, a continuación, seleccione Conceder acceso.

      sugerencia

      Si ya había conectado un espacio de trabajo de Bitbucket al espacio, no se le pedirá que vuelva a proporcionar autorización. En lugar de eso, aparecerá un cuadro de diálogo en el que se le preguntará dónde desea instalar la extensión, si participa como miembro o colaborador en más de un espacio de trabajo de Bitbucket o la página de configuración de la aplicación de Amazon CodeCatalyst, si solo pertenece a un espacio de trabajo de Bitbucket. Configure la aplicación para permitir el acceso al espacio de trabajo que desee y, a continuación, seleccione Conceder acceso. Si el botón Conceder acceso no está activo, haga algún cambio en la configuración e inténtelo de nuevo.

    Tras conectar el espacio de trabajo de Bitbucket a CodeCatalyst, se le llevará a la página de detalles de la extensión Repositorios de Bitbucket, donde podrá ver y administrar los espacios de trabajo de Bitbucket conectados y los repositorios de Bitbucket vinculados.

  • Repositorios de GitLab: conéctese a un usuario de GitLab.

    1. Seleccione Conectar usuario de GitLab para ir al sitio externo de GitLab.

    2. Inicie sesión en su usuario de GitLab con las credenciales correspondientes y revise los permisos otorgados a CodeCatalyst.

      sugerencia

      Si ya había conectado a un usuario de GitLab al espacio, no se le pedirá que vuelva a proporcionar autorización. En lugar de eso, se le devolverá a la consola de CodeCatalyst.

    3. Seleccione Autorizar conector de AWS para GitLab.

    Tras conectar al usuario de GitLab a CodeCatalyst, se le llevará a la página de detalles de la extensión Repositorios de GitLab, donde podrá ver y administrar al usuario de GitLab conectado y los repositorios de proyectos de GitLab vinculados.

Tras conectar el origen externo a CodeCatalyst, puede vincular los repositorios externos a los proyectos de CodeCatalyst.

Para crear su proyecto

  1. En la página Crear proyecto, elija la cuenta de GitHub que haya conectado.

  2. Según el proveedor de repositorios externo que haya conectado, seleccione el menú desplegable de repositorios correspondiente (Repositorios de GitHub, Repositorios de Bitbucket o Repositorios de GitLab) para ver los repositorios externos; luego, elija el repositorio que desee vincular al proyecto.

  3. En el campo de entrada de texto Asignar nombre al proyecto, introduzca el nombre que desea asignar a su proyecto. El nombre debe ser único dentro de su espacio.

  4. Elija Crear proyecto.

Tras instalar la extensión Repositorios de GitHub, Repositorios de Bitbucket o Repositorios de GitLab, tras conectar el proveedor de recursos y tras vincular los repositorios externos al proyecto de CodeCatalyst, podrá usarlo en entornos de desarrollo y flujos de trabajo de CodeCatalyst. También puede usar código generado a partir de un esquema para crear repositorios externos en la cuenta de GitHub, el espacio de trabajo de Bitbucket o el usuario de GitLab conectados. También puede usar los repositorios vinculados con Amazon Q Developer, esquemas, etc. Para obtener más información, consulte Inicio automático de la ejecución de un flujo de trabajo después de eventos en repositorios externos y Creación de un entorno de desarrollo.

Creación de un proyecto con un esquema

Puede aprovisionar todos los recursos del proyecto y el código de muestra con un esquema de proyecto. Para obtener más información sobre los esquemas, consulte Creación de un proyecto integral con esquemas de CodeCatalyst.

Creación de un proyecto con un esquema

  1. En la consola de CodeCatalyst, vaya al espacio donde desee crear un proyecto.

  2. En el panel de control del espacio, seleccione Crear proyecto.

  3. 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.

  4. En la pestaña Esquemas de CodeCatalyst o Esquemas del espacio, seleccione un esquema y luego elija Siguiente.

  5. 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.

  6. (Opcional) De forma predeterminada, el código fuente creado por el esquema se almacena en un repositorio de CodeCatalyst. También puede elegir almacenar el código fuente del esquema en un repositorio de terceros. Para obtener más información, consulte Adición de funcionalidad a proyectos mediante extensiones en CodeCatalyst.

    importante

    CodeCatalyst no admite la detección de cambios en la ramificación predeterminada de los repositorios vinculados. Para cambiar la ramificación predeterminada de un repositorio vinculado, primero debe desvincularlo de CodeCatalyst, cambiar la ramificación predeterminada y volver a vincularla. Para obtener más información, consulte Vinculación de repositorios de GitHub, repositorios de Bitbucket, repositorios de proyectos de GitLab 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:

    • Repositorios de GitHub: conéctese a una cuenta de GitHub.

      Seleccione el menú desplegable Avanzado, elija GitHub como proveedor del repositorio y, a continuación, elija la cuenta de GitHub en la que desee almacenar el código fuente creado por el esquema.

      nota

      Si se conecta a una cuenta de GitHub, deberá crear una conexión personal para establecer una asignación de identidades entre la identidad de CodeCatalyst y la de GitHub. Para obtener más información, consulte Conexiones personales y Acceso a los recursos de GitHub 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.

    • Repositorios de GitLab: conéctese a un usuario de GitLab.

      Seleccione el menú desplegable Avanzado, elija GitLab como proveedor del repositorio y, a continuación, elija el usuario de GitLab en el que desee almacenar el código fuente creado por el esquema.

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

  8. (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.

  9. (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.

  10. Elija Crear proyecto.

Prácticas recomendadas al utilizar Amazon Q para crear proyectos o añadir funciones con esquemas

Cuando crea un proyecto o desea añadir nuevos componentes a un proyecto existente, es posible que no sepa con certeza qué esquema debe utilizar o cómo puede integrar las capacidades. CodeCatalyst incluye la integración con un asistente de IA generativa llamado Amazon Q, que puede analizar los requisitos de su proyecto y sugerir un esquema que se ajuste adecuadamente a sus necesidades.

Puede usar Amazon Q para crear un proyecto con un esquema que cree componentes en función de sus requisitos, o puede usar Amazon Q para añadir un esquema a un proyecto existente. Por ejemplo, a fin de añadir recursos de una aplicación web o una aplicación moderna a un proyecto, especifique los requisitos; luego, los recursos se añadirán con un esquema recomendado. Los problemas para el resto de componentes se pueden crear de forma automática.

Amazon Q también crea problemas para aquellos requisitos que no se pueden cumplir mediante un esquema sugerido. Además, puede asignarle estos problemas a Amazon Q. Si le asigna el problema a Amazon Q, este intentará crear un borrador de solución para que lo repase. Con esta ayuda, su equipo y usted pueden centrar su trabajo en los problemas que requieran su atención, mientras Amazon Q trabaja en una solución para aquellos problemas que usted no puede abordar inmediatamente por falta de recursos.

nota

Con tecnología de Amazon Bedrock: AWS implementa la detección automática de abusos. Como las características Escribir descripción automáticamente, Crear un resumen del contenido, Recomendar tareas, Utilizar Amazon Q para crear o agregar características a un proyecto y Asignar problemas a Amazon Q del agente de Amazon Q Developer para el desarrollo de software están basadas en Amazon Bedrock, los usuarios pueden aprovechar al máximo los controles implementados en Amazon Bedrock para garantizar la protección, la seguridad y el uso responsable de la inteligencia artificial (IA).

A continuación, encontrará algunas prácticas recomendadas que le ayudarán a crear proyectos y añadir esquemas con Amazon Q.

importante

Las características de IA generativa solo están disponibles en la región de Oeste de EE. UU. (Oregón).

  • Use las peticiones predeterminadas que proporciona Amazon Q. Amazon Q funciona mejor cuando elige esquemas a partir de las peticiones proporcionadas.

  • Utilice las opciones de configuración sugeridas por Amazon Q para obtener una vista previa de los esquemas. Elija un esquema para obtener una vista previa del código de muestra y los recursos que se crearán con el esquema.

  • Use un espacio habilitado para Amazon Q. Para crear un proyecto con Amazon Q, o para añadir funcionalidad a un proyecto con esquemas mediante Amazon Q, utilice un espacio que esté habilitado para las características de IA generativa. Para obtener más información, consulte Enabling or disabling generative AI features for a space.

  • Obtenga más información sobre los esquemas recomendados por Amazon Q. Es posible que desee obtener más información sobre el tipo de recursos del proyecto, los códigos de muestra y los componentes creados con un esquema recomendado específico. Para obtener más información sobre los esquemas disponibles en CodeCatalyst, consulte Creación de un proyecto integral con esquemas de CodeCatalyst.

  • Deje que Amazon Q trabaje en los problemas. Deje que sea Amazon Q quien cree los problemas, los asigne y haga un seguimiento de ellos. Para obtener más información, consulte Tutorial: Uso de las características de IA generativa de CodeCatalyst para acelerar el trabajo de desarrollo.

  • Anule la asignación de Amazon Q en aquellos problemas en los que ya no se esté trabajando. Tras completar el ejemplo, anule la asignación de Amazon Q en cualquier problema en el que ya no se esté trabajando. Si Amazon Q ha terminado de trabajar en un problema o no ha podido encontrar una solución, compruebe que haya anulado la asignación de Amazon Q a ese problema, a fin de no llegar a la cuota máxima de características de IA generativa. Para obtener más información, consulte Managing generative AI features y Pricing.

  • Consulte el uso de Amazon Q. Puede ver el uso de las características de IA generativa en el nivel de usuario. Vaya a Mi configuración para administrar las cuotas de IA generativa y ver el uso según el ID de creador o la identidad de inicio de sesión único (SSO). Para obtener más información, consulte Viewing usage of generative AI features in a space.

importante

Las características de IA generativa en CodeCatalyst están sujetas a cuotas. Para obtener más información, consulte Precios de Amazon Q Developer, Enabling or disabling generative AI features for a space y Billing.

Prácticas recomendadas para utilizar esquemas en proyectos

A continuación, encontrará algunas prácticas recomendadas que le ayudarán a crear proyectos con esquemas o a añadir esquemas.

  • Utilice los esquemas proporcionados por CodeCatalyst para crear proyectos o añadir elementos en ellos. Puede utilizar los esquemas para crear un proyecto completo con código fuente y recursos para los desarrolladores. Por ejemplo, el esquema de la aplicación web crea recursos de aplicaciones e infraestructura e implementa una aplicación web. Puede crear un proyecto con un esquema o añadir un esquema personalizado a un proyecto existente. Para obtener más información, consulte Creación de un proyecto con un esquema. Consulte los esquemas en CodeCatalyst para obtener una vista previa del código de muestra y los recursos que se crearán mediante el esquema.

  • Utilice esquemas personalizados diseñados por su organización. Puede usar esquemas personalizados para crear un proyecto completo en su espacio. El esquema personalizado diseñado por su organización puede aportar estandarización y prácticas recomendadas, lo que puede contribuir a reducir los esfuerzos de configuración de un nuevo proyecto. El autor de un esquema personalizado puede ver detalles sobre los proyectos que utilizan dicho esquema en el espacio. La administración del ciclo de vida le permite administrar de forma centralizada el ciclo de desarrollo del software de cada proyecto, y los usuarios de los esquemas pueden utilizar la administración del ciclo de vida para regenerar una base de código a partir de opciones o versiones actualizadas de un esquema. Para obtener más información, consulte El trabajo del autor de esquemas con la administración del ciclo de vida.

  • Añada el rol de desarrollador o los roles de IAM correspondientes a la cuenta de su proyecto. Durante los pasos de creación del proyecto, o después de estos, puede configurar los permisos del esquema seleccionando o creando roles de IAM en una Cuenta de AWS conectada al espacio.

Adición de recursos y tareas a los proyectos creados

Cuando el proyecto esté listo, puede añadir recursos y tareas.