Solución de problemas

En esta página, se muestra cómo resolver problemas con Secure Source Manager.

Mensaje de error cuando se crea un repositorio

Aparece el siguiente error cuando intentas crear un repositorio:

There was an error while loading /repo/create. Try refreshing the page.

Este problema ocurre en los siguientes casos:

  • La API de Secure Source Manager no está habilitada en tu proyecto.
  • No tienes el rol de administrador de repositorios en tu proyecto ni permisos para crear repositorios en la instancia de Secure Source Manager.

Para solucionar este problema, sigue estos pasos:

  • Habilita la API de Secure Source Manager en tu proyecto.
  • Pídele a tu administrador que te otorgue los siguientes roles:
    • Rol de administrador de repo (roles/securesourcemanager.repoAdmin) en tu proyecto
    • Descriptor de acceso a instancias (roles/securesourcemanager.instanceAccessor) en la instancia de Secure Source Manager
    • Creador de repositorios de instancias (roles/securesourcemanager.instanceRepositoryCreator) en la instancia de Secure Source Manager

Consulta Control de acceso con IAM para obtener más detalles.

Mensaje de error cuando se clona un repositorio en una Mac

Aparece el siguiente error cuando intentas clonar un repositorio:

git: 'credential-gcloud.sh' is not a git command.  See 'git --help'.
fatal: Authentication failed for [repo-url]

Este problema ocurre en los siguientes casos:

  • Gcloud CLI se instaló con Homebrew o con otra instalación no estándar.
  • git-credential-gcloud.sh no se agregó a tu PATH.

Para solucionar este problema, sigue estos pasos:

  • Ejecuta source $HOMEBREW_PREFIX/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/path.zsh.inc

  • Ejecuta el siguiente comando para verificar que git-credential-gcloud.sh esté en tu ruta de acceso:

    which git-credential-gcloud.sh

Las solicitudes HTTPS de Git fallan con un error de permiso denegado o no autorizado

Cuando se intentan ejecutar comandos de Git a través de HTTPS, se muestra un mensaje de error de permiso denegado o no autorizado.

Este problema ocurre en uno de los siguientes casos:

  • Falta el auxiliar de autenticación de Secure Source Manager en el archivo de configuración global de Git.
  • Se está usando el almacén de credenciales integrado de Git en lugar de llamar al asistente de autenticación de Secure Source Manager para obtener una credencial nueva.
  • Se está usando un auxiliar de credenciales del sistema en lugar de llamar al auxiliar de autenticación de Secure Source Manager para obtener una credencial nueva.
  • Se usa una versión anterior de Google Cloud CLI cuando se interactúa con repositorios de Secure Source Manager a través de HTTPS. Secure Source Manager requiere la versión 395.0.0 de Google Cloud CLI o una posterior.

Para solucionar este problema, sigue estos pasos:

  1. Ejecuta el siguiente comando para determinar el contenido de tu configuración global de Git.

    git config --list | grep credential

  2. Si ves alguna línea similar a *credential*.helper=store en macOS o credential.helper = manager en Windows, quítalas y, luego, vuelve a autenticarte con gcloud auth login antes de volver a intentar el comando de Git.

  3. Si la respuesta no incluye credential.https://*.*.sourcemanager.dev.helper=gcloud.sh en macOS o Linux, o credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd en Windows, agrega el asistente de autenticación de Secure Source Manager a tu configuración global de Git:

    Linux

    1. Para agregar el auxiliar de autenticación de Secure Source Manager a tu configuración global de Git, ejecuta el siguiente comando:

      git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh

    2. Para validar que la línea de ayuda de autenticación se agregó a tu configuración global de Git, ejecuta el siguiente comando:

      git config --list | grep credential

      El resultado debe incluir credential.https://*.*.sourcemanager.dev.helper=gcloud.sh.

    3. Para autenticar, ejecuta gcloud auth login.

    4. Ejecuta un comando de Git para probar la autenticación.

    Windows

    1. Para verificar tu versión de gcloud CLI, sigue las instrucciones de Instala Git y Google Cloud CLI.

    2. Para agregar el auxiliar de autenticación de Secure Source Manager a tu configuración global de Git, ejecuta el siguiente comando:

      git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

    3. Para validar que la línea de ayuda de autenticación se agregó a tu configuración global de Git, ejecuta el siguiente comando:

      git config --list | grep credential

      El resultado debe incluir credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd.

    4. Para autenticar, ejecuta gcloud auth login.

    5. Ejecuta un comando de Git para probar la autenticación.

