Conceptos de GitLab Duo - Amazon Q Developer
Configuración de GitLab Duo con Amazon QIncorporación con recursos de AWS y políticas de permisosAcciones rápidas de GitLab

Conceptos de GitLab Duo

Estos son algunos conceptos y términos que debe conocer al usar GitLab Duo con Amazon Q.

Configuración de GitLab Duo con Amazon Q

Antes de poder utilizar las capacidades de inteligencia artificial (IA) de Amazon Q en GitLab Duo, debe cumplir los requisitos previos y crear recursos de AWS. Para obtener más información, consulte Set up GitLab Duo with Amazon Q en la Documentación de GitLab.

Incorporación con recursos de AWS y políticas de permisos

Como parte del proceso de incorporación de GitLab Duo, debe crear un perfil de Amazon Q Developer a través de la consola de Amazon Q Developer. El perfil le permite crear ajustes de personalización y control para todos o un subconjunto de los usuarios de su proveedor de identidad. Tras crear un perfil, necesita un proveedor de identidades (IdP) de OpenID Connect (OIDC), así como un rol de servicio de IAM, para establecer una relación de confianza entre GitLab Duo y su cuenta de AWS. Para obtener información sobre cómo crear los recursos necesarios y configurar GitLab Duo con Amazon Q, consulte Set up GitLab Duo with Amazon Q en la Documentación de GitLab.

Cuando se crea el nuevo rol de IAM, también se crea la política de confianza requerida con los permisos necesarios. Una política de confianza de rol es una política basada en recursos requerida que se adjunta a un rol en IAM.

Debe añadir una política de permisos que le permita conectarse con Amazon Q y utilizar las características en la integración de GitLab Duo con Amazon Q. La política debe añadirse al crear el rol de IAM. Para obtener más información sobre los permisos que proporciona la política de permisos, consulte GitLabDuoWithAmazonQPermissionsPolicy.

Si lo prefiere, puede crear una política insertada y añadir los permisos necesarios. Puede optar por crear una política insertada si desea personalizar el control de acceso. Para obtener más información, consulte la sección Políticas administradas y políticas insertadas y Políticas y permisos en AWS Identity and Access Management en la Guía del usuario de IAM.

Política de confianza

JSON
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "sts:AssumeRoleWithWebIdentity",
            "Principal": {
                "Federated": "arn:aws:iam::111122223333:oidc-provider/auth.token.gitlab.com/cc/oidc/{{Instance_ID}}"
            },
            "Condition": {
                "StringEquals": {
                    "auth.token.gitlab.com/cc/oidc/{{Instance_ID}}:aud": "gitlab-cc-{{Instance_ID}}"
                }
            }
        }
    ]
}

Política de permisos

JSON
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GitLabDuoUsagePermissions",
      "Effect": "Allow",
      "Action": [
        "q:SendEvent",
        "q:CreateAuthGrant",
        "q:UpdateAuthGrant",
        "q:GenerateCodeRecommendations",
        "q:SendMessage",
        "q:ListPlugins",
        "q:VerifyOAuthAppConnection"
      ],
      "Resource": "*"
    },
    {
      "Sid": "GitLabDuoManagementPermissions",
      "Effect": "Allow",
      "Action": [
        "q:CreateOAuthAppConnection",
        "q:DeleteOAuthAppConnection"
      ],
      "Resource": "*"
    },
    {
      "Sid": "GitLabDuoPluginPermissions",
      "Effect": "Allow",
      "Action": [
        "q:CreatePlugin",
        "q:DeletePlugin",
        "q:GetPlugin"
      ],
      "Resource": "arn:aws:qdeveloper:*:*:plugin/GitLabDuoWithAmazonQ/*"
    }
  ]
}

Si lo desea, también puede usar claves administradas por el cliente (CMK) para cifrar sus recursos si desea tener un control total sobre el ciclo de vida y el uso de su clave. La clave de condición kms:ViaService para limitar quién puede usar la CMK para cifrar y descifrar contenido. Para obtener más información, consulte Administración del acceso a Amazon Q Developer para la integración de terceros.

Acciones rápidas de GitLab

Cuando se invocan, las acciones rápidas realizan tareas por usted en problemas de GitLab y combinan solicitudes. Para obtener información sobre cómo invocar acciones rápidas en GitLab, consulte la Documentación de GitLab.

