Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
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.
# Solución de problemas de Amazon CodeCatalyst
La siguiente información puede ayudarte a solucionar problemas comunes en. CodeCatalyst También puedes usar el informe de CodeCatalyst salud de Amazon para determinar si hay problemas de servicio que puedan afectar a tu experiencia.
**Topics**
+ [Solución de problemas generales de acceso](#troubleshooting-general)
+ [Solución de problemas de soporte](#troubleshoot-support)
+ [Parte o la totalidad de Amazon CodeCatalyst no está disponible](#service-unavailable)
+ [No puedo crear un proyecto en CodeCatalyst](#troubleshoot-create-project)
+ [No puedo acceder a mi espacio de BID como usuario nuevo o no me pueden añadir como nuevo usuario de SSO debido a que el nombre de usuario está incompleto](#troubleshoot-username-truncated)
+ [Al añadir un usuario de SSO a mi espacio federado como usuario nuevo, se ha creado un usuario duplicado](#troubleshoot-username-duplicated-SSO)
+ [Quiero enviar comentarios en CodeCatalyst](#troubleshoot-create-feedback)
+ [Solución de problemas con repositorios de código fuente](troubleshooting-source.md)
+ [Solución de problemas en proyectos y esquemas](projects-troubleshooting.md)
+ [Solución de problemas con los entornos de desarrollo](devenvironments-troubleshooting.md)
+ [Solución de problemas con flujos de trabajo](troubleshooting-workflows.md)
+ [Solución de problemas con incidencias](troubleshooting-issues.md)
+ [Solución de problemas con la búsqueda en CodeCatalyst](troubleshooting-search.md)
+ [Solución de problemas con extensiones](troubleshooting-extensions.md)
+ [Solución de problemas con las cuentas asociadas a un espacio](troubleshooting-connections.md)
+ [Solución de problemas entre Amazon CodeCatalyst y los AWS SDK o la AWS CLI](troubleshooting-cli-sdk.md)
## Solución de problemas generales de acceso
### He olvidado mi contraseña
**Problema:** he olvidado la contraseña que utilizo para mi ID de AWS constructor y Amazon CodeCatalyst.
**Posibles soluciones:** la forma más sencilla de solucionar este problema es restablecer la contraseña.
1. Abre [Amazon CodeCatalyst](https://codecatalyst.aws/) e introduce tu **dirección de correo electrónico**. A continuación, elija **Continuar**.
1. Elija **¿Ha olvidado su contraseña?**
1. Le enviaremos un correo electrónico con un enlace para que cambie su contraseña. Si no ve el correo electrónico en su bandeja de entrada, compruebe la carpeta de correo no deseado.
### Parte o la totalidad de Amazon CodeCatalyst no está disponible
**Problema:** he accedido o seguido un enlace a la CodeCatalyst consola, pero aparece un error.
**Posibles soluciones:** los motivos más comunes de este problema son haber seguido un enlace a un proyecto o un espacio para el que no se ha recibido invitación, o que hay un problema de disponibilidad general con el servicio. Consulte el [informe de estado](health-dashboard.md) para ver si hay algún problema conocido con el servicio. Si no es el caso, póngase en contacto con la persona que le haya invitado al proyecto o al espacio y pídale otra invitación. Si no le han invitado a ningún proyecto o espacio, puede inscribirse y [crear su propio espacio y sus propios proyectos](sign-up-create-resources.md).
### No puedo crear un proyecto en CodeCatalyst
**Problema:** quiero crear un proyecto, pero el botón **Crear proyecto** aparece como no disponible o recibo un mensaje de error.
**Posibles soluciones:** los motivos más comunes de este problema son que has iniciado sesión en la consola con un ID de AWS constructor que no tiene la función de **administrador de Space**. Debe tener este rol para crear proyectos en un espacio.
Si tiene este rol y el botón no aparece como disponible, es posible que se trate de una incidencia transitoria con el servicio. Actualice su navegador e inténtelo de nuevo.
## Solución de problemas de soporte
### Aparece un error cuando accedo Soporte a Amazon CodeCatalyst
**Problema:** Cuando elijo la CodeCatalyst opción Soporte para Amazon, recibo el siguiente mensaje de error:
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Cuenta de AWS that is the billing account for the space.`
**Posibles soluciones:** agregue el rol requerido a la Cuenta de AWS que sea la cuenta de facturación del espacio. La cuenta designada como cuenta de facturación para el espacio utiliza el rol `AWSRoleForCodeCatalystSupport` y la política administrada `AmazonCodeCatalystSupportAccess`. Para obtener más información, consulte [Creación del rol **AWSRoleForCodeCatalystSupport** para su cuenta y su espacio](ipa-iam-roles.md#ipa-iam-roles-support-create).
**nota**
Un ID de AWS constructor solo puede obtener soporte para el alias con el que está autenticado y solo para los recursos en función de los permisos en CodeCatalyst los que está autenticado. El soporte de Cuentas y facturación está disponible para todos los usuarios del espacio. Sin embargo, los creadores solo pueden obtener soporte para los recursos y la información para los que tengan permisos. CodeCatalyst
### No puedo crear casos de soporte técnico para mi espacio
**Problema:** no puedo crear casos de soporte técnico para mi espacio.
**Soluciones:** es necesario añadir un plan Business Support o Enterprise Support a la cuenta de facturación del espacio para que los usuarios del espacio puedan crear casos de soporte técnico. Pida al administrador del espacio que agregue un plan Soporte a su cuenta de facturación del espacio o visite https://repost.aws/ para preguntar a la comunidad de AWS .
### Mi cuenta para casos de soporte ya no está conectada a mi espacio en CodeCatalyst
**Problema:** mi cuenta para casos de soporte ya no está conectada a mi espacio en CodeCatalyst.
**Soluciones:** si un usuario con el rol de **administrador del espacio** cambia de cuenta de facturación del espacio, el Soporte plan y todos los casos asociados se desconectarán del espacio. Los Soporte casos asociados a la antigua cuenta de facturación de espacios dejarán de estar visibles en Soporte Amazon CodeCatalyst. El usuario raíz de esa cuenta de facturación puede ver y resolver casos antiguos Consola de administración de AWS y configurar permisos de IAM Soporte para que otros usuarios puedan ver y resolver casos antiguos. No podrá seguir recibiendo asistencia técnica CodeCatalyst desde la antigua cuenta de facturación de Space a través de la Consola de administración de AWS, pero podrá recibir asistencia técnica para otros servicios hasta que se cancele su Soporte plan.
Para obtener más información, consulte [Updating, resolving, and reopening your case](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html) en la *Guía del usuario de Soporte *.
### No puedo abrir un caso de soporte para otro Servicio de AWS en Soporte Amazon CodeCatalyst
**Problema:** no puedo abrir un caso de soporte Soporte para otro Servicio de AWS CodeCatalyst.
**Soluciones posibles:** solo puedes abrir casos de CodeCatalyst soporte desde Soporte para CodeCatalyst. Si necesitas soporte para servicios o recursos desplegados desde CodeCatalyst otro servicio AWS, Amazon u otro servicio de terceros, tendrás que crear un caso a través del canal de soporte del servicio Consola de administración de AWS o del tercero. Para obtener más información, consulte [Creación de casos de soporte y administración de casos](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html) en la *Guía del usuario de Soporte *.
## Parte o la totalidad de Amazon CodeCatalyst no está disponible
**Problema:** he accedido o seguido un enlace a la CodeCatalyst consola, pero aparece un error.
**Posibles soluciones:** los motivos más comunes de este problema son haber seguido un enlace a un proyecto o un espacio para el que no se ha recibido invitación, o que hay un problema de disponibilidad general con el servicio. Consulte el [informe de estado](health-dashboard.md) para ver si hay algún problema conocido con el servicio. Si no es el caso, póngase en contacto con la persona que le haya invitado al proyecto o al espacio y pídale otra invitación. Si no le han invitado a ningún proyecto o espacio, puede inscribirse y [crear su propio espacio y sus propios proyectos](sign-up-create-resources.md).
## No puedo crear un proyecto en CodeCatalyst
**Problema:** quiero crear un proyecto, pero el botón **Crear proyecto** aparece como no disponible o recibo un mensaje de error.
**Posibles soluciones:** los motivos más comunes de este problema son que has iniciado sesión en la consola con un ID de AWS constructor que no tiene la función de **administrador de Space**. Debe tener este rol para crear proyectos en un espacio.
Si tiene este rol y el botón no aparece como disponible, es posible que se trate de una incidencia transitoria con el servicio. Actualice su navegador e inténtelo de nuevo.
## No puedo acceder a mi espacio de BID como usuario nuevo o no me pueden añadir como nuevo usuario de SSO debido a que el nombre de usuario está incompleto
**Problema:** CodeCatalyst trunca los nombres de usuario después de 100 caracteres, lo que puede provocar que algunos nombres de usuario parezcan idénticos. Como nuevo usuario que accede a un CodeCatalyst espacio, tengo este problema según el tipo de espacio, de la siguiente manera:
+ Tengo un ID de AWS constructor que quiero usar para iniciar sesión CodeCatalyst. Cuando intento iniciar sesión en el espacio, aparece un mensaje que indica que mi nombre de usuario no es válido.
+ Soy administrador de identidades federado de un CodeCatalyst espacio que admite la federación de identidades. Al añadir un nuevo usuario a los usuarios y grupos de SSO en el IAM Identity Center, recibo un mensaje que indica que el usuario no es válido.
**Soluciones posibles:** el primer usuario que inicie sesión en el espacio CodeCatalyst o que se añada al mismo como usuario de SSO con un nombre de usuario truncado determinado, lo logrará. Los usuarios que se registren con un AWS Builder ID o que se añadan posteriormente al Centro de Identidad de IAM no podrán iniciar sesión porque el nombre aparecerá duplicado. En función del tipo de espacio, realice una de las acciones siguientes:
+ Para poder iniciar sesión en el espacio AWS Builder ID, regístrese con un nombre de usuario diferente.
+ Para poder agregar al nuevo usuario al IAM Identity Center, agregue al usuario con un nombre de usuario diferente.
**nota**
Aunque el nombre de usuario parezca truncado, se CodeCatalyst asigna a la identidad de una manera que no se ve afectada por los nombres de usuario con nombres truncados. Sin embargo, si se crea un nombre de usuario que sea igual a un nombre de usuario truncado, dicho nombre de usuario no estará disponible si otro usuario asociado (con el mismo espacio o con la misma aplicación del Centro de Identidad de IAM) ya se ha unido con ese nombre de usuario truncado. CodeCatalyst
## Al añadir un usuario de SSO a mi espacio federado como usuario nuevo, se ha creado un usuario duplicado
**Problema:** los usuarios de CodeCatalyst SSO que se agreguen a un CodeCatalyst espacio y luego se eliminen pueden experimentar problemas si el nombre de usuario intenta volver a utilizarlo. Esto podría provocar un error similar al siguiente, en el que no se permite duplicar al usuario aunque se haya vuelto a crear.
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Cuenta de AWS that is the billing account for the space.`
**Soluciones posibles:** Si se elimina un usuario de IDC existente y, a continuación, se vuelve a crear un usuario con el mismo nombre, el nuevo usuario no podrá iniciar sesión porque su nombre de usuario está en conflicto con el del usuario anterior. No se puede volver a utilizar un nombre después de añadirlo a un espacio como usuario de SSO. Los usuarios que se registren con un AWS Builder ID o que se añadan posteriormente al Centro de Identidad de IAM no podrán iniciar sesión porque el nombre aparecerá duplicado.
En función del tipo de espacio, realice una de las acciones siguientes:
+ Para poder iniciar sesión en el espacio AWS Builder ID, regístrese con un nombre de usuario diferente.
+ Para poder agregar al nuevo usuario al IAM Identity Center, agregue al usuario con un nombre de usuario diferente.
## Quiero enviar comentarios en CodeCatalyst
**Problema:** he encontrado un error CodeCatalyst y quiero enviar comentarios.
**Posibles soluciones:** puedes enviar tus comentarios directamente en CodeCatalyst.
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. En el panel de navegación, elija **Enviar comentarios**.
1. Elija el tipo de comentario en el menú desplegable e introduzca su comentario.
# Solución de problemas con repositorios de código fuente
La siguiente información puede ayudarte a solucionar problemas comunes relacionados con los repositorios de código fuente. CodeCatalyst
**Topics**
+ [He alcanzado el límite máximo de almacenamiento de mi espacio y veo advertencias o errores](#source-troubleshoot-storage)
+ [Recibo un error al intentar clonar o enviar archivos a un repositorio de CodeCatalyst código fuente de Amazon](#source-troubleshoot-clone)
+ [Recibo un error al intentar confirmar o enviar información a un repositorio de CodeCatalyst código fuente de Amazon](#source-troubleshoot-commit-code)
+ [Necesito un repositorio de código fuente para mi proyecto](#source-troubleshoot-need-repository)
+ [Mi repositorio de código fuente es completamente nuevo, pero contiene una confirmación](#source-troubleshoot-initial-commit)
+ [Quiero una ramificación diferente como ramificación predeterminada](#source-troubleshoot-default-branch)
+ [Estoy recibiendo correos electrónicos sobre la actividad de las solicitudes de extracción](#source-troubleshoot-repository-emails)
+ [He olvidado mi token de acceso personal (PAT)](#source-troubleshoot-forgot-pat)
+ [Una solicitud de extracción no muestra los cambios esperados](#source-troubleshoot-pull-request-diff)
+ [Una solicitud de extracción muestra el estado No se puede combinar](#source-troubleshoot-pull-request-not-mergeable)
## He alcanzado el límite máximo de almacenamiento de mi espacio y veo advertencias o errores
**Problema:** quiero enviar código a uno o más repositorios de código fuente CodeCatalyst, pero aparece un error. En la consola, veo un mensaje en la página del repositorio de código fuente que indica que he alcanzado el límite de almacenamiento del espacio.
**Posibles soluciones:** en función del rol que desempeñe en el proyecto o en el espacio, puede reducir el tamaño de uno o varios de los repositorios de código fuente, eliminar los repositorios de código fuente que no utilice o cambiar el nivel de facturación por uno que tenga más espacio de almacenamiento.
+ Para reducir el tamaño del repositorio de código fuente de un proyecto, puede eliminar las ramificaciones que no utilice. Para obtener más información, consulte [Eliminación de una ramificación](source-branches-delete.md) y [Rol de colaborador](ipa-role-types.md#ipa-role-contributor).
+ Para reducir el almacenamiento total de un espacio, puede eliminar los repositorios de código fuente no utilizados. Para obtener más información, consulte [Eliminación de un repositorio de código fuente](source-repositories-delete.md) y [Rol de administrador del proyecto](ipa-role-types.md#ipa-role-project-admin).
+ Para aumentar la cantidad de almacenamiento disponible para un espacio, puede cambiar el nivel de facturación por uno con más espacio de almacenamiento. Para obtener más información, consulta Cómo [cambiar el nivel CodeCatalyst de facturación](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) en la Guía del CodeCatalyst administrador de Amazon.
## Recibo un error al intentar clonar o enviar archivos a un repositorio de CodeCatalyst código fuente de Amazon
**Problema:** cuando intento clonar un repositorio de código fuente en un equipo local o en un entorno de desarrollo integrado (IDE), aparece un error de permisos.
**Posibles soluciones: es posible** que no tengas un token de acceso personal (PAT) para tu ID de AWS creador, que no hayas configurado tu sistema de administración de credenciales con tu PAT o que tu PAT haya caducado. Pruebe una o varias de las siguientes soluciones:
+ Crear un token de acceso personal (PAT). Para obtener más información, consulte [Concesión de acceso al repositorio para usuarios mediante tokens de acceso personal](ipa-tokens-keys.md).
+ Asegúrese de haber aceptado una invitación al proyecto que contenga el repositorio de código fuente y de seguir siendo miembro de ese proyecto. No puede clonar un repositorio de código fuente si no es miembro activo de ese proyecto. Inicie sesión en la consola e intente navegar hasta el espacio y el proyecto en los que esté intentando clonar un repositorio de código fuente. Si no puede ver el proyecto en la lista de proyectos del espacio, significa que no es miembro de ese proyecto o que no ha aceptado una invitación a ese proyecto. Para obtener más información, consulte [Aceptar una invitación y crear un ID de AWS constructor](sign-up-sign-in.md).
+ Asegúrese de que el comando de clonación tenga el formato correcto e incluya su ID de AWS constructor. Por ejemplo:
```
https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
```
+ Úselo AWS CLI para asegurarse de que tiene una PAT asociada a su ID de AWS constructor y de que no ha caducado. Si no tiene uno o si el PAT ha caducado, cree uno. Para obtener más información, consulte [Concesión de acceso al repositorio para usuarios mediante tokens de acceso personal](ipa-tokens-keys.md).
+ Intente crear un entorno de desarrollo para trabajar con el código del repositorio de código fuente en lugar de clonarlo en un repositorio o IDE local. Para obtener más información, consulte [Creación de un entorno de desarrollo](devenvironment-create.md).
## Recibo un error al intentar confirmar o enviar información a un repositorio de CodeCatalyst código fuente de Amazon
**Problema:** cuando intento insertar en un repositorio de código fuente, aparece un error de permisos.
**Posibles soluciones:** es posible que no tenga un rol en el proyecto que le permita confirmar e insertar los cambios de código en el proyecto. Consulte su rol en el proyecto en el que esté intentando insertar los cambios en un repositorio de código fuente. Para obtener más información, consulte [Obtención de una lista de miembros y de sus roles en el proyecto](projects-members.md#projects-members-view) y [Concesión de acceso en los roles de usuario](ipa-roles.md).
Si tiene un rol que le permita confirmar e insertar cambios, es posible que la ramificación en la que esté intentando confirmar los cambios tenga configurada una regla de ramificación que impida insertar cambios de código a esa ramificación. Intente crear una ramificación y, en su lugar, insertar el código en esa ramificación. Para obtener más información, consulte [Administración de las acciones permitidas para una ramificación con reglas de ramificación](source-branches-branch-rules.md).
## Necesito un repositorio de código fuente para mi proyecto
**Problema:** mi proyecto no tiene un repositorio de código fuente o necesito otro repositorio de código fuente para mi proyecto.
**Posibles soluciones:** algunos proyectos se crean sin recursos. Si eres miembro del proyecto, puedes crear repositorios de código fuente para ese proyecto en CodeCatalyst. **Si alguien con el rol de **administrador del espacio** instala los **GitHub repositorios y los** conecta a una GitHub cuenta, puedes vincular los GitHub repositorios disponibles para añadirlos a tu proyecto si tienes el rol de administrador del proyecto.** Para obtener más información, consulte [Creación de un repositorio de código fuente](source-repositories-create.md) y [Vinculación de un repositorio de código fuente](source-repositories-link.md).
## Mi repositorio de código fuente es completamente nuevo, pero contiene una confirmación
**Problema:** acabo de crear un repositorio de código fuente. Debería estar vacío, pero contiene una confirmación, una ramificación y un archivo `README.md`.
**Posibles soluciones:** este es el comportamiento esperado. Todos los repositorios fuente CodeCatalyst incluyen una confirmación inicial que establece la rama predeterminada en `main` e incluye un código de muestra (si el repositorio se creó para un proyecto con un plano que incluía un código de muestra) o una plantilla de archivo Markdown para un archivo README del repositorio. Puede crear ramificaciones adicionales en la consola y en los clientes de Git. Puede crear y editar archivos en la consola y eliminar archivos en entornos de desarrollo y clientes de Git.
## Quiero una ramificación diferente como ramificación predeterminada
**Problema:** mi repositorio de código fuente venía con una ramificación predeterminada llamada `main`, pero quiero que mi ramificación predeterminada sea una diferente.
**Correcciones posibles:** no se puede cambiar ni eliminar la rama predeterminada de los repositorios de origen en. CodeCatalyst Puede crear ramificaciones adicionales y utilizarlas en las acciones de origen de los flujos de trabajo. También puedes elegir vincular los GitHub repositorios y usarlos como repositorios para tu proyecto.
## Estoy recibiendo correos electrónicos sobre la actividad de las solicitudes de extracción
**Problema:** no me he registrado ni he configurado notificaciones por correo electrónico sobre la actividad de las solicitudes de extracción, pero las recibo de todos modos.
**Posibles soluciones:** las notificaciones por correo electrónico sobre la actividad de las solicitudes de extracción se envían automáticamente. Para obtener más información, consulte [Revisar el código con solicitudes de cambios en Amazon CodeCatalyst](source-pull-requests.md).
## He olvidado mi token de acceso personal (PAT)
**Problema:** he estado usando una PAT para clonar, insertar y extraer código de los repositorios fuente, pero he perdido el valor de mi token y no lo encuentro en la consola. CodeCatalyst
**Posibles soluciones:** la forma más rápida de resolver este problema es crear otro PAT y configurar el administrador de credenciales o el IDE para que utilice este nuevo PAT. Solo mostramos el valor de un PAT cuando se crea. Si pierde este valor, no se puede recuperar. Para obtener más información, consulte [Concesión de acceso al repositorio para usuarios mediante tokens de acceso personal](ipa-tokens-keys.md).
## Una solicitud de extracción no muestra los cambios esperados
**Problema:** he creado una solicitud de extracción, pero no veo los cambios que esperaba ver entre las ramificaciones de origen y destino.
**Posibles soluciones:** esto puede deberse a varios problemas. Pruebe una o varias de las siguientes soluciones:
+ Es posible que esté revisando los cambios entre revisiones anteriores o que no esté viendo los cambios más recientes. Actualice el navegador y asegúrese de haber elegido la comparación entre las revisiones que realmente quiera ver.
+ No todos los cambios de una solicitud de extracción se pueden mostrar en la consola. Por ejemplo, no puede ver los submódulos de Git en la consola, por lo que no es posible visualizar las diferencias de un submódulo en una solicitud de extracción. Es posible que algunas diferencias sean demasiado grandes para mostrarlas. Para obtener más información, consulte [Cuotas para los repositorios de fuentes en CodeCatalyst](source-quotas.md) y [Visualización de un archivoVisualización del historial de cambios en un archivo](source-files-view.md).
+ Las solicitudes de extracción muestran las diferencias entre la base de combinación y la revisión que elija. Al crear una solicitud de extracción, la diferencia que se le 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 que se muestra es entre la revisión y su base de combinación. La base de combinación es la confirmación que estaba el extremo de la ramificación de destino cuando se creó la revisión. La base de combinación puede cambiar entre revisiones. Para obtener más información sobre las diferencias y las bases de fusión en Git, consulta [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentación de Git.
## Una solicitud de extracción muestra el estado No se puede combinar
**Problema:** quiero combinar una solicitud de extracción, pero su estado aparece como **No se puede combinar**.
**Posibles soluciones:** esto puede deberse a uno o más problemas:
+ Todos los revisores necesarios para la solicitud de extracción deben aprobar una solicitud de extracción antes de que se pueda combinar. Revisa la lista de revisores obligatorios para ver si hay algún revisor para el que aparezca un icono de reloj junto al nombre. Un icono de reloj indica que el revisor no ha aprobado la solicitud de extracción.
**nota**
Si un revisor obligatorio ha sido eliminado del proyecto antes de aprobar la solicitud de extracción, no podrá combinar la solicitud de extracción. Cierre la solicitud de extracción y cree una nueva.
+ Es posible que haya un conflicto de fusión entre la rama de origen y la de destino. CodeCatalyst no admite todas las posibles estrategias y opciones de fusión de Git. Puede evaluar las ramificaciones para detectar conflictos de combinación en un entorno de desarrollo o clonar el repositorio y utilizar un IDE o las herramientas de Git para buscar y resolver los conflictos de combinación. Para obtener más información, consulte [Combinación de una solicitud de extracción](pull-requests-merge.md).
# Solución de problemas en proyectos y esquemas
Esta sección puede ayudarlo a solucionar algunos problemas habituales que puede encontrarse al trabajar con proyectos y esquemas en Amazon CodeCatalyst.
# A la API de Java le faltan dependencias del AWS Fargate blueprint para apache-maven-3.8.6
**Problema: en el caso** de un proyecto creado a partir de la API de Java con un AWS Fargate blueprint, el flujo de trabajo falla y se produce un error debido a la falta de dependencias. `apache-maven-3.8.6` El flujo de trabajo falla con una salida similar al siguiente ejemplo:
```
Step 8/25 : RUN wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp
---> Running in 1851ce6f4d1b
[91m--2023-03-10 01:24:55-- https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
[0m[91mResolving dlcdn.apache.org (dlcdn.apache.org)...
[0m[91m151.101.2.132, 2a04:4e42::644
Connecting to dlcdn.apache.org (dlcdn.apache.org)|151.101.2.132|:443...
[0m[91mconnected.
[0m[91mHTTP request sent, awaiting response... [0m[91m404 Not Found
2023-03-10 01:24:55 ERROR 404: Not Found.
[0mThe command '/bin/sh -c wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp' returned a non-zero code: 8
[Container] 2023/03/10 01:24:55 Command failed with exit status 8
```
**Solución:** actualice el Dockerfile del esquema siguiendo los pasos a continuación.
1. En la barra de búsqueda, introduzca `apache-maven-3.8.6` para ubicar el Dockerfile dentro del proyecto creado con la API de Java con el esquema AWS Fargate .
1. Actualice el Dockerfile (`/static-assets/app/Dockerfile`) para usar `maven:3.9.0-amazoncorretto-11` como imagen base y eliminar la dependencia del paquete `apache-maven-3.8.6`.
1. (Recomendado) También recomendamos actualizar el tamaño del montículo de Maven a 6 GB.
A continuación, se muestra un ejemplo de Dockerfile.
```
FROM maven:3.9.0-amazoncorretto-11 AS builder
COPY ./pom.xml ./pom.xml
COPY src ./src/
ENV MAVEN_OPTS='-Xmx6g'
RUN mvn -Dmaven.test.skip=true clean package
FROM amazoncorretto:11-alpine
COPY —from=builder target/CustomerService-0.0.1.jar CustomerService-0.0.1.jar
EXPOSE 80
CMD ["java","-jar","-Dspring.profiles.active=prod","/CustomerService-0.0.1.jar", "—server.port=80"]
```
# El flujo de trabajo moderno del blueprint de aplicaciones web de tres niveles **OnPullRequest**falla debido a un error de permisos para Amazon CodeGuru
**Problema:** cuando intento ejecutar un flujo de trabajo para un proyecto, el flujo de trabajo no se ejecuta y aparece el siguiente mensaje:
```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```
``
**Solución:** Una posible causa del error de esta acción podría deberse a la falta de permisos en la política de funciones de IAM, ya que a su versión de la función de servicio utilizada por CodeCatalyst la persona conectada le faltan los permisos necesarios para que la acción **codeguru\$1codereview Cuenta de AWS ** se ejecute correctamente. Para solucionar este problema, el rol de servicio debe actualizarse con los permisos necesarios o debe cambiar el rol de servicio utilizado para el flujo de trabajo por uno que tenga los permisos necesarios para Amazon CodeGuru y Amazon CodeGuru Reviewer. Siga estos pasos para buscar el rol y actualizar los permisos de la política de roles a fin de permitir que el flujo de trabajo se ejecute correctamente.
**nota**
Estos pasos se aplican a los siguientes flujos de trabajo en CodeCatalyst:
El **OnPullRequest**flujo de trabajo previsto para los proyectos creados con el modelo de aplicación web moderna de tres niveles en. CodeCatalyst
Flujos de trabajo agregados a los proyectos CodeCatalyst con acciones que acceden a Amazon CodeGuru o Amazon CodeGuru Reviewer.
Cada proyecto contiene flujos de trabajo con acciones que utilizan un rol y un entorno proporcionados por la persona Cuenta de AWS conectada al proyecto CodeCatalyst. El flujo de trabajo con las acciones y su política designada se almacena en el repositorio de código fuente, en el directorio /.codecatalyst/workflows. No es necesario modificar el flujo de trabajo (YAML) a menos que añada un nuevo ID de rol al flujo de trabajo existente. Para obtener más información sobre los elementos de plantillas YAML y sobre formatos, consulte [Definición de flujo de trabajo en YAML](workflow-reference.md).
Estos son los pasos generales que debe seguir para editar la política de roles y verificar el YAML del flujo de trabajo.
**Referencia al nombre del rol en el flujo de trabajo (YAML) y actualización de la política**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navega hasta tu CodeCatalyst espacio. Vaya a su proyecto.
1. Elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elige el flujo de trabajo titulado **OnPullRequest**. Elija la pestaña **Definición**.
1. En el YAML del flujo de trabajo, en el campo `Role:` situado bajo la acción **codeguru\$1codereview**, anote el nombre del rol. Este es el rol con la política que modificará en IAM. En el siguiente ejemplo, se muestra el nombre de rol.
![\[Consultar el nombre del rol de IAM en el flujo de trabajo (YAML)\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)
1. Realice una de las siguientes acciones:
+ (Recomendado) Actualice el rol de servicio conectado a su proyecto con los permisos necesarios para Amazon CodeGuru y Amazon CodeGuru Reviewer. El rol tendrá un nombre `CodeCatalystWorkflowDevelopmentRole-spaceName` con un identificador único adjunto. Para obtener más información sobre los roles y la política de roles, consulte [El funcionamiento del rol de servicio **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role). Continúe con los siguientes pasos para actualizar la política en IAM.
**nota**
Debe tener acceso de AWS administrador al Cuenta de AWS rol y a la política.
+ Cambie el rol de servicio utilizado para el flujo de trabajo por uno que tenga los permisos necesarios para Amazon CodeGuru y Amazon CodeGuru Reviewer o cree un nuevo rol con los permisos necesarios.
1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
En la consola de IAM, busque el rol del paso 5, como `CodeCatalystPreviewDevelopmentRole`.
1. En el rol del paso 5, cambie la política de permisos para incluir los permisos `codeguru-reviewer:*` y `codeguru:*`. Después de añadir estos permisos, la política de permisos debería tener un aspecto similar al siguiente:
1. Tras realizar las correcciones de política, regrese a CodeCatalyst e inicie de nuevo la ejecución del flujo de trabajo.
## ¿Aún está buscando un modo de solucionar el problema?
Puede ir a [Amazon CodeCatalyst](https://codecatalyst.aws/) o rellenar un [formulario de información de asistencia](https://support.aws.amazon.com/#/contacts/aws-account-support/). En la sección **Solicitar información**, en **Cómo podemos ayudarlo**, indique que es cliente de Amazon CodeCatalyst. Proporcione la mayor cantidad de detalles posible para que podamos estudiar su problema de mejor manera posible.
# Solución de problemas con los entornos de desarrollo
Consulte las siguientes secciones para solucionar problemas relacionados con los entornos de desarrollo. Para obtener más información sobre los entornos de desarrollo, consulte [Escribe y modifica código con entornos de desarrollo en CodeCatalystCreación y modificación de código con entornos de desarrollo](devenvironment.md).
**Topics**
+ [La creación de mi entorno de desarrollo no se ha realizado correctamente debido a un problema con las cuotas](#troubleshooting-devenvironments-create)
+ [No puedo incorporar los cambios de mi entorno de desarrollo en una ramificación específica de un repositorio](#troubleshooting-devenvironments-branchrules)
+ [Mi entorno de desarrollo no se reanuda](#troubleshooting-devenvironments-resume)
+ [Mi entorno de desarrollo se desconecta](#troubleshooting-devenvironments-connection)
+ [Se produjo un error en mi entorno de desarrollo conectado a una VPC](#troubleshooting-devenvironments-vpc)
+ [No encuentro el directorio en el que está mi proyecto](#troubleshooting-devenvironments-projects)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH](#troubleshooting-devenvironments-connect-ssh)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH porque falta mi configuración de SSH local](#troubleshooting-devenvironments-projects-ssh-config)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH porque tengo problemas con mi perfil AWS Config `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [No puedo crear un entorno de desarrollo si he iniciado sesión CodeCatalyst con una cuenta de inicio de sesión único](#troubleshoot-create-dev-env-idprovider)
+ [Solución de problemas con los IDE](devenvironments-troubleshooting-ides.md)
+ [Solución de problemas con los devfiles](devenvironments-devenvironments-devfile.md)
## La creación de mi entorno de desarrollo no se ha realizado correctamente debido a un problema con las cuotas
**Problema:** quiero crear un entorno de desarrollo en él CodeCatalyst, pero aparece un error. En la consola, veo un mensaje en la página Entornos de desarrollo que indica que he alcanzado el límite de almacenamiento del espacio.
**Soluciones posibles:** en función de su rol en el proyecto o espacio, puede eliminar uno o varios de sus propios entornos de desarrollo o, si tiene el rol de administrador del espacio, puede eliminar los entornos de desarrollo no utilizados creados por otros usuarios. También puede decidir cambiar el nivel de facturación por uno que incluya más espacio de almacenamiento.
+ Para ver los límites de almacenamiento, consulta la pestaña **Facturación** del CodeCatalyst espacio de Amazon para comprobar si las cuotas de **uso** han alcanzado el máximo permitido. Si las cuotas han alcanzado el máximo, póngase en contacto con alguien que tenga el rol de administrador del espacio para eliminar los entornos de desarrollo innecesarios o para que considere si debería cambiar el nivel de facturación.
+ Para eliminar todos los entornos de desarrollo que haya creado y que ya no necesite, consulte [Eliminación de un entorno de desarrollo](devenvironment-delete.md).
Si el problema persiste y aparece un error en el IDE, compruebe que tiene un CodeCatalyst rol que le permita crear un entorno de desarrollo. El rol **Administrador del espacio**, el rol **Administrador del proyecto** y el rol **Colaborador** tienen permiso para crear entornos de desarrollo. Para obtener más información, consulte [Concesión de acceso en los roles de usuario](ipa-roles.md).
## No puedo incorporar los cambios de mi entorno de desarrollo en una ramificación específica de un repositorio
**Problema:** quiero confirmar e incorporar los cambios de código de mi entorno de desarrollo en una ramificación de un repositorio de código fuente, pero aparece un error.
**Soluciones posibles:** en función de su rol en el proyecto o el espacio, es posible que no tenga permisos para incorporar código en los repositorios de código fuente del proyecto. El rol **Administrador del espacio**, el rol **Administrador del proyecto** y el rol **Colaborador** tienen permiso para incorporar código en los repositorios del proyecto.
Si tiene el rol **Colaborador** pero no puede incorporar código en una ramificación específica, es posible que haya una regla de ramificación configurada para esa ramificación específica que impida a los usuarios con ese rol incorporar código en esa ramificación en particular. Intente incorporar los cambios en una ramificación diferente o crear una ramificación y, a continuación, incorporar el código en esa ramificación. Para obtener más información, consulte [Administración de las acciones permitidas para una ramificación con reglas de ramificación](source-branches-branch-rules.md).
## Mi entorno de desarrollo no se reanuda
**Problema:** mi entorno de desarrollo no se reanudó después de detenerlo.
**Posibles soluciones:** para solucionar el problema, consulta la pestaña **Facturación** del CodeCatalyst espacio de Amazon para comprobar si las cuotas de **uso** han alcanzado los límites máximos. Si las cuotas han alcanzado el límite máximo, póngase en contacto con el administrador del espacio para aumentar el nivel de facturación.
## Mi entorno de desarrollo se desconecta
**Problema:** mi entorno de desarrollo se desconectó mientras lo estaba usando.
**Soluciones posibles:** para solucionar el problema, compruebe su conexión a Internet. Si no está conectado a Internet, conéctese y reanude el trabajo en su entorno de desarrollo.
## Se produjo un error en mi entorno de desarrollo conectado a una VPC
**Problema:** he asociado una conexión de VPC a mi entorno de desarrollo y se producen errores.
**Soluciones posibles:** Docker utiliza un dispositivo de capa de enlace llamado red de puente que permite que los contenedores conectados a la misma red de puente se comuniquen. El puente predeterminado suele utilizar la subred `172.17.0.0/16` para las redes de contenedores. Si la subred de VPC para la instancia del entorno utiliza el mismo rango de direcciones que Docker, es posible que se produzca un conflicto de dirección IP. Para resolver un conflicto de direcciones IP provocado por Amazon VPC y Docker usar el mismo bloque de direcciones IPv4 CIDR, configure un bloque CIDR diferente de. `172.17.0.0/16`
**nota**
No puede cambiar el intervalo de direcciones IP de una VPC o subred existente.
## No encuentro el directorio en el que está mi proyecto
**Problema**: no encuentro el directorio en el que está mi proyecto.
**Soluciones posibles:** para localizar su proyecto, cambie el directorio a `/projects`. Este es el directorio donde puede encontrar sus proyectos.
## No puedo conectarme a mi entorno de desarrollo a través de SSH
Para solucionar los problemas de conexión a su entorno de desarrollo a través de SSH, puede ejecutar el comando `ssh` con la opción `-vvv` para mostrar más información sobre cómo resolver el problema:
```
ssh -vvv codecatalyst-dev-env===
```
## No puedo conectarme a mi entorno de desarrollo a través de SSH porque falta mi configuración de SSH local
Si falta la configuración de SSH local (`~/.ssh/config`) o el contenido de la sección `Host codecatalyst-dev-env*` no está actualizado, no podrá conectarse a su entorno de desarrollo a través de SSH. Para solucionar este problema, elimine la sección `Host codecatalyst-dev-env*` y vuelve a ejecutar el primer comando desde el modal **Acceso SSH**. Para obtener más información, consulte [Conexión a un entorno de desarrollo con SSH](devenvironment-connect-ssh.md).
## No puedo conectarme a mi entorno de desarrollo a través de SSH porque tengo problemas con mi perfil AWS Config `codecatalyst`
Asegúrese de que su AWS Config (`~/.aws/config`) del `codecatalyst` perfil coincida con el que se describe en[Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md). Si no es así, elimine el perfil de `codecatalyst` y vuelva a ejecutar el primer comando desde el modal **Acceso SSH**. Para obtener más información, consulte [Conexión a un entorno de desarrollo con SSH](devenvironment-connect-ssh.md).
## No puedo crear un entorno de desarrollo si he iniciado sesión CodeCatalyst con una cuenta de inicio de sesión único
**Problema:** cuando inicio sesión en la CodeCatalyst consola como usuario de SSO, recibo un error de excepción desconocido cuando elijo crear un entorno de desarrollo en el espacio. Cuando elijo crear un entorno de desarrollo y elegir el IDE al que acceder, por ejemplo AWS Cloud9, tengo problemas similares a los siguientes:
+ La **página Entornos** de desarrollo de la CodeCatalyst consola muestra el entorno de desarrollo en la lista con un `FAILED` estado.
+ Aparece un mensaje de error similar al siguiente:
**`An unknown exception happened`**
`We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`
**Posibles soluciones**:
Los entornos de desarrollo no están disponibles para los usuarios en los espacios en los que se use Active Directory como proveedor de identidad. Los administradores del espacio pueden usar un proveedor de identidad alternativo para acceder a los entornos de desarrollo, como IAM Identity Center. Para obtener más información sobre cómo planificar un espacio que admita la federación de identidades, [consulte Planear un espacio que admita la federación de identidades](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) en la *Guía CodeCatalyst del administrador*.
# Solución de problemas con los IDE
Consulte las siguientes secciones para solucionar problemas relacionados con los IDE en CodeCatalyst. Para obtener más información sobre los IDE, consulte [Creación de un entorno de desarrollo en un IDE](devenvironment-create.md#devenvironment-using-ide).
**Topics**
+ [Tengo versiones de imágenes en tiempo de ejecución que no coinciden en AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [No puedo acceder a mis archivos en `/projects/projects` en AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [No puedo iniciar mi entorno de desarrollo en AWS Cloud9 con un devfile personalizado](#troubleshooting-devenvironments-c9-image)
+ [Tengo problemas en AWS Cloud9](#troubleshooting-c9)
+ [En JetBrains, no puedo conectarme a mis entornos de desarrollo mediante CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [No puedo instalar AWS Toolkit para mi IDE](#troubleshooting-ide-toolkit)
+ [En mi IDE, no puedo iniciar mis entornos de desarrollo](#troubleshooting-ide-launch)
## Tengo versiones de imágenes en tiempo de ejecución que no coinciden en AWS Cloud9
AWS Cloud9 está utilizando diferentes versiones del recurso de frontend y de la imagen en tiempo de ejecución del backend. El uso de versiones diferentes puede hacer que la extensión de Git y AWS Toolkit no funcionen correctamente. Para solucionar el problema, vaya al panel de control del entorno de desarrollo, detenga el entorno de desarrollo y vuelva a iniciarlo. Para solucionar el problema con las API, use la API `UpdateDevEnvironment` para actualizar el entorno en tiempo de ejecución. Para obtener más información, consulte [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html) en la *Referencia de la API de Amazon CodeCatalyst*.
## No puedo acceder a mis archivos en `/projects/projects` en AWS Cloud9
El editor de AWS Cloud9 no puede acceder a los archivos del directorio `/projects/projects`. Para solucionar el problema, utilice el terminal de AWS Cloud9 para acceder a sus archivos o moverlos a un directorio diferente.
## No puedo iniciar mi entorno de desarrollo en AWS Cloud9 con un devfile personalizado
Es posible que su imagen de devfile no sea compatible con AWS Cloud9. Para solucionar el problema, revise el devfile del repositorio y el entorno de desarrollo correspondiente y cree uno nuevo para continuar.
## Tengo problemas en AWS Cloud9
Para otros problemas, consulte la sección de solución de problemas de la [Guía del usuario de AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).
## En JetBrains, no puedo conectarme a mis entornos de desarrollo mediante CodeCatalyst
Para solucionar el problema, compruebe que solo tenga instalada la última versión de JetBrains. Si tiene varias versiones, desinstale las versiones anteriores y vuelva a registrar el controlador de protocolos cerrando el IDE y el navegador. A continuación, abra JetBrains y vuelva a registrar el controlador de protocolos.
## No puedo instalar AWS Toolkit para mi IDE
Para solucionar este problema para VS Code, instale AWS Toolkit for Visual Studio Code manualmente desde [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).
Para solucionar este problema para JetBrains, instale AWS Toolkit for JetBrains manualmente desde [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).
## En mi IDE, no puedo iniciar mis entornos de desarrollo
Para solucionar este problema para VS Code, compruebe que tenga instalada la última versión de VS Code y AWS Toolkit for Visual Studio Code. Si no tiene la última versión, actualice e inicie su entorno de desarrollo. Para obtener más información, consulte [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).
Para solucionar este problema para JetBrains, compruebe que tenga instalada la última versión de JetBrains y AWS Toolkit for JetBrains. Si no tiene la última versión, actualice e inicie su entorno de desarrollo. Para obtener más información, consulte [Amazon CodeCatalyst for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).
# Solución de problemas con los devfiles
Consulta las siguientes secciones para solucionar problemas relacionados con los archivos de desarrollo en. CodeCatalyst Para obtener más información sobre los devfiles, consulte [Configuración de un devfile para un entorno de desarrollo](devenvironment-devfile.md).
**Topics**
+ [Mi entorno de desarrollo utiliza el devfile universal predeterminado, aunque he implementado una imagen personalizada en un devfile personalizado](#troubleshooting-devenvironments-custom-image)
+ [Mi proyecto no se compila en mi entorno de desarrollo con el devfile universal predeterminado](#troubleshooting-devenvironments-default-image)
+ [Quiero mover un devfile de repositorio para un entorno de desarrollo](#troubleshooting-devenvironments-devfile-moving)
+ [Tengo problemas para iniciar mi devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [No estoy seguro de cómo comprobar el estado de mi devfile](#troubleshooting-devenvironments-devfile-status)
+ [Mi devfile no es compatible con las herramientas proporcionadas en la última imagen](#troubleshooting-devenvironments-devfile-version)
## Mi entorno de desarrollo utiliza el devfile universal predeterminado, aunque he implementado una imagen personalizada en un devfile personalizado
Si CodeCatalyst se producen errores al iniciar un entorno de desarrollo que utilice un archivo de desarrollo personalizado, el entorno de desarrollo utilizará de forma predeterminada el archivo de desarrollo universal predeterminado. Para solucionar el problema, puede comprobar el error exacto en los registros bajo `/aws/mde/logs/devfile.log`. También puede comprobar si la ejecución de `postStart` se ha realizado correctamente en sus registros: `/aws/mde/logs/devfileCommand.log`.
## Mi proyecto no se compila en mi entorno de desarrollo con el devfile universal predeterminado
Para solucionar el problema, compruebe que no está utilizando un devfile personalizado. Si no está utilizando un devfile personalizado, consulte el archivo `devfile.yaml` del repositorio de código fuente del proyecto para localizar y corregir cualquier error.
## Quiero mover un devfile de repositorio para un entorno de desarrollo
Puede mover el devfile predeterminado de `/projects/devfile.yaml` a su repositorio de código fuente. Para actualizar la ubicación del devfile, use el siguiente comando: `/aws/mde/mde start --location repository-name/devfile.yaml`.
## Tengo problemas para iniciar mi devfile
Si hay algún problema al iniciar el devfile, este pasará al modo de recuperación para que pueda seguir conectándose a su entorno y corregir el devfile. Mientras esté en modo de recuperación, al ejecutar `/aws/mde/mde status` no se incluirá la ubicación del devfile.
```
{
"status": "STABLE"
}
```
Puede comprobar el error en los registros bajo `/aws/mde/logs`, corregir el devfile e intentar volver a ejecutar `/aws/mde/mde start`.
## No estoy seguro de cómo comprobar el estado de mi devfile
Puede comprobar el estado de su devfile ejecutando `/aws/mde/mde status`. Después de ejecutar este comando es posible que vea lo siguiente:
+ `{"status": "STABLE", "location": "devfile.yaml" }`
Esto indica que el devfile es correcto.
+ `{"status": "STABLE" }`
Esto indica que el devfile no se ha podido iniciar y ha entrado en modo de recuperación.
Puede comprobar el error exacto en los registros bajo `/aws/mde/logs/devfile.log`.
También puede comprobar si la ejecución de `postStart` se ha realizado correctamente en sus registros: `/aws/mde/logs/devfileCommand.log`.
Para obtener más información, consulte [Especificación de imágenes de devfile universales para un entorno de desarrollo](devenvironment-universal-image.md).
## Mi devfile no es compatible con las herramientas proporcionadas en la última imagen
En su entorno de desarrollo, `devfile` o `devfile postStart` puede fallar si las herramientas `latest` no tienen las herramientas necesarias para un proyecto específico. Para solucionar el problema, haga lo siguiente:
1. Vaya a su devfile.
1. En el devfile, actualice a una versión de imagen granular en lugar de `latest`. Tendrá un aspecto similar al siguiente:
```
components:
- container:
image: public.ecr.aws/amazonlinux/universal-image:1.0
```
1. Cree un nuevo entorno de desarrollo con el devfile actualizado.
# Solución de problemas con flujos de trabajo
Consulta las siguientes secciones para solucionar problemas relacionados con los flujos de trabajo en Amazon CodeCatalyst. Para obtener más información acerca de los flujos de trabajo, consulte [Creación, pruebas e implementaciones con flujos de trabajoCreación, pruebas e implementaciones con flujos de trabajo](workflow.md).
**Topics**
+ [¿Cómo corrijo los mensajes que indican que el flujo de trabajo está inactivo?](#troubleshooting-workflows-inactive)
+ [¿Cómo puedo corregir los errores de «La definición del flujo de trabajo tiene *n* errores»?](#troubleshooting-workflows-asterisks)
+ [¿Cómo puedo corregir los errores «No se pueden localizar las credenciales» y ExpiredToken «»?](#troubleshooting-workflows-auth-errors-eks)
+ [¿Cómo puedo corregir los errores de tipo Unable to connect to the server?](#troubleshooting-workflows-unable-connect-eks)
+ [¿Por qué faltan CodeDeploy campos en el editor visual?](#troubleshooting-workflows-codedeploy)
+ [¿Cómo puedo corregir los errores de las capacidades de IAM?](#troubleshooting-workflows-capabilities)
+ [¿Cómo puedo corregir los errores npm install?](#troubleshooting-workflows-npm)
+ [¿Por qué varios flujos de trabajo tienen el mismo nombre?](#troubleshooting-workflows-name)
+ [¿Puedo almacenar mis archivos de definición de flujo de trabajo en otra carpeta?](#troubleshooting-workflows-folder)
+ [¿Cómo añado acciones en secuencia a mi flujo de trabajo?](#troubleshooting-workflows-visual)
+ [¿Por qué mi flujo de trabajo se valida correctamente, pero falla en tiempo de ejecución?](#troubleshooting-workflows-validation)
+ [La detección automática no detecta informes para una acción](#troubleshooting-reports-auto-discovery)
+ [La acción falla en los informes detectados automáticamente después de configurar criterios de éxito](#troubleshooting-success-auto-discovery)
+ [La detección automática genera informes que no deseo](#troubleshooting-unwanted-auto-discovery)
+ [La detección automática genera muchos informes pequeños para un único marco de pruebas](#troubleshooting-reports-combined)
+ [Los flujos de trabajo CI/CD que aparecen en la lista siguiente no coinciden con los del repositorio de origen](#troubleshooting-workflow-source)
+ [No puedo crear ni actualizar flujos de trabajo](#troubleshooting-workflows-branchrules)
## ¿Cómo corrijo los mensajes que indican que el flujo de trabajo está inactivo?
**Problema**: en la CodeCatalyst consola, en **CI/CD**, **Flujos de trabajo**, tu flujo de trabajo aparece con el siguiente mensaje:
`Workflow is inactive.`
Este mensaje indica que el archivo de definición del flujo de trabajo contiene un desencadenador que no se aplica a la ramificación en la que se encuentre actualmente. Por ejemplo, el archivo de definición de flujo de trabajo podría contener un desencadenador `PUSH` que haga referencia a su ramificación `main`, pero usted se encuentra en una ramificación de características. Como los cambios que realizas en la rama de funciones no se aplican a `main` las ejecuciones del flujo de trabajo en él ni lo iniciarán`main`, retira el flujo de CodeCatalyst trabajo de la rama y lo marca como tal. `Inactive`
**Posibles soluciones**:
Si quiere iniciar un flujo de trabajo en su ramificación de características, puede hacer lo siguiente:
+ En la ramificación de características, en el archivo de definición del flujo de trabajo, elimine la propiedad `Branches` de la sección `Triggers` para que tenga el siguiente aspecto:
```
Triggers:
- Type: PUSH
```
Esta configuración hace que el desencadenador se active cuando se envíe a cualquier ramificación, incluida la ramificación de características. Si el activador está activado, CodeCatalyst iniciará la ejecución de un flujo de trabajo con el archivo de definición del flujo de trabajo y los archivos fuente en la rama a la que esté accediendo.
+ En la ramificación de características, en el archivo de definición del flujo de trabajo, elimine la sección `Triggers` y ejecute el flujo de trabajo manualmente.
+ En la ramificación de características, en el archivo de definición del flujo de trabajo, cambie la sección `PUSH` para que haga referencia a la ramificación de características en lugar de a otra ramificación (como `main`, por ejemplo).
**importante**
Tenga cuidado de no confirmar estos cambios si no tiene intención de combinarlos para que vuelvan a formar parte de su ramificación `main`.
Para obtener más información sobre cómo editar el archivo de definición del flujo de trabajo, consulte [Creación de un flujo de trabajo](workflows-create-workflow.md).
Para obtener más información acerca de los desencadenadores, consulte [Inicio de un flujo de trabajo y ejecución automática mediante desencadenadores](workflows-add-trigger.md).
## ¿Cómo puedo corregir los errores de «La definición del flujo de trabajo tiene *n* errores»?
**Problema:** aparece alguno de los siguientes mensajes de error:
**Error 1:**
En **Integración y entrega continuas**, **Workflows** page, under your workflow's name, you see:
`Workflow definition has n errors`
**Error 2:**
Al editar un flujo de trabajo, se pulsa el botón **Validar** y aparece el siguiente mensaje en la parte superior de la CodeCatalyst consola:
`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`
**Error 3:**
Tras acceder a la página de detalles del flujo de trabajo, aparece el siguiente error en el campo de **Definición del flujo de trabajo**:
`n errors`
**Posibles soluciones**:
+ Elija **CI/CD**, elija **Flujos** de trabajo y elija el nombre del flujo de trabajo que contiene el error. En el campo **Definición del flujo de trabajo**, situado cerca de la parte superior, seleccione el enlace al error. Los detalles sobre el error aparecen en la parte inferior de la página. Siga los consejos de solución de problemas del error para solucionar el problema.
+ Asegúrese de que el archivo de definición del flujo de trabajo sea un archivo YAML.
+ Asegúrese de que las propiedades de YAML del archivo de definición del flujo de trabajo estén anidadas en el nivel correcto. Para ver cómo deben anidarse las propiedades en el archivo de definición del flujo de trabajo, consulte la [Definición de flujo de trabajo en YAML](workflow-reference.md) o la documentación de la acción correspondiente, a la que se puede acceder desde [Cómo añadir una acción a un flujo de trabajo](workflows-add-action.md).
+ Asegúrese de que se utilicen los caracteres de escape convenientes para los asteriscos (`*`) y otros caracteres especiales. Esos caracteres de escape pueden ser comillas simples o dobles. Por ejemplo:
```
Outputs:
Artifacts:
- Name: myartifact
Files:
- "**/*"
```
Para obtener más información sobre los caracteres especiales en el archivo de definición del flujo de trabajo, consulte [Pautas y convenciones de sintaxis](workflow-reference.md#workflow.terms.syntax.conv).
+ Asegúrese de que las propiedades de YAML del archivo de definición del flujo de trabajo sigan las reglas pertinentes sobre el uso de mayúsculas y minúsculas. Para obtener más información acerca de las reglas de mayúsculas y minúsculas, consulte [Pautas y convenciones de sintaxis](workflow-reference.md#workflow.terms.syntax.conv). Para determinar la composición correcta de cada propiedad, consulte la [Definición de flujo de trabajo en YAML](workflow-reference.md) o la documentación de la acción, a la que se puede acceder desde [Cómo añadir una acción a un flujo de trabajo](workflows-add-action.md).
+ Asegúrese de que la propiedad `SchemaVersion` esté presente y configurada en la versión correcta en el archivo de definición del flujo de trabajo. Para obtener más información, consulte [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Asegúrese de que la sección `Triggers` del archivo de definición del flujo de trabajo incluya todas las propiedades necesarias. Para determinar las propiedades necesarias, seleccione el desencadenador en el [editor visual](workflow.md#workflow.editors) y busque los campos en los que falte información, o consulte la documentación de referencia del desencadenador en la [Triggers](workflow-reference.md#triggers-reference).
+ Asegúrese de que la propiedad `DependsOn` del archivo de definición del flujo de trabajo esté configurada correctamente y no introduzca dependencias circulares. Para obtener más información, consulte [Secuenciación de acciones](workflows-depends-on.md).
+ Asegúrese de que la sección `Actions` del archivo de definición del flujo de trabajo incluya al menos una acción. Para obtener más información, consulte [Acciones](workflow-reference.md#actions-reference).
+ Asegúrese de que cada acción incluya todas las propiedades obligatorias. Para determinar las propiedades obligatorias, seleccione la acción en el [editor visual](workflow.md#workflow.editors) y busque los campos en los que falte información, o consulte la documentación de la acción, a la que se puede acceder desde [Cómo añadir una acción a un flujo de trabajo](workflows-add-action.md).
+ Asegúrese de que todos los artefactos de entrada tengan los artefactos de salida correspondientes. Para obtener más información, consulte [Definición de un artefacto de salida](workflows-working-artifacts-output.md).
+ Asegúrese de que las variables definidas en una acción se exporten para poder utilizarlas en otras acciones. Para obtener más información, consulte [Exportación de una variable para que otras acciones puedan utilizarla](workflows-working-with-variables-export-input.md).
## ¿Cómo puedo corregir los errores «No se pueden localizar las credenciales» y ExpiredToken «»?
**Problema**: mientras trabaja en [Tutorial: implementación de una aplicación en Amazon EKS](deploy-tut-eks.md), ve uno de los siguientes mensajes de error o los dos en la ventana del terminal de su equipo de desarrollo:
`Unable to locate credentials. You can configure credentials by running "aws configure".`
`ExpiredToken: The security token included in the request is expired`
**Posibles soluciones**:
Estos errores indican que las credenciales que utilizas para acceder a AWS los servicios han caducado. En este caso, no ejecute el comando `aws configure`. En su lugar, sigue las siguientes instrucciones para actualizar la clave de AWS acceso y el token de sesión.
**Para actualizar la clave de AWS acceso y el token de sesión**
1. Asegúrese de tener la URL del portal de AWS acceso, el nombre de usuario y la contraseña del usuario que está utilizando en el tutorial completo de Amazon EKS (`codecatalyst-eks-user`). Debería haber configurado estos elementos cuando completó la parte [Paso 1: configuración de la máquina de desarrollo](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) del tutorial.
**nota**
Si no dispone de esta información, vaya a la página de detalles de `codecatalyst-eks-user` en IAM Identity Center, elija **Restablecer contraseña**, **Generar una contraseña de un solo uso [...]** y de nuevo **Restablecer contraseña** para que aparezca la información en la pantalla.
1. Realice una de las siguientes acciones:
+ Pegue la URL del portal de AWS acceso en la barra de direcciones de su navegador.
O
+ Actualice la página del portal de AWS acceso si ya está cargada.
1. Inicie sesión con el nombre de usuario y la contraseña de `codecatalyst-eks-user` si todavía no lo ha hecho.
1. Elija **Cuenta de AWS** y, a continuación, elija el nombre de la Cuenta de AWS a la que asignó el usuario `codecatalyst-eks-user` y el conjunto de permisos.
1. Junto al nombre configurado del permiso (`codecatalyst-eks-permission-set`), seleccione **Línea de comandos o acceso mediante programación**.
1. Copie los comandos del centro de la página. Tendrán un aspecto similar al siguiente:
```
export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
export AWS_SESSION_TOKEN="session-token"
```
... donde *session-token* hay una cadena aleatoria larga.
1. Pegue los comandos en el símbolo del terminal de su equipo de desarrollo y pulse Intro.
Se cargan las nuevas claves y el token de sesión.
Ya ha actualizado sus credenciales. Los `kubectl` comandos AWS CLI`eksctl`, y deberían funcionar ahora.
## ¿Cómo puedo corregir los errores de tipo Unable to connect to the server?
**Problema**: mientras trabaja en el tutorial descrito en [Tutorial: implementación de una aplicación en Amazon EKS](deploy-tut-eks.md), ve un mensaje de error similar al siguiente en la ventana del terminal de su equipo de desarrollo:
`Unable to connect to the server: dial tcp: lookup long-string.gr7.us-west-2.eks.amazonaws.com on 1.2.3.4:5: no such host`
**Posibles soluciones**:
Este error suele indicar que las credenciales que utiliza la utilidad `kubectl` para conectarse al clúster de Amazon EKS han caducado. Para solucionar el problema, actualice las credenciales especificando el siguiente comando en el símbolo del terminal:
```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```
Donde:
+ *codecatalyst-eks-cluster*se sustituye por el nombre de su clúster de Amazon EKS.
+ *us-west-2*se sustituye por la AWS región en la que está desplegado el clúster.
## ¿Por qué faltan CodeDeploy campos en el editor visual?
**Problema**: está utilizando una acción de [implementación en Amazon ECS](deploy-action-ecs.md) y no ve los CodeDeploy campos, como **CodeDeploy AppSpec**en el editor visual del flujo de trabajo. Este problema puede deberse a que el servicio de Amazon ECS que especificó en el campo **Servicio** no está configurado para realizar implementaciones azul/verde.
**Posibles soluciones**:
+ Elija un servicio de Amazon ECS diferente en la pestaña **Configuración** de la acción **Deploy to Amazon ECS**. Para obtener más información, consulte [Implementación en Amazon ECS con un flujo de trabajo](deploy-action-ecs.md).
+ Configure el servicio Amazon ECS seleccionado para realizar blue/green las implementaciones. Para obtener más información sobre la configuración de blue/green las implementaciones, consulte [Implementación azul/verde con](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) en CodeDeploy la Guía para desarrolladores de *Amazon Elastic Container Service*.
## ¿Cómo puedo corregir los errores de las capacidades de IAM?
**Problema**: estás utilizando una acción de [despliegue de CloudFormation pila](deploy-action-cfn.md) y la ves `##[error] requires capabilities: [capability-name]` en los registros de la acción de **despliegue de CloudFormation pila**.
**Posibles soluciones**: complete el siguiente procedimiento para agregar la capacidad al archivo de definición del flujo de trabajo. Para obtener más información sobre las capacidades de IAM, consulte [Reconocimiento de los recursos de IAM en CloudFormation las plantillas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) de la Guía del usuario de *IAM*.
------
#### [ Visual ]
**Adición de una capacidad de IAM mediante el editor visual**
1. [Abra la CodeCatalyst consola en https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **Visual**.
1. En el diagrama de flujo de trabajo, seleccione la acción **Deploy CloudFormation stack**.
1. Elija la pestaña **Configuración**.
1. En la parte inferior, seleccione **Avanzado (opcional)**.
1. En la lista desplegable **Capacidades**, seleccione la casilla de verificación junto a la capacidad mencionada en el mensaje de error. Si la capacidad no está disponible en la lista, use el editor de YAML para añadirla.
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
1. Si la ejecución de un nuevo flujo de trabajo no se inicia automáticamente, ejecútelo manualmente para comprobar si los cambios corrigen el error. Para obtener más información acerca de la ejecución manual de flujos de trabajo, consulte [Inicio manual de la ejecución de un flujo de trabajo](workflows-manually-start.md).
------
#### [ YAML ]
**Adición de una capacidad de IAM mediante el editor de YAML**
1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **YAML**.
1. En la acción **Implementar CloudFormation pila**, añade una `capabilities` propiedad, como esta:
```
DeployCloudFormationStack:
Configuration:
capabilities: capability-name
```
*capability-name*Sustitúyala por el nombre de la capacidad de IAM que aparece en el mensaje de error. Utilice comas y no utilice espacios para enumerar varias capacidades. Para obtener más información, consulte la descripción de la propiedad `capabilities` en la [Acción «Desplegar CloudFormation pila» YAML](deploy-action-ref-cfn.md).
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
1. Si la ejecución de un nuevo flujo de trabajo no se inicia automáticamente, ejecútelo manualmente para comprobar si los cambios corrigen el error. Para obtener más información acerca de la ejecución manual de flujos de trabajo, consulte [Inicio manual de la ejecución de un flujo de trabajo](workflows-manually-start.md).
------
## ¿Cómo puedo corregir los errores npm install?
**Problema**: la [acción AWS CDK deploy](cdk-dep-action.md) o la [acción AWS CDK bootstrap](cdk-boot-action.md) fallan y se produce un error `npm install`. Este error puede producirse porque estás almacenando las dependencias de tu AWS CDK aplicación en un registro de administrador de paquetes de nodos privados (npm) al que no se puede acceder mediante la acción.
**Posibles soluciones**: sigue las siguientes instrucciones para actualizar el `cdk.json` archivo de tu AWS CDK aplicación con información adicional de registro y autenticación.
**Antes de empezar**
1. Cree secretos para su información de autenticación. Hará referencia a estos secretos en el archivo `cdk.json` en lugar de proporcionar los equivalentes en texto sin cifrar. Pasos para crear los secretos:
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Secretos**.
1. Cree dos secretos con las propiedades siguientes:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Para obtener más información acerca de los secretos, consulte [Enmascaramiento de datos mediante secretos](workflows-secrets.md).
1. Agrega los secretos como variables de entorno a tu acción. AWS CDK La acción reemplazará las variables por valores reales cuando se ejecute. Para añadir los secretos:
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **Visual**.
1. En el diagrama de flujo de trabajo, elige tu AWS CDK acción.
1. Seleccione la pestaña **Entradas**.
1. Añada dos variables con las siguientes propiedades:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Ahora tiene dos variables que contienen referencias a secretos.
Su código de YAML de definición del flujo de trabajo debería tener un aspecto similar al siguiente:
**nota**
El siguiente ejemplo de código proviene de una acción **AWS CDK bootstrap**; una acción **AWS CDK deploy** tendrá un aspecto similar.
```
Name: CDK_Bootstrap_Action
SchemaVersion: 1.0
Actions:
CDKBootstrapAction:
Identifier: aws/cdk-bootstrap@v2
Inputs:
Variables:
- Name: NPMUSER
Value: ${Secrets.npmUsername}
- Name: NPMTOKEN
Value: ${Secrets.npmAuthToken}
Sources:
- WorkflowSource
Environment:
Name: Dev2
Connections:
- Name: account-connection
Role: codecatalystAdmin
Configuration:
Parameters:
Region: "us-east-2"
```
Ahora ya lo tiene todo listo para usar las variables `NPMUSER` y `NPMTOKEN` del archivo `cdk.json`. Vaya al siguiente procedimiento.
**Actualización del archivo cdk.json**
1. Cambie al directorio raíz del AWS CDK proyecto y abra el `cdk.json` archivo.
1. Busque la `"app":` propiedad y cámbiela para incluir el código que se muestra en*red italics*:
**nota**
El siguiente código de ejemplo proviene de un TypeScript proyecto. Si utilizas un JavaScript proyecto, el código tendrá un aspecto similar, aunque no idéntico.
```
{
"app": "npm set registry=https://your-registry/folder/CDK-package/ --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:always-auth=true --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:_authToken=\"${NPMUSER}\":\"${NPMTOKEN}\" && npm install && npx ts-node --prefer-ts-exts bin/hello-cdk.ts|js",
"watch": {
"include": [
"**"
],
"exclude": [
"README.md",
"cdk*.json",
"**/*.d.ts",
"**/*.js",
"tsconfig.json",
"package*.json",
...
```
1. En el código resaltado en*red italics*, sustituya:
+ *your-registry/folder/CDK-package/*con la ruta a las dependencias de su AWS CDK proyecto en su registro privado.
+ *hello-cdk.ts\$1.js*con el nombre del archivo de puntos de entrada. Puede ser un archivo `.ts` (TypeScript) o `.js` (JavaScript) según el idioma que utilices.
**nota**
La acción reemplazará *NPMTOKEN* las variables *NPMUSER* y por el nombre de usuario y el token de acceso de npm que especificaste en **Secrets**.
1. Guarde el archivo `cdk.json`.
1. Vuelva a ejecutar la acción manualmente para comprobar si los cambios corrigen el error. Para obtener más información acerca de la ejecución manual de acciones, consulte [Inicio manual de la ejecución de un flujo de trabajo](workflows-manually-start.md).
## ¿Por qué varios flujos de trabajo tienen el mismo nombre?
Los flujos de trabajo se almacenan por ramificación y repositorio. Dos flujos de trabajo diferentes pueden tener el mismo nombre si existen en ramificaciones diferentes. En la página Flujos de trabajo, puede diferenciar los flujos de trabajo del mismo nombre consultando el nombre de la ramificación. Para obtener más información, consulte [Cómo organizar tu trabajo con el código fuente con las sucursales de Amazon CodeCatalyst](source-branches.md).
![\[Ramificación de flujo de trabajo\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/images/flows/workflow-branch.png)
## ¿Puedo almacenar mis archivos de definición de flujo de trabajo en otra carpeta?
No, debe almacenar todos los archivos de definición de flujos de trabajo en la carpeta `.codecatalyst/workflows` o en las subcarpetas de esa carpeta. Si utiliza un repositorio mono con varios proyectos lógicos, coloque todos los archivos de definición de flujo de trabajo en la carpeta `.codecatalyst/workflows` o en una de sus subcarpetas y, a continuación, utilice el campo **Archivos cambiados** (editor visual) o la propiedad `FilesChanged` (editor de YAML) dentro de un desencadenador para activar el flujo de trabajo automáticamente en una ruta de proyecto específica. Para obtener más información, consulte [Adición de desencadenadores a flujos de trabajo](workflows-add-trigger-add.md) y [Ejemplo: Desencadenador con inserción, ramificaciones y archivos](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).
## ¿Cómo añado acciones en secuencia a mi flujo de trabajo?
De forma predeterminada, cuando añade una acción a un flujo de trabajo, no tendrá dependencias y se ejecutará en paralelo con otras acciones.
Si desea organizar las acciones en secuencia, puede establecer una dependencia de otra acción configurando el campo `DependsOn`. También puede configurar una acción para que consuma artefactos o variables que sean el resultado de otras acciones. Para obtener más información, consulte [Secuenciación de acciones](workflows-depends-on.md).
## ¿Por qué mi flujo de trabajo se valida correctamente, pero falla en tiempo de ejecución?
Si ha validado su flujo de trabajo con el botón `Validate`, pero el flujo de trabajo ha fallado de todos modos, podría deberse a una limitación en el validador.
Los errores relacionados con un CodeCatalyst recurso, como secretos, entornos o flotas, en la configuración del flujo de trabajo no se registrarán durante la confirmación. Si se utiliza alguna referencia que no sea válida, el error solo se identificará cuando se ejecute un flujo de trabajo. Del mismo modo, si hay algún error en la configuración de la acción, como la falta de un campo obligatorio o errores tipográficos en los atributos de la acción, solo se identificará cuando se ejecute el flujo de trabajo. Para obtener más información, consulte [Creación de un flujo de trabajo](workflows-create-workflow.md).
## La detección automática no detecta informes para una acción
**Problema:** configuré la detección automática para una acción que ejecuta pruebas, pero no detecta ningún informe. CodeCatalyst
**Posibles soluciones:** esto puede deberse a varios problemas. Pruebe una o varias de las siguientes soluciones:
+ Asegúrese de que la herramienta utilizada para ejecutar las pruebas produzca resultados en uno de los formatos más adecuados CodeCatalyst . Por ejemplo, si desea `pytest` CodeCatalyst permitir la detección de informes de cobertura de código y pruebas, incluya los siguientes argumentos:
```
--junitxml=test_results.xml --cov-report xml:test_coverage.xml
```
Para obtener más información, consulte [Tipos de informes de calidad](test-workflow-actions.md#test-reporting).
+ Asegúrese de que la extensión del archivo de salida sea coherente con el formato elegido. Por ejemplo, al configurar `pytest` para producir resultados en el formato `JUnitXML`, compruebe que la extensión del archivo sea `.xml`. Para obtener más información, consulte [Tipos de informes de calidad](test-workflow-actions.md#test-reporting).
+ Asegúrese de que `IncludePaths` esté configurado para incluir todo el sistema de archivos (`**/*`), a menos que excluya determinadas carpetas a propósito. Del mismo modo, asegúrese de que `ExcludePaths` no excluya los directorios en los que espere que se encuentren los informes.
+ Si ha configurado manualmente un informe para usar un archivo de salida específico, se excluirá de la detección automática. Para obtener más información, consulte [Ejemplo de informes de calidad en YAML](test-config-action.md#test.success-criteria-example).
+ Es posible que la detección automática no encuentre los informes porque la acción falló antes de que se generara ningún resultado. Por ejemplo, es posible que la compilación haya fallado antes de ejecutar las pruebas unitarias.
## La acción falla en los informes detectados automáticamente después de configurar criterios de éxito
**Problema:** cuando habilito la detección automática y configuro los criterios de éxito, algunos de los informes no cumplen los criterios de éxito y, como resultado, la acción falla.
**Posibles soluciones:** para solucionar este problema, pruebe una o varias de las siguientes soluciones:
+ Modifique `IncludePaths` o `ExcludePaths` para excluir los informes que no le interesen.
+ Actualice los criterios de éxito para permitir que se aprueben todos los informes. Por ejemplo, si se detectaron dos informes, uno con una cobertura de línea del 50 % y otro del 70 %, ajuste la cobertura mínima de línea al 50 %. Para obtener más información, consulte [Criterios de éxito](test-best-practices.md#test.best-success-criteria)
+ Convierta el informe fallido en un informe configurado manualmente. Esto le permite configurar diferentes criterios de éxito para ese informe específico. Para obtener más información, consulte [Configuración de los criterios de éxito de los informes](test-config-action.md#test.success-criteria).
## La detección automática genera informes que no deseo
**Problema:** cuando habilito la detección automática, se generan informes que no quiero. Por ejemplo, CodeCatalyst genera informes de cobertura de código para los archivos incluidos en las dependencias de mi aplicación almacenadas en`node_modules`.
**Posibles soluciones:** puede ajustar la configuración de `ExcludePaths` para que se excluyan los archivos no deseados. Por ejemplo, para excluir `node_modules`, añada `node_modules/**/*`. Para obtener más información, consulte [Inclusión/exclusión de rutas](test-best-practices.md#test.best-include-exclude).
## La detección automática genera muchos informes pequeños para un único marco de pruebas
**Problema:** cuando utilizo ciertos marcos de informes de cobertura de código y pruebas, he observado que la detección automática genera una gran cantidad de informes. Por ejemplo, cuando utilizo el [complemento Maven Surefire](https://maven.apache.org/surefire/maven-surefire-plugin/), la detección automática produce un informe diferente para cada clase de prueba.
**Posibles soluciones:** es posible que su marco pueda combinar los resultados en un solo archivo. Por ejemplo, si está utilizando el complemento Maven Surefire, puede usar `npx junit-merge` para combinar los archivos manualmente. La expresión completa puede tener un aspecto similar al siguiente:
```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```
## Los flujos de trabajo CI/CD que aparecen en la lista siguiente no coinciden con los del repositorio de origen
**Problema:** los flujos de trabajo que aparecen en **Integración y entrega continuas**, en la página **Flujos de trabajo**, no coinciden con los de la carpeta `~/.codecatalyst/workflows/` del [repositorio de código fuente](source.md). Podría ver las siguientes faltas de coincidencia:
+ En la página **Flujos de trabajo** aparece un flujo de trabajo, pero el archivo de definición de flujo de trabajo correspondiente no existe en el repositorio de código fuente.
+ Existe un archivo de definición de flujo de trabajo en el repositorio de código fuente, pero no aparece un flujo de trabajo correspondiente en la página **Flujos de trabajo**.
+ Existe un flujo de trabajo tanto en el repositorio de código fuente como en la página de **Flujos de trabajo**, pero ambos son diferentes.
Este problema puede producirse si la página de **Flujos de trabajo** no ha tenido tiempo de actualizarse o si se ha superado una cuota de flujo de trabajo.
**Posibles soluciones**:
+ Espere. Por lo general, tiene que esperar dos o tres segundos después de llevar a cabo una confirmación en un origen antes de poder ver el cambio en la página de **Flujos de trabajo**.
+ Si ha superado una cuota de flujo de trabajo, realice una de las siguientes acciones:
**nota**
Para determinar si se ha superado una cuota de flujo de trabajo, revise [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md) y coteje las cuotas documentadas con los flujos de trabajo del repositorio de código fuente o de la página **Flujos de trabajo**. No hay ningún mensaje de error que indique que se ha superado una cuota, por lo que tendrá que investigar por su cuenta.
+ Si ha superado la cuota de **Número máximo de flujos de trabajo por espacio**, elimine algunos flujos de trabajo y lleve a cabo una confirmación de prueba con el archivo de definición del flujo de trabajo. Un ejemplo de confirmación de prueba podría ser añadir un espacio al archivo.
+ Si ha superado la cuota de **Tamaño de archivo máximo de definición de flujo de trabajo**, cambia el archivo de definición de flujo de trabajo para reducir su longitud.
+ Si ha superado la cuota de **Número máximo de archivos de flujo de trabajo procesados en un solo origen**, realice varias confirmaciones de prueba. Modifique menos flujos de trabajo que el número máximo en cada confirmación.
## No puedo crear ni actualizar flujos de trabajo
**Problema:** quiero crear o actualizar un flujo de trabajo, pero aparece un error al intentar realizar el cambio.
**Soluciones posibles:** en función de su rol en el proyecto o el espacio, es posible que no tenga permisos para incorporar código en los repositorios de código fuente del proyecto. Los archivos YAML de los flujos de trabajo se almacenan en repositorios. Para obtener más información, consulte [Archivos de definición de flujo de trabajo](workflows-concepts.md#workflows-concepts-workflows-def). El rol **Administrador del espacio**, el rol **Administrador del proyecto** y el rol **Colaborador** tienen permiso para confirmar e insertar código en los repositorios de un proyecto.
Si tiene el rol **Colaborador**, pero no puede crear ni confirmar cambios en el YAML de un flujo de trabajo de una ramificación específica, es posible que haya una regla de ramificación configurada para esa ramificación específica que impida a los usuarios con ese rol incorporar código en esa ramificación en particular. Pruebe a crear un flujo de trabajo en una ramificación diferente o a confirmar los cambios en una ramificación diferente. Para obtener más información, consulte [Administración de las acciones permitidas para una ramificación con reglas de ramificación](source-branches-branch-rules.md).
# Solución de problemas con incidencias
La siguiente información puede ayudarte a solucionar problemas comunes relacionados con problemas de. CodeCatalyst
**Topics**
+ [No puedo elegir alguien a quien asignar una incidencia](#troubleshooting-issues-assignees)
## No puedo elegir alguien a quien asignar una incidencia
**Problema:** al crear una incidencia, la lista de asignatarios está vacía.
**Posibles soluciones:** la lista de personas asignadas está directamente vinculada a CodeCatalyst los usuarios que figuran como miembros del proyecto. Para comprobar que el acceso al perfil de usuario funcione correctamente, elija el icono del perfil y seleccione **Perfil de usuario**. Si la información del perfil de usuario no aparece, consulte el informe de estado para ver si hay algún incidente. Si la información aparece, cree un ticket de servicio.
# Solución de problemas con la búsqueda en CodeCatalyst
Consulta las siguientes secciones para solucionar problemas relacionados con las búsquedas en. CodeCatalyst Para obtener más información acerca de los flujos de trabajo, consulte [Búsqueda de código, incidencias, proyectos y usuarios en CodeCatalystBúsqueda de código, incidencias, proyectos y usuarios](search.md).
**Topics**
+ [No logro encontrar un usuario en mi proyecto](#troubleshooting-search-users)
+ [No veo lo que busco en mi proyecto o espacio](#troubleshooting-missing-results)
+ [El número de resultados de búsqueda cambia constantemente cuando navego por las páginas](#troubleshooting-search-results)
+ [Mi consulta de búsqueda no se completa](#troubleshooting-requests-limits)
## No logro encontrar un usuario en mi proyecto
**Problema:** cuando intento ver los detalles de un usuario, no veo su información en el proyecto.
**Posibles soluciones:** actualmente, la búsqueda no permite buscar usuarios dentro de un proyecto. Para buscar usuarios con acceso a tu espacio, cambia a **Este espacio** en QuickSearch o elimina los filtros de proyecto que hayas especificado mediante el lenguaje de consultas avanzadas.
## No veo lo que busco en mi proyecto o espacio
**Problema:** los resultados no aparecen cuando intento buscar información concreta.
**Posibles soluciones:** es probable que las actualizaciones de contenido tarden unos segundos en aparecer en los resultados de búsqueda. Las actualizaciones de gran tamaño pueden tardar varios minutos.
En el caso de aquellos recursos que no se hayan actualizado recientemente, es posible que tenga que afinar la búsqueda. Puede afinarla agregando más palabras clave o utilizando el lenguaje de consulta avanzado. Para obtener más información sobre cómo afinar sus consultas, consulte [Delimitación de la consulta de búsqueda](search.md#search-query-language-examples).
## El número de resultados de búsqueda cambia constantemente cuando navego por las páginas
**Problema:** el número de resultados de la búsqueda parece cambiar cuando paso a la página siguiente, por lo que no está claro cuántos resultados hay en total.
**Posibles soluciones:** al navegar por las páginas de resultados de búsqueda, es posible que vea un cambio en el número de resultados de búsqueda coincidentes con su consulta. Es posible que el número de resultados se actualice para reflejar una cantidad más precisa de coincidencias detectadas al navegar por las páginas.
A medida que navegue por los resultados, es posible que aparezca el siguiente mensaje: **No hay resultados para “prueba”**. Recibirá el mensaje si no se tiene acceso a los resultados restantes.
## Mi consulta de búsqueda no se completa
**Problema:** los resultados de mi consulta de búsqueda no aparecen y parece que está tardando demasiado.
**Posibles soluciones:** es posible que la búsqueda no se complete si se están realizando muchas búsquedas al mismo tiempo en el espacio, ya sea mediante programación o debido a una alta actividad del equipo. Si realiza búsquedas programáticas, póngalas en pausa o redúzcalas. De lo contrario, vuelva a inténtalo en unos segundos.
# Solución de problemas con extensiones
Consulta las siguientes secciones para solucionar problemas relacionados con las extensiones en. CodeCatalyst Para obtener más información acerca de las extensiones, consulte [Añada funcionalidad a los proyectos con extensiones en CodeCatalystAdición de funcionalidad a proyectos mediante extensiones](extensions.md).
**Topics**
+ [No puedo ver los cambios en repositorios de terceros vinculados ni buscar los resultados de esos cambios](#troubleshooting-detect-3p-changes)
## No puedo ver los cambios en repositorios de terceros vinculados ni buscar los resultados de esos cambios
**Problema:** Los cambios en mi repositorio de terceros no aparecen en. CodeCatalyst
**Posibles soluciones:** CodeCatalyst actualmente 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, a continuación, 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](extensions-link.md).
# Solución de problemas con las cuentas asociadas a un espacio
En CodeCatalyst, puedes añadir un espacio Cuenta de AWS a tu espacio para conceder permisos a los recursos y con fines de facturación. La siguiente información puede ayudarte a solucionar problemas comunes con las cuentas asociadas en CodeCatalyst.
**Topics**
+ [Mi solicitud de Cuenta de AWS conexión recibe un error de token no válido](#troubleshooting-connection-token)
+ [CodeCatalyst El flujo de trabajo de mi proyecto de Amazon falla debido a un error en la cuenta, el entorno o el rol de IAM configurados](#connections-troubleshoot-workflow)
+ [Necesito una cuenta, un rol y un entorno asociados para crear un proyecto](#connections-troubleshoot-environment)
+ [No puedo acceder a la página de Amazon CodeCatalyst Spaces en Consola de administración de AWS](#connections-troubleshoot-console)
+ [Quiero una cuenta diferente como cuenta de facturación](#connections-troubleshoot-billing)
+ [El flujo de trabajo de mi proyecto falla debido a un error en el nombre de la conexión](#connections-troubleshoot-restriction)
## Mi solicitud de Cuenta de AWS conexión recibe un error de token no válido
**Problema:** al crear una solicitud de conexión con un token de conexión, la página no lo acepta y muestra un error que indica que el token no es válido.
**Posibles soluciones:** asegúrese de proporcionar el ID de cuenta que quiera agregar al espacio. Debe disponer de permisos administrativos Cuenta de AWS o poder trabajar con su administrador para añadir la cuenta.
Cuando decida verificar la cuenta, se abrirá una nueva ventana del navegador en la Consola de administración de AWS. Es necesario haber iniciado sesión con la misma cuenta también en la consola. Vuelva a intentarlo después de comprobar lo siguiente:
+ Ha iniciado sesión Consola de administración de AWS con los mismos datos Cuenta de AWS que desea añadir a su espacio.
+ Ha iniciado sesión Consola de administración de AWS con la región configurada como la región correcta para su espacio.
+ Si ha llegado desde la página de facturación y quiere añadir la Cuenta de AWS como cuenta de facturación específica para el espacio, asegúrese de que la cuenta no haya alcanzado el límite de facturación de otro espacio o espacios.
## CodeCatalyst El flujo de trabajo de mi proyecto de Amazon falla debido a un error en la cuenta, el entorno o el rol de IAM configurados
**Problema:** cuando el flujo de trabajo se ejecuta y no encuentra una cuenta configurada o roles de IAM asociados a su espacio, debe rellenar los campos de rol, conexión y entorno manualmente en el flujo de trabajo de YAML. Consulte la acción del flujo de trabajo fallida y observe si los mensajes de error son los siguientes:
+ El rol no está disponible para su uso con la conexión asociada al entorno.
+ La acción no se ha realizado correctamente. Estado: ERROR; el valor proporcionado para la conexión o el entorno de la cuenta no es válido. Compruebe que la conexión esté asociada a su espacio y que el entorno esté asociado a su proyecto.
+ La acción no se ha realizado correctamente. Estado: ERROR; el valor proporcionado para el rol de IAM no es válido. Comprueba que el nombre existe, que la función de IAM se haya añadido a la conexión de tu cuenta y que la conexión ya esté asociada a tu espacio de Amazon CodeCatalyst
**Posibles soluciones:** asegúrese de que los campos de YAML del flujo de trabajo tengan valores precisos para [Entorno](build-action-ref.md#build.environment), [Conexiones](build-action-ref.md#build.environment.connections) y [Rol](build-action-ref.md#build.environment.connections.role). Las acciones del CodeCatalyst flujo de trabajo que requieren un entorno son las acciones de creación o despliegue que ejecuten AWS recursos o que generen pilas AWS de recursos.
Elija el bloque de acciones del flujo de trabajo fallido y seleccione **Visual**. Elija la pestaña **Configuración**. Si los campos **Entorno**, **Nombre de la conexión** y **Nombre del rol** no están rellenados, tendrá que actualizar manualmente el flujo de trabajo. Siga estos pasos para editar el YAML de su flujo de trabajo:
+ Expanda el directorio `/.codecatalyst` y, a continuación, expanda el directorio `/workflows`. Abra el archivo YAML del flujo de trabajo. Asegúrese de que los roles de IAM y la información de la cuenta estén especificados en el YAML que haya configurado para su flujo de trabajo. Ejemplo:
```
Actions:
cdk_bootstrap:
Identifier: action-@v1
Inputs:
Sources:
- WorkflowSource
Environment:
Name: Staging
Connections:
- Name: account-connection
Role: build-role
```
Las propiedades de **entorno, conexión y rol** son necesarias para ejecutar acciones de creación e implementación del CodeCatalyst flujo de trabajo con AWS recursos. Para ver un ejemplo, consulta los parámetros YAML de referencia de la acción de CodeCatalyst compilación para [el entorno](build-action-ref.md#build.environment), [las conexiones](build-action-ref.md#build.environment.connections) y el [rol](build-action-ref.md#build.environment.connections.role).
+ Asegúrese de que su espacio tenga una cuenta agregada y de que la cuenta tenga el rol o roles de IAM adecuados agregados a la cuenta. Puede ajustar o agregar cuentas si tiene el rol de **Administrador del espacio**. Para obtener más información, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md).
## Necesito una cuenta, un rol y un entorno asociados para crear un proyecto
**Problema:** en las opciones de creación de proyectos, mi proyecto no tiene una cuenta adicional disponible en mi espacio o necesito añadir otra cuenta a mi espacio para que la use mi proyecto.
**Correcciones posibles:** para tu espacio, puedes añadir permisos Cuentas de AWS para añadirlos a tu proyecto si tienes el rol de **administrador del espacio**. También debe tener una Cuenta de AWS en la que tenga permisos administrativos o pueda trabajar con su administrador de AWS .
Para asegurarse de que haya una cuenta y un rol disponibles en la pantalla de creación del proyecto, primero debe agregar la cuenta y los roles. Para obtener más información, consulte [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md).
Tiene la opción de elegir crear un rol de servicio con una política de roles denominada política de roles **CodeCatalystWorkflowDevelopmentRole-*spaceName***. El rol tendrá un nombre `CodeCatalystWorkflowDevelopmentRole-spaceName` con un identificador único adjunto. Para obtener más información sobre los roles y la política de roles, consulte [El funcionamiento del rol de servicio **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role). Si desea saber cuáles son los pasos para crear el rol, consulte [Creación del rol **CodeCatalystWorkflowDevelopmentRole-*spaceName*** para su cuenta y su espacio](ipa-iam-roles.md#ipa-iam-roles-service-create). El rol se añade a tu cuenta y está disponible en las páginas de creación de proyectos de CodeCatalyst.
## No puedo acceder a la página de Amazon CodeCatalyst Spaces en Consola de administración de AWS
**Problema:** Cuando intento acceder a la CodeCatalyst página de Amazon en Consola de administración de AWS para añadir una cuenta a mi CodeCatalyst espacio o añadir funciones a una cuenta en AWS, recibo un error de permisos.
**Posibles soluciones**:
Para tu espacio, puedes añadir permisos Cuentas de AWS para añadirlos a tu proyecto si tienes el rol de **administrador del espacio**. También debe tener una Cuenta de AWS en la que tenga permisos administrativos o pueda trabajar con su administrador de AWS . Primero debes asegurarte de haber iniciado sesión en el Consola de administración de AWS con la misma cuenta que deseas administrar. Una vez que haya iniciado sesión en Consola de administración de AWS, podrá abrir la consola e intentarlo de nuevo.
¿Abrir la CodeCatalyst página de Amazon Consola de administración de AWS en [https://us-west-2.console.aws.amazon.com/codecatalyst/casa? región=uso-oeste-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).
## Quiero una cuenta diferente como cuenta de facturación
**Problema:** Cuando configuré mi CodeCatalyst nombre de usuario, realicé varios pasos para configurar mi espacio y asociar a un usuario autorizado. Cuenta de AWS Ahora, quiero autorizar una cuenta diferente para la facturación.
**Posibles soluciones:** para su espacio, puede autorizar las cuentas de facturación si tiene el rol de **Administrador del espacio**. También debes tener un Cuenta de AWS lugar en el que tengas permisos administrativos o puedas trabajar con tu AWS administrador.
Para obtener más información, consulta [Gestión de la facturación](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) en la Guía del CodeCatalyst administrador de Amazon.
## El flujo de trabajo de mi proyecto falla debido a un error en el nombre de la conexión
**Problema:** al crear un proyecto y ejecutar posteriormente el flujo de trabajo del proyecto, el flujo de trabajo falla y muestra un error que indica que el nombre de la conexión no es válido, como se muestra a continuación:
Error en : el nombre de la conexión no es válido.
**Posibles soluciones:** asegúrese de proporcionar el ID de cuenta que quiera agregar a su espacio y asegúrese de que la cuenta no esté habilitada para conexiones de cuentas restringidas por proyectos. Si la cuenta está habilitada para las conexiones de cuentas restringidas por proyectos, es posible que tenga que actualizar la conexión de la cuenta habilitando el acceso al nuevo proyecto. Para obtener más información, consulte [Configuring project-restricted account connections](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).
# Solución de problemas entre Amazon CodeCatalyst y los AWS SDK o la AWS CLI
La siguiente información puede ayudarle a solucionar problemas habituales al trabajar con CodeCatalyst y la AWS CLI o los AWS SDK.
**Topics**
+ [Cuando introduzco **aws codecatalyst** en una línea de comandos o en un terminal, recibo un mensaje de error que indica que la elección no es válida](#cli-sdk-troubleshoot-no-commands)
+ [Recibo un error de credenciales al ejecutar comandos de **aws codecatalyst**](#cli-sdk-troubleshoot-profile)
## Cuando introduzco **aws codecatalyst** en una línea de comandos o en un terminal, recibo un mensaje de error que indica que la elección no es válida
**Problema:** cuando intento usar la AWS CLI con CodeCatalyst, uno o varios de los comandos de **aws codecatalyst** no se reconocen como válidos.
**Solución:** la causa más común de este problema es que está utilizando una versión de la AWS CLI que no contiene las actualizaciones más recientes de los servicios y comandos más recientes. Actualice la instalación de la AWS CLI e inténtelo de nuevo. Para obtener más información consulte () [Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md).
## Recibo un error de credenciales al ejecutar comandos de **aws codecatalyst**
**Problema:** cuando intento usar la AWS CLI con CodeCatalyst, recibo un mensaje que indica `You can configure credentials by running "aws configure".` o `Unable to locate authorization token`.
**Solución:** debe configurar un perfil de la AWS CLI para que funcione con los comandos de CodeCatalyst. Para obtener más información consulte () [Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md).