Las solicitudes HTTPS de Git fallan con un token no válido

Se requiere un token de OAuth válido como contraseña para las operaciones HTTPS de Git. Normalmente, esto lo controla el asistente de credenciales de Git, pero también puede funcionar con tokens de OAuth generados con otros enfoques (por ejemplo, credenciales predeterminadas de la aplicación).

Si se rechaza una solicitud de Git debido a un token no válido, normalmente significa que no se pudo extraer la información del usuario del token entrante. Este error puede deberse a varios motivos:

  • Es posible que haya vencido tu acceso a gcloud CLI

    Vuelve a acceder con gcloud auth login.

  • Tu token no tiene el alcance suficiente. Se espera que los tokens de OAuth tengan los siguientes permisos:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/userinfo.email

    Puedes verificar el alcance del token llamando a curl https://oauth2.googleapis.com/tokeninfo?access_token=${TOKEN}.

  • Usas un token generado a partir de la identidad para cargas de trabajo de la flota de GKE:

  • Tienes políticas de la organización que impiden el uso de tokens fuera de ciertos perímetros, por ejemplo, el acceso adaptado al contexto:

    Secure Source Manager no admite de forma nativa el Acceso adaptado al contexto. Comunícate con el equipo de asistencia para conocer los próximos pasos.

El proyecto no aparece en el selector de productos de la interfaz web

Cuando usas el selector de productos de la interfaz web de Secure Source Manager, no aparece tu proyecto.

Este problema ocurre cuando tienes varias credenciales de acceso para Secure Source Manager.

Para solucionar este problema, sigue estos pasos:

  • Borra las cookies agregando lo siguiente a la URL de tu instancia de Secure Source Manager: /_oauth/consent

    Por ejemplo, si la URL de tu instancia es https://my-instance-098765432123.us-central1.sourcemanager.dev/, ingresa https://my-instance-098765432123.us-central1.sourcemanager.dev/_oauth/consent en la barra de direcciones del navegador y, luego, accede con las credenciales correctas.

El archivo de activadores no activa compilaciones

Si las compilaciones no se activan según lo esperado después de enviar el archivo de activadores, es posible que tengas uno de los siguientes problemas:

  • El archivo de activadores no está en la rama predeterminada. Para resolver este problema, mueve el archivo de activadores a tu rama predeterminada.
  • El archivo de activadores tiene un formato no válido. Este error se indica con un banner en la página del repositorio que dice Build triggers configuration error: .... Para corregir este problema, consulta el esquema del archivo de activadores. Cuando la configuración del archivo de activadores es correcta, el banner de la página del repositorio muestra el mensaje Valid build triggers configuration.

Error de configuración de los activadores de compilación

Después de enviar tu archivo triggers.yaml a tu repositorio de Secure Source Manager, aparece el siguiente error en un banner:

Build cannot be created.

Este problema ocurre por los siguientes motivos:

  • El archivo de configuración de Cloud Build tiene opciones no válidas.
  • El archivo de configuración de Cloud Build tiene un formato no válido.
  • La cuenta de servicio de Secure Source Manager no tiene los permisos necesarios para usar la cuenta de servicio de Cloud Build especificada por el usuario.

Para solucionar este problema, haz lo siguiente:

La compilación falla durante la ejecución

Si una compilación se activa correctamente, pero falla durante la ejecución, la confirmación asociada tendrá el estado de confirmación Fallida.

Para solucionar problemas relacionados con una compilación fallida, en la página del repositorio, junto al estado de la confirmación fallida, haz clic en Detalles.

Se abrirá el registro de ejecución de Cloud Build. Para obtener más información sobre la solución de problemas de compilaciones en Cloud Build, consulta Soluciona errores de compilación.