Combinar la generación de solicitudes y la iteración

  • /q dev: permite pasar de una idea de alto nivel plasmada en un problema de GitLab a hacer que Amazon Q genere una solicitud de combinación lista para su revisión con la implementación de código propuesta. Esto ayuda a agilizar el proceso de convertir los conceptos en código funcional. La solicitud de combinación se crea en una nueva ramificación y Amazon Q asigna al creador del problema como revisor de la solicitud de combinación. También se le proporciona un resumen de la solicitud de combinación. Para obtener más información, consulte Turn an idea into a merge request.

  • /q dev (revisar): permite iterar sobre la implementación de código propuesta proporcionada por Amazon Q, en lugar de empezar de nuevo a partir de un problema. Amazon Q revisa sus comentarios y actualiza el código que se generó originalmente. También recibirá mensajes de confirmación para cada cambio que se realice. La descripción que sigue a cada iteración se actualiza y se añade a la iteración un comentario que describe la valoración. A continuación, puede revisar y combinar las sugerencias con su código. Para obtener más información, consulte Make code changes based on feedback.

Transformación de código

  • /q transform: permite iniciar el proceso de actualización del proyecto Java Maven 8 o Java Maven 11 a Java Maven 17. A partir de un problema de GitLab, Amazon Q analiza el código para determinar las actualizaciones o modernizaciones de Java necesarias, actualiza el problema, abre automáticamente una nueva solicitud de fusión con los cambios propuestos y asigna al creador del problema como revisor. Necesita una configuración de ejecutor de GitLab para compilar y debe personalizarse para la transformación del código. Para obtener más información, consulte Personalización de una canalización de CI/CD para la transformación de código y Upgrade Java.

    nota

    Es necesario identificar la versión de origen de un proyecto de Maven antes de poder transformar el código, por lo que la configuración del compilador debe establecerse dentro de un archivo pom.xml. Por lo tanto, su archivo pom.xml debe tener un origen y destino.

Generación de pruebas unitarias

  • /q test: permite generar pruebas unitarias para las nuevas líneas de código fuente añadidas en su solicitud de combinación. Comentarios de Amazon Q con sugerencias de pruebas unitarias que se pueden añadir al archivo de prueba. Puede aplicar las pruebas generadas de una vez o revisar cada prueba individualmente antes de aplicarla. Si no se encuentra un archivo de prueba en la solicitud de combinación, Amazon Q proporciona las pruebas unitarias que puede añadir manualmente a un archivo de prueba. Para obtener más información, consulte Create test coverage.

Revisión de código

  • /q review: permite iniciar una revisión de una solicitud de combinación en GitLab Duo con Amazon Q. Se inicia una revisión automática del código para las nuevas solicitudes de combinación. Como administrador de GitLab, también puede configurar Amazon Q para desactivar las revisiones automáticas. Las revisiones de código automatizadas identifican y solucionan posibles problemas a medida que Amazon Q genera y sugiere correcciones de código para su solicitud de combinación. Proporcionan comprobaciones de calidad, analizan problemas, errores lógicos, antipatrones, duplicación de código y mucho más.

    Amazon Q ofrece un análisis de código con comentarios y cada comentario proporciona un resultado independiente. Esta acción rápida está disponible en todos los idiomas. Las revisiones automáticas del código se inician cuando abre nuevas solicitudes de combinación o vuelve a abrir las que estaban cerradas anteriormente. Sin embargo, las revisiones automáticas del código no se activarán por las confirmaciones posteriores realizadas en una solicitud de combinación existente. Puede activar manualmente una revisión del código mediante la acción rápida /q review.

    Puede configurar las revisiones de código para que se ejecuten automáticamente en cada nueva solicitud de combinación dentro de su instancia o grupo de GitLab. Para obtener más información, consulte Review a merge request.

Sesión de chat en UI de web e IDE

  • El chat y las sugerencias de código de GitLab Duo funcionan con Amazon Q para proporcionar compatibilidad para la configuración de CI/CD, explicaciones de errores y respuesta a preguntas. Puede usar comandos de barra inclinada en una sesión de chat para invocar las funciones de chat de GitLab Duo con Amazon Q. Para obtener más información, consulte Ask GitLab Duo Chat.