Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Risoluzione dei problemi con Amazon CodeCatalyst
Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni in. CodeCatalyst Puoi anche utilizzare il report sullo CodeCatalyst stato di salute di Amazon per determinare se ci sono problemi di servizio che potrebbero influire sulla tua esperienza.
**Topics**
+ [Risoluzione dei problemi generali di accesso](#troubleshooting-general)
+ [Risoluzione dei problemi di supporto](#troubleshoot-support)
+ [Amazon CodeCatalyst non è disponibile in tutto o in parte](#service-unavailable)
+ [Non riesco a creare un progetto in CodeCatalyst](#troubleshoot-create-project)
+ [Non riesco ad accedere al mio spazio BID come nuovo utente o non posso essere aggiunto come nuovo utente SSO a causa del nome utente troncato](#troubleshoot-username-truncated)
+ [L'aggiunta di un utente SSO al mio spazio federato come nuovo utente ha creato un utente duplicato](#troubleshoot-username-duplicated-SSO)
+ [Voglio inviare un feedback in CodeCatalyst](#troubleshoot-create-feedback)
+ [Risoluzione dei problemi relativi ai repository di origine](troubleshooting-source.md)
+ [Risoluzione dei problemi relativi a progetti e blueprint](projects-troubleshooting.md)
+ [Risoluzione dei problemi con gli ambienti di sviluppo](devenvironments-troubleshooting.md)
+ [Risoluzione dei problemi relativi ai flussi di lavoro](troubleshooting-workflows.md)
+ [Risoluzione dei problemi relativi ai problemi](troubleshooting-issues.md)
+ [Risoluzione dei problemi relativi alla ricerca in CodeCatalyst](troubleshooting-search.md)
+ [Risoluzione dei problemi relativi alle estensioni](troubleshooting-extensions.md)
+ [Risoluzione dei problemi relativi agli account associati al tuo spazio](troubleshooting-connections.md)
+ [Risoluzione dei problemi tra Amazon CodeCatalyst e il AWS SDKs AWS CLI](troubleshooting-cli-sdk.md)
## Risoluzione dei problemi generali di accesso
### Ho dimenticato la mia password
**Problema:** ho dimenticato la password che uso per il mio AWS Builder ID e Amazon. CodeCatalyst
**Possibili correzioni:** il modo più semplice per risolvere questo problema è reimpostare la password.
1. Apri [Amazon CodeCatalyst](https://codecatalyst.aws/) e inserisci il tuo **indirizzo e-mail**. Quindi, scegli **Continue** (Continua).
1. Scegli **Password dimenticata?**
1. Ti invieremo un'email con un link per modificare la password. Se non vedi l'email nella tua casella di posta, controlla la cartella spam.
### Amazon CodeCatalyst non è disponibile in tutto o in parte
**Problema:** ho visitato o seguito un collegamento alla CodeCatalyst console, ma vedo un errore.
**Possibili correzioni: i** motivi più comuni di questo problema sono il fatto che hai seguito un link a un progetto o a uno spazio a cui non sei stato invitato oppure che c'è un problema di disponibilità generale del servizio. Controlla il [rapporto Health](health-dashboard.md) per vedere se ci sono problemi noti con il servizio. In caso contrario, contatta la persona che ti ha invitato al progetto o allo spazio e chiedi un altro invito. Se non sei stato invitato a partecipare a nessun progetto o spazio, puoi registrarti e [creare il tuo spazio e i tuoi progetti](sign-up-create-resources.md).
### Non riesco a creare un progetto in CodeCatalyst
**Problema:** voglio creare un progetto, ma il pulsante **Crea progetto** risulta non disponibile oppure ricevo un messaggio di errore.
**Possibili correzioni: i** motivi più comuni di questo problema sono che hai effettuato l'accesso alla console con un AWS Builder ID che non ha il ruolo di **amministratore dello spazio**. È necessario disporre di questo ruolo per creare progetti in uno spazio.
Se hai questo ruolo e il pulsante non appare come disponibile, potrebbe esserci un problema transitorio con il servizio. Aggiorna il browser e riprova.
## Risoluzione dei problemi di supporto
### Ricevo un errore quando accedo Supporto ad Amazon CodeCatalyst
**Problema:** quando scelgo l' CodeCatalyst opzione Supporto per Amazon, ricevo il seguente messaggio di errore:
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Account AWS that is the billing account for the space.`
**Possibili correzioni:** aggiungi il ruolo richiesto all'account Account AWS di fatturazione per lo spazio. L'account designato come account di fatturazione per lo spazio utilizza il `AWSRoleForCodeCatalystSupport` ruolo e `AmazonCodeCatalystSupportAccess` la politica gestita. Per ulteriori informazioni, consulta [Creazione del **AWSRoleForCodeCatalystSupport**ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-support-create).
**Nota**
Un AWS Builder ID può ricevere supporto solo per l'alias con cui è autenticato e solo per le risorse basate sulle autorizzazioni in cui è registrato. CodeCatalyst Il supporto per account e fatturazione è disponibile per tutti gli utenti dello spazio. Tuttavia, i builder possono ottenere supporto solo per le risorse e le informazioni per cui dispongono delle autorizzazioni. CodeCatalyst
### Non riesco a creare casi di supporto tecnico per il mio spazio
**Problema:** non riesco a creare casi di supporto tecnico per il mio spazio.
**Correzioni:** è necessario aggiungere un piano Business Support o Enterprise Support all'account di fatturazione dello spazio per consentire agli utenti presenti nello spazio di creare richieste di supporto tecnico. Chiedi all'amministratore dello spazio di aggiungere un Supporto piano al tuo account di fatturazione dello spazio o visita https://repost.aws/ per chiedere alla community. AWS
### Il mio account per i casi di assistenza non è più collegato al mio spazio in CodeCatalyst
**Problema:** il mio account per i casi di assistenza non è più collegato al mio spazio in CodeCatalyst.
**Correzioni:** se un utente con il ruolo di **amministratore dello spazio** cambia l'account di fatturazione dello spazio, il Supporto piano e tutti i casi associati verranno disconnessi dallo spazio. I Supporto casi associati al vecchio account di fatturazione spaziale non saranno più visibili in Supporto Amazon CodeCatalyst. L'utente root di quell'account di fatturazione può visualizzare e risolvere vecchi casi da Console di gestione AWS e può configurare le autorizzazioni IAM Supporto per consentire ad altri utenti di visualizzare e risolvere i vecchi casi. Non potrai continuare a ricevere supporto tecnico CodeCatalyst dal vecchio account di fatturazione Space tramite Console di gestione AWS, ma potrai ricevere supporto tecnico per altri servizi fino all'annullamento del Supporto piano.
*Per ulteriori informazioni, consulta [Aggiornamento, risoluzione e riapertura del caso nella Guida per l'utente](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html).Supporto *
### Non riesco ad aprire un caso di supporto per un altro Servizio AWS in Supporto Amazon CodeCatalyst
**Problema:** non riesco ad aprire una richiesta di supporto per un altro Servizio AWS Supporto utente CodeCatalyst.
**Possibili correzioni:** puoi aprire i casi di CodeCatalyst supporto solo da Supporto for CodeCatalyst. Se hai bisogno di supporto per servizi o risorse distribuiti CodeCatalyst da un altro AWS, Amazon o altro servizio di terze parti, dovrai creare un caso tramite il canale di assistenza Console di gestione AWS o il canale di assistenza di terze parti. Per ulteriori informazioni, consulta [Creazione di casi di supporto e gestione dei casi](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html) nella *Guida per l'Supporto utente*.
## Amazon CodeCatalyst non è disponibile in tutto o in parte
**Problema:** ho visitato o seguito un collegamento alla CodeCatalyst console, ma vedo un errore.
**Possibili correzioni: i** motivi più comuni di questo problema sono il fatto che hai seguito un link a un progetto o a uno spazio a cui non sei stato invitato oppure che c'è un problema di disponibilità generale del servizio. Controlla il [rapporto Health](health-dashboard.md) per vedere se ci sono problemi noti con il servizio. In caso contrario, contatta la persona che ti ha invitato al progetto o allo spazio e chiedi un altro invito. Se non sei stato invitato a partecipare a nessun progetto o spazio, puoi registrarti e [creare il tuo spazio e i tuoi progetti](sign-up-create-resources.md).
## Non riesco a creare un progetto in CodeCatalyst
**Problema:** voglio creare un progetto, ma il pulsante **Crea progetto** risulta non disponibile oppure ricevo un messaggio di errore.
**Possibili correzioni: i** motivi più comuni di questo problema sono che hai effettuato l'accesso alla console con un AWS Builder ID che non ha il ruolo di **amministratore dello spazio**. È necessario disporre di questo ruolo per creare progetti in uno spazio.
Se hai questo ruolo e il pulsante non appare come disponibile, potrebbe esserci un problema transitorio con il servizio. Aggiorna il browser e riprova.
## Non riesco ad accedere al mio spazio BID come nuovo utente o non posso essere aggiunto come nuovo utente SSO a causa del nome utente troncato
**Problema:** CodeCatalyst tronca i nomi utente dopo 100 caratteri, il che può far apparire alcuni nomi utente identici. Come nuovo utente che accede a uno CodeCatalyst spazio, riscontro questo problema a seconda del tipo di spazio, come segue:
+ Ho un AWS Builder ID che voglio usare per accedere. CodeCatalyst Quando tento di accedere allo spazio, ricevo un messaggio che indica che il mio nome utente non è valido.
+ Sono un amministratore di identità federato per uno CodeCatalyst spazio che supporta la federazione delle identità. Quando aggiungo un nuovo utente agli utenti e ai gruppi SSO in IAM Identity Center, ricevo un messaggio che indica che l'utente non è valido.
**Possibili correzioni:** il primo utente che accede CodeCatalyst o viene aggiunto allo spazio come utente SSO con un determinato nome utente troncato avrà successo. Tutti gli utenti che si registrano con un ID AWS Builder o che vengono aggiunti successivamente a IAM Identity Center non potranno accedere perché il nome sembrerà un duplicato. A seconda del tipo di spazio, esegui una delle seguenti operazioni:
+ Per poter accedere allo spazio AWS Builder ID, registrati con un nome utente diverso.
+ Per poter aggiungere il nuovo utente in IAM Identity Center, aggiungi l'utente con un nome utente diverso.
**Nota**
Anche se il nome utente sembra troncato, viene CodeCatalyst mappato all'identità in un modo che non è influenzato dai nomi utente con nomi troncati. Tuttavia, se viene creato un nome utente uguale a un nome utente troncato, tale nome utente non sarà disponibile se un altro utente associato (con lo stesso spazio o applicazione IAM Identity Center) si è già unito con quel nome utente troncato. CodeCatalyst
## L'aggiunta di un utente SSO al mio spazio federato come nuovo utente ha creato un utente duplicato
**Problema:** gli utenti CodeCatalyst SSO aggiunti a uno CodeCatalyst spazio e poi rimossi potrebbero riscontrare un problema a causa del tentativo di riutilizzo del nome utente. Ciò potrebbe causare un errore simile al seguente, in cui non è consentito duplicare l'utente anche se è stato ricreato.
**`Unable to assume role`**
`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Account AWS that is the billing account for the space.`
**Possibili correzioni:** se un utente IDC esistente viene eliminato e quindi viene ricreato un nuovo utente con lo stesso nome utente, il nuovo utente non è in grado di accedere a causa del conflitto tra il nome utente e quello precedente. Dopo aver aggiunto un nome utente a uno spazio come utente SSO, il nome non può essere riutilizzato. Tutti gli utenti che si registrano con un ID AWS Builder o vengono aggiunti successivamente in IAM Identity Center non potranno accedere perché il nome sembrerà un duplicato.
A seconda del tipo di spazio, esegui una delle seguenti operazioni:
+ Per poter accedere allo spazio AWS Builder ID, registrati con un nome utente diverso.
+ Per poter aggiungere il nuovo utente in IAM Identity Center, aggiungi l'utente con un nome utente diverso.
## Voglio inviare un feedback in CodeCatalyst
**Problema:** ho trovato un bug nel CodeCatalyst file e voglio inviare un feedback.
**Possibili correzioni:** puoi inviare feedback direttamente in CodeCatalyst.
1. Apri la CodeCatalyst console all'indirizzo [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Nel riquadro di navigazione, scegli **Invia feedback**.
1. Scegli il tipo di feedback dal menu a discesa e inserisci il tuo feedback.
# Risoluzione dei problemi relativi ai repository di origine
Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni relativi ai repository di origine in. CodeCatalyst
**Topics**
+ [Ho raggiunto lo spazio di archiviazione massimo disponibile e visualizzo avvisi o errori](#source-troubleshoot-storage)
+ [Ricevo un errore durante il tentativo di clonare o eseguire il push su un repository di CodeCatalyst sorgenti Amazon](#source-troubleshoot-clone)
+ [Ricevo un errore durante il tentativo di eseguire il commit o il push su un repository di CodeCatalyst sorgenti Amazon](#source-troubleshoot-commit-code)
+ [Ho bisogno di un repository di sorgenti per il mio progetto](#source-troubleshoot-need-repository)
+ [Il mio repository di origine è nuovo di zecca ma contiene un commit](#source-troubleshoot-initial-commit)
+ [Voglio un ramo diverso come ramo predefinito](#source-troubleshoot-default-branch)
+ [Ricevo e-mail sull'attività nelle pull request](#source-troubleshoot-repository-emails)
+ [Ho dimenticato il mio token di accesso personale (PAT)](#source-troubleshoot-forgot-pat)
+ [Una pull request non mostra le modifiche che mi aspetto](#source-troubleshoot-pull-request-diff)
+ [Una pull request mostra lo stato Non unibile](#source-troubleshoot-pull-request-not-mergeable)
## Ho raggiunto lo spazio di archiviazione massimo disponibile e visualizzo avvisi o errori
**Problema:** voglio salvare il codice in uno o più repository di sorgenti in CodeCatalyst, ma vedo un errore. Nella console, nella pagina del repository di origine viene visualizzato un messaggio che indica che ho raggiunto il limite di spazio di archiviazione per lo spazio.
**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, puoi ridurre le dimensioni di uno o più repository di origine, eliminare gli archivi di origine non utilizzati o modificare il livello di fatturazione con uno che abbia più spazio di archiviazione.
+ Per ridurre le dimensioni di un archivio di origine in un progetto, puoi eliminare i rami inutilizzati. Per ulteriori informazioni, consultare [Eliminazione di un ramo](source-branches-delete.md) e [Ruolo di collaboratore](ipa-role-types.md#ipa-role-contributor).
+ Per ridurre lo spazio di archiviazione complessivo, è possibile eliminare gli archivi di origine non utilizzati. Per ulteriori informazioni, consultare [Eliminazione di un archivio di origine](source-repositories-delete.md) e [Ruolo di amministratore del progetto](ipa-role-types.md#ipa-role-project-admin).
+ Per aumentare la quantità di spazio di archiviazione disponibile, puoi modificare il livello di fatturazione impostando uno con più spazio di archiviazione. Per ulteriori informazioni, consulta [Modifica del livello di CodeCatalyst fatturazione](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) nella Amazon CodeCatalyst Administrator Guide.
## Ricevo un errore durante il tentativo di clonare o eseguire il push su un repository di CodeCatalyst sorgenti Amazon
**Problema:** quando provo a clonare un archivio di sorgenti su un computer locale o in un ambiente di sviluppo integrato (IDE), ricevo un errore di autorizzazione.
**Possibili correzioni:** potresti non avere un token di accesso personale (PAT) per il tuo AWS Builder ID, potresti non aver configurato il tuo sistema di gestione delle credenziali con il tuo PAT o il PAT potrebbe essere scaduto. Prova una o più delle seguenti soluzioni:
+ Crea un token di accesso personale (PAT). Per ulteriori informazioni, consulta [Concedi agli utenti l'accesso al repository con token di accesso personali](ipa-tokens-keys.md).
+ Assicurati di aver accettato un invito al progetto che contiene il repository dei sorgenti e di essere ancora un membro di quel progetto. Non puoi clonare un repository di origine se non sei un membro attivo di quel progetto. Accedi alla console e prova a navigare nello spazio e nel progetto in cui stai tentando di clonare un repository di origine. Se non riesci a visualizzare il progetto nell'elenco dei progetti dello spazio, significa che non sei membro di quel progetto o non hai accettato un invito a partecipare a quel progetto. Per ulteriori informazioni, consulta [Accettazione di un invito e creazione di un AWS Builder ID](sign-up-sign-in.md).
+ Assicurati che il comando clone sia formattato correttamente e includa il tuo ID AWS Builder. Esempio:
```
https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
```
+ Usa il AWS CLI per assicurarti di avere un PAT associato al tuo AWS Builder ID e che non sia scaduto. Se non ne hai uno o il PAT è scaduto, creane uno. Per ulteriori informazioni, consulta [Concedi agli utenti l'accesso al repository con token di accesso personali](ipa-tokens-keys.md).
+ Prova a creare un ambiente di sviluppo per lavorare con il codice nel repository di origine invece di clonarlo in un repository o IDE locale. Per ulteriori informazioni, consulta [Creazione di un ambiente di sviluppo](devenvironment-create.md).
## Ricevo un errore durante il tentativo di eseguire il commit o il push su un repository di CodeCatalyst sorgenti Amazon
**Problema:** quando provo a inviare un push a un repository di origine, ricevo un errore di autorizzazione.
**Possibili correzioni:** potresti non avere un ruolo nel progetto che ti consenta di eseguire il commit e inviare modifiche al codice del progetto. Visualizza il tuo ruolo nel progetto in cui stai cercando di inviare le modifiche a un archivio di origine. Per ulteriori informazioni, consultare [Ottenere un elenco dei membri e dei relativi ruoli nel progetto](projects-members.md#projects-members-view) e [Concessione dell'accesso con ruoli utente](ipa-roles.md).
Se hai un ruolo che consente di eseguire e inviare modifiche, nel ramo in cui stai tentando di apportare modifiche potrebbe essere configurata una regola di branch che ti impedisce di inviare modifiche al codice in quel ramo. Prova invece a creare un ramo e a inviare il codice a quel ramo. Per ulteriori informazioni, consulta [Gestisci le azioni consentite per una filiale con le regole della filiale](source-branches-branch-rules.md).
## Ho bisogno di un repository di sorgenti per il mio progetto
**Problema:** il mio progetto non ha un repository di sorgenti o ho bisogno di un altro repository di sorgenti per il mio progetto.
**Possibili correzioni:** alcuni progetti vengono creati senza risorse. Se sei un membro del progetto, puoi creare repository di sorgenti per quel progetto in. CodeCatalyst **Se qualcuno con il ruolo di **amministratore dello spazio** installa i **GitHub repository** e li collega a un GitHub account, puoi collegarti ai GitHub repository disponibili per aggiungerli al tuo progetto, se hai il ruolo di amministratore del progetto.** Per ulteriori informazioni, vedere [Creazione di un repository di origine e [Collegamento](source-repositories-link.md) di un repository](source-repositories-create.md) di origine.
## Il mio repository di origine è nuovo di zecca ma contiene un commit
**Problema:** ho appena creato un repository di sorgenti. Dovrebbe essere vuoto, ma contiene un commit, un ramo e un `README.md` file.
**Possibili correzioni: si** tratta di un comportamento previsto. Tutti i repository di origine CodeCatalyst includono un commit iniziale che imposta il ramo predefinito su `main` e include codice di esempio (se il repository è stato creato per un progetto utilizzando un blueprint che includeva codice di esempio) o un file markdown modello per un file README del repository. Puoi creare rami aggiuntivi nella console e nei client Git. È possibile creare e modificare file nella console ed eliminare file negli ambienti di sviluppo e nei client Git.
## Voglio un ramo diverso come ramo predefinito
**Problema:** il mio repository di origine è stato fornito con un ramo predefinito denominato`main`, ma voglio un ramo diverso come ramo predefinito.
**Possibili correzioni:** non è possibile modificare o eliminare il ramo predefinito nei repository di origine in. CodeCatalyst È possibile creare rami aggiuntivi e utilizzarli nelle azioni di origine dei flussi di lavoro. Puoi anche scegliere di collegare i GitHub repository e usarli come repository per il tuo progetto.
## Ricevo e-mail sull'attività nelle pull request
**Problema:** non mi sono registrato né configurato le notifiche e-mail sull'attività delle pull request, ma le ricevo comunque.
**Possibili correzioni:** le notifiche e-mail vengono inviate automaticamente sulle attività di pull request. Per ulteriori informazioni, consulta [Revisione del codice con richieste pull in Amazon CodeCatalyst](source-pull-requests.md).
## Ho dimenticato il mio token di accesso personale (PAT)
**Problema:** ho usato un PAT per clonare, inviare ed estrarre codice per i repository dei sorgenti, ma ho perso il valore del mio token e non riesco a trovarlo nella console. CodeCatalyst
**Possibili correzioni:** il modo più rapido per risolvere questo problema consiste nel creare un altro PAT e configurare il gestore delle credenziali o l'IDE per utilizzare questo nuovo PAT. Visualizziamo il valore di un PAT solo quando lo crei. Se perdi questo valore, non può essere recuperato. Per ulteriori informazioni, consulta [Concedi agli utenti l'accesso al repository con token di accesso personali](ipa-tokens-keys.md).
## Una pull request non mostra le modifiche che mi aspetto
**Problema:** ho creato una richiesta pull, ma non vedo le modifiche che mi aspetto di vedere tra i rami di origine e di destinazione.
**Possibili correzioni:** ciò potrebbe essere causato da una serie di problemi. Prova una o più delle seguenti soluzioni:
+ È possibile che stiate esaminando le modifiche tra le revisioni precedenti o che non stiate visualizzando le modifiche più recenti. Aggiorna il browser e assicurati di aver scelto il confronto tra le revisioni che desideri visualizzare.
+ Non tutte le modifiche in una pull request possono essere visualizzate nella console. Ad esempio, non è possibile visualizzare i sottomoduli Git nella console, quindi non è possibile visualizzare le differenze in un sottomodulo in una pull request. Alcune differenze potrebbero essere troppo grandi per essere visualizzate. Per ulteriori informazioni, consultare [Quote per i repository di sorgenti in CodeCatalyst](source-quotas.md) e [Visualizzazione di un fileVisualizzazione della cronologia delle modifiche apportate a un file](source-files-view.md).
+ Le richieste pull mostrano le differenze tra la base di unione e la revisione scelta. Quando create una richiesta pull, la differenza visualizzata per voi è la differenza tra la punta del ramo di origine e la punta del ramo di destinazione. Una volta creata la pull request, la differenza visualizzata è tra la revisione e la relativa base di unione. La base di unione è il commit che costituiva la punta del ramo di destinazione al momento della creazione della revisione. La base di unione può cambiare tra le revisioni. Per ulteriori informazioni sulle differenze e sulle basi di unione in Git, consulta [git-merge-base](https://git-scm.com/docs/git-merge-base)la documentazione di Git.
## Una pull request mostra lo stato Non unibile
**Problema:** voglio unire una pull request, ma il relativo stato è indicato come **Non** unificabile.
**Possibili correzioni:** ciò può essere causato da uno o più problemi:
+ Tutti i revisori necessari per la richiesta pull devono approvare una pull request prima che possa essere unita. Controlla l'elenco dei revisori richiesti per tutti i revisori con un'icona a forma di orologio accanto al nome. L'icona a forma di orologio indica che il revisore non ha approvato la pull request.
**Nota**
Se un revisore richiesto è stato rimosso dal progetto prima di approvare la pull request, non è possibile unire la pull request. Chiudi la pull request e crea una nuova pull request.
+ Potrebbe esserci un conflitto di fusione tra il ramo di origine e il ramo di destinazione. CodeCatalyst non supporta tutte le possibili strategie e opzioni di fusione Git. Puoi valutare i rami per i conflitti di unione in un ambiente di sviluppo o clonare il repository e utilizzare uno strumento IDE o Git per trovare e risolvere i conflitti di unione. Per ulteriori informazioni, consulta [Unione di una richiesta di pull](pull-requests-merge.md).
# Risoluzione dei problemi relativi a progetti e blueprint
Questa sezione può aiutarti a risolvere alcuni problemi comuni che potresti riscontrare mentre lavori con progetti e blueprint in Amazon. CodeCatalyst
# API Java con dipendenze del AWS Fargate blueprint mancanti per apache-maven-3.8.6
**Problema:** per un progetto creato dall'API Java con AWS Fargate blueprint, il flusso di lavoro ha esito negativo e viene visualizzato un errore relativo alle dipendenze mancanti. `apache-maven-3.8.6` Il flusso di lavoro non riesce con un output simile al seguente esempio:
```
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
```
**Soluzione:** aggiorna il file Dockerfile del blueprint utilizzando i seguenti passaggi.
1. Nella barra di ricerca, inserisci `apache-maven-3.8.6` per individuare il dockerfile all'interno del progetto creato con l'API Java con blueprint. AWS Fargate
1. Aggiorna il Dockerfile (`/static-assets/app/Dockerfile`) da utilizzare `maven:3.9.0-amazoncorretto-11` come immagine di base e rimuovi la dipendenza dal pacchetto. `apache-maven-3.8.6`
1. (Consigliato) Consigliamo inoltre di aggiornare la dimensione dell'heap di Maven a 6 GB.
Di seguito è riportato un esempio di 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"]
```
# Il moderno flusso di lavoro del blueprint di applicazioni Web a tre livelli **OnPullRequest**non riesce a causa di un errore di autorizzazione per Amazon CodeGuru
**Problema:** quando tento di eseguire un flusso di lavoro per il mio progetto, il flusso di lavoro non viene eseguito e viene visualizzato il seguente messaggio:
```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```
``
**Soluzione:** una possibile causa di questo errore di azione potrebbe essere dovuta alla mancanza di autorizzazioni nella policy del ruolo IAM, in quanto alla versione del ruolo di servizio utilizzata da CodeCatalyst in the connected mancano le autorizzazioni necessarie per l' Account AWS esecuzione corretta dell'azione **codeguru\$1codereview**. Per risolvere questo problema, è necessario aggiornare il ruolo di servizio con le autorizzazioni richieste oppure è necessario modificare il ruolo di servizio utilizzato per il flusso di lavoro con uno con le autorizzazioni richieste per Amazon e CodeGuru Amazon CodeGuru Reviewer. Segui i passaggi seguenti, trova il tuo ruolo e aggiorna le autorizzazioni relative alla policy del ruolo per consentire al flusso di lavoro di funzionare correttamente.
**Nota**
Questi passaggi si applicano ai seguenti flussi di lavoro in: CodeCatalyst
Il **OnPullRequest**flusso di lavoro fornito per i progetti creati con il modello di applicazione Web Modern a tre livelli in. CodeCatalyst
Flussi di lavoro aggiunti ai progetti CodeCatalyst con azioni che accedono ad Amazon CodeGuru o Amazon CodeGuru Reviewer.
Ogni progetto contiene flussi di lavoro con azioni che utilizzano un ruolo e un ambiente forniti da chi è Account AWS connesso al progetto. CodeCatalyst Il flusso di lavoro con le azioni e la relativa politica designata viene archiviato nell'archivio dei sorgenti nella directory /.codecatalyst/workflows. La modifica del flusso di lavoro YAML non è richiesta a meno che non si aggiunga un nuovo ID di ruolo al flusso di lavoro esistente. Per informazioni sugli elementi e sulla formattazione del modello YAML, vedere. [Definizione YAML del flusso di lavoro](workflow-reference.md)
Questi sono i passaggi principali da seguire per modificare la politica relativa ai ruoli e verificare il flusso di lavoro YAML.
**Per fare riferimento al nome del tuo ruolo nel flusso di lavoro YAML e aggiornare la policy**
1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Accedi al tuo CodeCatalyst spazio. Vai al tuo progetto.
1. **Scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il flusso di lavoro intitolato. **OnPullRequest** Scegliere la scheda **Definizione** .
1. Nel workflow YAML, nel `Role:` campo sotto l'azione **codeguru\$1codereview**, prendi nota del nome del ruolo. Questo è il ruolo con la politica che modificherai in IAM. L'esempio seguente mostra il nome del ruolo.
![\[Visualizza il nome del ruolo IAM nel flusso di lavoro YAML\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)
1. Esegui una delle seguenti operazioni:
+ (Consigliato) Aggiorna il ruolo di servizio collegato al tuo progetto con le autorizzazioni richieste per Amazon CodeGuru e Amazon CodeGuru Reviewer. Il ruolo avrà un nome `CodeCatalystWorkflowDevelopmentRole-spaceName` con un identificatore univoco aggiunto. Per ulteriori informazioni sul ruolo e sulla politica relativa ai ruoli, vedere. [Comprensione del ruolo **CodeCatalystWorkflowDevelopmentRole-*spaceName***del servizio](ipa-iam-roles.md#ipa-iam-roles-service-role) Procedi ai passaggi successivi per aggiornare la policy in IAM.
**Nota**
È necessario disporre AWS dell'accesso di amministratore a Account AWS con il ruolo e la policy.
+ Cambia il ruolo di servizio utilizzato per il flusso di lavoro con uno con le autorizzazioni richieste per Amazon CodeGuru e Amazon CodeGuru Reviewer o crea un nuovo ruolo con le autorizzazioni richieste.
1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
Nella console IAM, trova il ruolo indicato nella fase 5, ad esempio`CodeCatalystPreviewDevelopmentRole`.
1. Nel ruolo del passaggio 5, modifica la politica di autorizzazione per includere le `codeguru:*` autorizzazioni `codeguru-reviewer:*` e. Dopo aver aggiunto queste autorizzazioni, la politica di autorizzazione dovrebbe essere simile alla seguente:
1. Dopo aver apportato le correzioni ai criteri, torna CodeCatalyst e riavvia l'esecuzione del flusso di lavoro.
## Stai ancora cercando di risolvere il tuo problema?
Puoi andare [su Amazon CodeCatalyst](https://codecatalyst.aws/) o compilare un [modulo Support Feedback](https://support.aws.amazon.com/#/contacts/aws-account-support/). Nella sezione **Richiedi informazioni**, sotto **Come possiamo aiutarti**, inserisci che sei un CodeCatalyst cliente Amazon. Fornisci il maggior numero di dettagli possibile in modo che possiamo risolvere il problema nel modo più efficiente.
# Risoluzione dei problemi con gli ambienti di sviluppo
Consulta le seguenti sezioni per risolvere i problemi relativi agli ambienti di sviluppo. Per ulteriori informazioni sugli ambienti di sviluppo, vedere. [Scrivi e modifica il codice con Dev Environments in CodeCatalystScrivi e modifica il codice con Dev Environments](devenvironment.md)
**Topics**
+ [La creazione del mio ambiente di sviluppo non è riuscita a causa di un problema con le quote](#troubleshooting-devenvironments-create)
+ [Non riesco a trasferire le modifiche dal mio ambiente di sviluppo a un ramo specifico di un repository](#troubleshooting-devenvironments-branchrules)
+ [Il mio ambiente di sviluppo non è stato ripreso](#troubleshooting-devenvironments-resume)
+ [Il mio ambiente di sviluppo si è disconnesso](#troubleshooting-devenvironments-connection)
+ [Il mio ambiente di sviluppo connesso al VPC non è riuscito](#troubleshooting-devenvironments-vpc)
+ [Non riesco a trovare la cartella in cui si trova il mio progetto](#troubleshooting-devenvironments-projects)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH](#troubleshooting-devenvironments-connect-ssh)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché manca la mia configurazione SSH locale](#troubleshooting-devenvironments-projects-ssh-config)
+ [Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché ho problemi con il mio profilo for the AWS Config `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [Non riesco a creare un ambiente di sviluppo quando ho effettuato l'accesso CodeCatalyst utilizzando un account Single Sign-on](#troubleshoot-create-dev-env-idprovider)
+ [Risoluzione dei problemi con IDEs](devenvironments-troubleshooting-ides.md)
+ [Risoluzione dei problemi con devfiles](devenvironments-devenvironments-devfile.md)
## La creazione del mio ambiente di sviluppo non è riuscita a causa di un problema con le quote
**Problema:** voglio creare un ambiente di sviluppo in CodeCatalyst, ma vedo un errore. Nella console, nella pagina Dev Environments vedo un messaggio che indica che ho raggiunto il limite di spazio di archiviazione per lo spazio.
**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, puoi eliminare uno o più ambienti di sviluppo personali oppure, se hai il ruolo di amministratore dello spazio, puoi eliminare gli ambienti di sviluppo non utilizzati creati da altri utenti. Puoi anche decidere di modificare il livello di fatturazione con uno che includa più spazio di archiviazione.
+ Per visualizzare i limiti di archiviazione, visualizza la scheda **Fatturazione** CodeCatalyst dello spazio Amazon per verificare se le quote di **utilizzo** hanno raggiunto il massimo consentito. Se le quote hanno raggiunto il massimo, contatta qualcuno con il ruolo di amministratore di Space per rimuovere gli ambienti di sviluppo non necessari o per prendere in considerazione la modifica del livello di fatturazione.
+ Per rimuovere gli ambienti di sviluppo che hai creato e che non ti servono più, consulta. [Eliminazione di un ambiente di sviluppo](devenvironment-delete.md)
Se il problema persiste e ricevi un errore nell'IDE, verifica di avere un CodeCatalyst ruolo che ti consenta di creare un ambiente di sviluppo. Il ruolo di **amministratore dello spazio**, il ruolo di **amministratore del progetto** e il ruolo di **collaboratore** sono tutti autorizzati a creare ambienti di sviluppo. Per ulteriori informazioni, consulta [Concessione dell'accesso con ruoli utente](ipa-roles.md).
## Non riesco a trasferire le modifiche dal mio ambiente di sviluppo a un ramo specifico di un repository
**Problema:** voglio eseguire il commit e inviare le modifiche al codice nel mio ambiente di sviluppo a un ramo in un repository di sorgenti, ma vedo un errore.
**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, potresti non avere le autorizzazioni per inviare il codice ai repository di sorgenti del progetto. Il ruolo di **amministratore dello spazio**, il ruolo di **amministratore del progetto** e il ruolo di **collaboratore** sono tutti autorizzati a inviare codice ai repository del progetto.
Se hai il ruolo di **Collaboratore** ma non puoi inviare codice a un ramo specifico, potrebbe essere configurata una regola di branch per il ramo specifico che impedisce agli utenti con quel ruolo di inviare codice a quel particolare ramo. Prova a inviare le modifiche a un altro ramo oppure crea un ramo e poi invia il codice a quel ramo. Per ulteriori informazioni, consulta [Gestisci le azioni consentite per una filiale con le regole della filiale](source-branches-branch-rules.md).
## Il mio ambiente di sviluppo non è stato ripreso
**Problema:** il mio ambiente di sviluppo non è ripreso dopo averlo interrotto.
**Possibili correzioni:** per risolvere il problema, visualizza la scheda **Fatturazione** CodeCatalyst dello spazio Amazon per vedere se le quote di **utilizzo** hanno raggiunto i limiti massimi. Se le quote hanno raggiunto il limite massimo, contatta l'amministratore di Space per aumentare il livello di fatturazione.
## Il mio ambiente di sviluppo si è disconnesso
**Problema:** il mio ambiente di sviluppo si è disconnesso mentre lo stavo usando.
**Possibili soluzioni:** per risolvere il problema, controlla la tua connessione Internet. Se non sei connesso a Internet, connettiti e riprendi a lavorare nel tuo ambiente di sviluppo.
## Il mio ambiente di sviluppo connesso al VPC non è riuscito
**Problema:** ho associato una connessione VPC al mio ambiente di sviluppo e si verificano degli errori.
**Possibili correzioni:** Docker utilizza un dispositivo a livello di collegamento chiamato rete bridge che consente ai contenitori collegati alla stessa rete di bridge di comunicare. Di norma, il bridge di default utilizza la sottorete `172.17.0.0/16` per le reti dei container. Se la sottorete VPC per l'istanza dell'ambiente utilizza lo stesso intervallo di indirizzi già usato da Docker, può verificarsi un conflitto di indirizzi IP. Per risolvere un conflitto di indirizzi IP causato da Amazon VPC e che Docker utilizza lo stesso blocco di indirizzi IPv4 CIDR, configura un blocco CIDR diverso da. `172.17.0.0/16`
**Nota**
Non è possibile modificare l'intervallo di indirizzi IP di un VPC o di una sottorete esistente.
## Non riesco a trovare la cartella in cui si trova il mio progetto
**Problema:** non riesco a trovare la cartella in cui si trova il mio progetto.
**Possibili correzioni:** per localizzare il progetto, cambia cartella in cui `/projects` si trova. Questa è la cartella in cui puoi trovare i tuoi progetti.
## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH
Per risolvere i problemi di connessione al tuo ambiente di sviluppo tramite SSH, puoi eseguire il `ssh` comando con l'`-vvv`opzione per mostrare ulteriori informazioni su come risolvere il problema:
```
ssh -vvv codecatalyst-dev-env===
```
## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché manca la mia configurazione SSH locale
Se manca la configurazione SSH locale (`~/.ssh/config`) o il contenuto della `Host codecatalyst-dev-env*` sezione non è aggiornato, non potrai connetterti al tuo ambiente di sviluppo tramite SSH. **Per risolvere questo problema, elimina la `Host codecatalyst-dev-env*` sezione ed esegui nuovamente il primo comando dal modale SSH Access.** Per ulteriori informazioni, consulta [Connessione a un ambiente di sviluppo tramite SSH](devenvironment-connect-ssh.md).
## Non riesco a connettermi al mio ambiente di sviluppo tramite SSH perché ho problemi con il mio profilo for the AWS Config `codecatalyst`
Assicurati che il tuo AWS Config (`~/.aws/config`) per il `codecatalyst` profilo corrisponda a quello descritto in[Configurazione per l'utilizzo AWS CLI di CodeCatalyst](set-up-cli.md). In caso contrario, elimina il profilo `codecatalyst` ed esegui nuovamente il primo comando dal modale **SSH Access**. Per ulteriori informazioni, consulta [Connessione a un ambiente di sviluppo tramite SSH](devenvironment-connect-ssh.md).
## Non riesco a creare un ambiente di sviluppo quando ho effettuato l'accesso CodeCatalyst utilizzando un account Single Sign-on
**Problema:** quando accedo alla CodeCatalyst console come utente SSO, ricevo un errore di eccezione sconosciuto quando scelgo di creare un ambiente di sviluppo nello spazio. Quando scelgo di creare un ambiente di sviluppo e scelgo l'IDE per l'accesso, ad esempio AWS Cloud9, riscontro problemi simili ai seguenti:
+ La pagina **Dev Environments** nella CodeCatalyst console mostra l'ambiente di sviluppo nell'elenco con uno `FAILED` stato.
+ Viene visualizzato un messaggio di errore simile al seguente:
**`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.`
**Possibili soluzioni.**
Gli ambienti di sviluppo non sono disponibili per gli utenti negli spazi in cui Active Directory viene utilizzato come provider di identità. Gli amministratori dello spazio possono utilizzare un provider di identità alternativo per accedere agli ambienti di sviluppo, come IAM Identity Center. Per ulteriori informazioni sulla pianificazione di uno spazio che supporti la federazione delle identità, consulta [Pianificazione dello spazio che supporti la federazione delle identità](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) nella *Guida per l'CodeCatalyst amministratore*.
# Risoluzione dei problemi con IDEs
Consulta le seguenti sezioni per risolvere i problemi relativi a in. IDEs CodeCatalyst Per ulteriori informazioni su IDEs, vedere. [Creazione di un ambiente di sviluppo in un IDE](devenvironment-create.md#devenvironment-using-ide)
**Topics**
+ [Ho versioni di immagini di runtime non corrispondenti in AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Non riesco ad accedere ai miei file in `/projects/projects` in AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Non riesco ad avviare il mio ambiente di sviluppo AWS Cloud9 utilizzando un devfile personalizzato](#troubleshooting-devenvironments-c9-image)
+ [Sto riscontrando problemi in AWS Cloud9](#troubleshooting-c9)
+ [Nel JetBrains, non riesco a connettermi ai miei ambienti di sviluppo tramite CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Non riesco a installarlo Kit di strumenti AWS per il mio IDE](#troubleshooting-ide-toolkit)
+ [Nel mio IDE, non riesco ad avviare i miei ambienti di sviluppo](#troubleshooting-ide-launch)
## Ho versioni di immagini di runtime non corrispondenti in AWS Cloud9
AWS Cloud9 utilizza versioni diverse della risorsa frontend e dell'immagine di runtime del backend. L'utilizzo di versioni diverse potrebbe causare un funzionamento errato dell'estensione Git. Kit di strumenti AWS Per risolvere il problema, accedi alla dashboard di Dev Environment, interrompi Dev Environment e riavvialo. Per risolvere il problema di utilizzo APIs, utilizza l'`UpdateDevEnvironment`API per aggiornare il runtime. Per ulteriori informazioni, [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)consulta il *riferimento alle CodeCatalyst API di Amazon*.
## Non riesco ad accedere ai miei file in `/projects/projects` in AWS Cloud9
L' AWS Cloud9 editor non è in grado di accedere ai file nella directory`/projects/projects`. Per risolvere il problema, utilizzate il AWS Cloud9 terminale per accedere ai file o spostateli in un'altra directory.
## Non riesco ad avviare il mio ambiente di sviluppo AWS Cloud9 utilizzando un devfile personalizzato
L'immagine del tuo devfile potrebbe non essere compatibile con. AWS Cloud9 Per risolvere il problema, esamina il devfile dal tuo repository e dall'ambiente di sviluppo corrispondente e creane uno nuovo per continuare.
## Sto riscontrando problemi in AWS Cloud9
Per altri problemi, consulta la sezione sulla risoluzione dei problemi nella Guida per l'[AWS Cloud9 utente](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).
## Nel JetBrains, non riesco a connettermi ai miei ambienti di sviluppo tramite CodeCatalyst
Per risolvere il problema, verifica di avere JetBrains installato solo la versione più recente di. Se disponi di più versioni, disinstalla le versioni precedenti e registra nuovamente il gestore di protocollo chiudendo l'IDE e il browser. Quindi apri JetBrains e registra nuovamente il gestore di protocollo.
## Non riesco a installarlo Kit di strumenti AWS per il mio IDE
Per risolvere questo problema per VS Code, installa manualmente AWS Toolkit for Visual Studio Code da [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).
Per risolvere questo problema JetBrains, installa manualmente AWS Toolkit for JetBrains da [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).
## Nel mio IDE, non riesco ad avviare i miei ambienti di sviluppo
Per risolvere questo problema per VS Code, verifica di avere l'ultima versione di VS Code e di aver AWS Toolkit for Visual Studio Code installato l'ultima versione di VS Code. Se non disponi della versione più recente, aggiorna e avvia il tuo Dev Environment. Per ulteriori informazioni, consulta [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).
Per risolvere questo problema JetBrains, verifica di avere AWS Toolkit for JetBrains installato la versione più recente JetBrains di. Se non disponi della versione più recente, aggiorna e avvia il tuo Dev Environment. Per ulteriori informazioni, consulta [Amazon CodeCatalyst for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).
# Risoluzione dei problemi con devfiles
Consulta le seguenti sezioni per risolvere i problemi relativi a devfiles in. CodeCatalyst Per ulteriori informazioni su devfiles, vedere. [Configurazione di un devfile per un ambiente di sviluppo](devenvironment-devfile.md)
**Topics**
+ [Il mio ambiente di sviluppo utilizza il devfile universale predefinito anche se ho implementato un'immagine personalizzata in un devfile personalizzato](#troubleshooting-devenvironments-custom-image)
+ [Il mio progetto non è stato creato nel mio ambiente di sviluppo con il devfile universale predefinito](#troubleshooting-devenvironments-default-image)
+ [Voglio spostare un repository devfile per un ambiente di sviluppo](#troubleshooting-devenvironments-devfile-moving)
+ [Ho problemi ad avviare il mio devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [Non so come controllare lo stato del mio devfile](#troubleshooting-devenvironments-devfile-status)
+ [Il mio devfile non è compatibile con gli strumenti forniti nell'ultima immagine](#troubleshooting-devenvironments-devfile-version)
## Il mio ambiente di sviluppo utilizza il devfile universale predefinito anche se ho implementato un'immagine personalizzata in un devfile personalizzato
Se si CodeCatalyst verificano errori durante l'avvio di un ambiente di sviluppo che utilizza un devfile personalizzato, l'ambiente di sviluppo utilizza per impostazione predefinita il devfile universale predefinito. Per risolvere il problema, puoi controllare l'errore esatto nei log sottostanti. `/aws/mde/logs/devfile.log` Puoi anche verificare se `postStart` l'esecuzione è andata a buon fine nei tuoi log:. `/aws/mde/logs/devfileCommand.log`
## Il mio progetto non è stato creato nel mio ambiente di sviluppo con il devfile universale predefinito
Per risolvere il problema, verifica di non utilizzare un devfile personalizzato. Se non state utilizzando un devfile personalizzato, visualizzate il `devfile.yaml` file nell'archivio di origine del progetto per individuare e correggere eventuali errori.
## Voglio spostare un repository devfile per un ambiente di sviluppo
Puoi spostare il devfile predefinito nel `/projects/devfile.yaml` tuo repository del codice sorgente. Per aggiornare la posizione del devfile, usa il seguente comando:. `/aws/mde/mde start --location repository-name/devfile.yaml`
## Ho problemi ad avviare il mio devfile
Se c'è un problema durante l'avvio del tuo devfile, entrerà in modalità di ripristino in modo che tu possa comunque connetterti al tuo ambiente e correggere il tuo devfile. In modalità di ripristino, l'esecuzione `/aws/mde/mde status` non conterrà la posizione del tuo devfile.
```
{
"status": "STABLE"
}
```
Puoi controllare l'errore nei log sotto`/aws/mde/logs`, correggere il devfile e riprovare a eseguire. `/aws/mde/mde start`
## Non so come controllare lo stato del mio devfile
Puoi controllare lo stato del tuo devfile eseguendo. `/aws/mde/mde status` Dopo aver eseguito questo comando, è possibile che venga visualizzato uno dei seguenti:
+ `{"status": "STABLE", "location": "devfile.yaml" }`
Ciò indica che il file dev è corretto.
+ `{"status": "STABLE" }`
Ciò indica che il tuo devfile non può essere avviato ed è entrato in modalità di ripristino.
Puoi controllare l'errore esatto nei log sotto. `/aws/mde/logs/devfile.log`
Puoi anche verificare se `postStart` l'esecuzione è andata a buon fine nei tuoi log:. `/aws/mde/logs/devfileCommand.log`
Per ulteriori informazioni, consulta [Specificare immagini devfile universali per un ambiente di sviluppo](devenvironment-universal-image.md).
## Il mio devfile non è compatibile con gli strumenti forniti nell'ultima immagine
Nel tuo ambiente di sviluppo, `devfile` o `devfile postStart` potrebbe fallire se `latest` gli strumenti non dispongono degli strumenti necessari per un progetto specifico. Per risolvere il problema, procedi come segue:
1. Vai al tuo devfile.
1. Nel tuo devfile, esegui l'aggiornamento a una versione con immagine granulare anziché. `latest` Potrebbe essere simile al seguente:
```
components:
- container:
image: public.ecr.aws/amazonlinux/universal-image:1.0
```
1. Crea un nuovo ambiente di sviluppo utilizzando il devfile aggiornato.
# Risoluzione dei problemi relativi ai flussi di lavoro
Consulta le seguenti sezioni per risolvere i problemi relativi ai flussi di lavoro in Amazon. CodeCatalyst Per ulteriori informazioni sui flussi di lavoro, consulta [Crea, testa e distribuisci con i flussi di lavoroCrea, testa e distribuisci con i flussi di lavoro](workflow.md).
**Topics**
+ [Come posso correggere i messaggi «Workflow is inactive»?](#troubleshooting-workflows-inactive)
+ [Come posso correggere gli errori «La definizione del flusso di lavoro presenta *n* errori»?](#troubleshooting-workflows-asterisks)
+ [Come posso correggere gli errori «Impossibile individuare le credenziali» e "ExpiredToken"?](#troubleshooting-workflows-auth-errors-eks)
+ [Come posso correggere gli errori «Impossibile connettersi al server»?](#troubleshooting-workflows-unable-connect-eks)
+ [Perché mancano CodeDeploy dei campi nell'editor visivo?](#troubleshooting-workflows-codedeploy)
+ [Come posso correggere gli errori relativi alle funzionalità IAM?](#troubleshooting-workflows-capabilities)
+ [Come posso correggere gli errori di «npm install»?](#troubleshooting-workflows-npm)
+ [Perché più flussi di lavoro hanno lo stesso nome?](#troubleshooting-workflows-name)
+ [Posso archiviare i miei file di definizione del flusso di lavoro in un'altra cartella?](#troubleshooting-workflows-folder)
+ [Come posso aggiungere azioni in sequenza al mio flusso di lavoro?](#troubleshooting-workflows-visual)
+ [Perché il mio flusso di lavoro viene convalidato correttamente ma fallisce in fase di esecuzione?](#troubleshooting-workflows-validation)
+ [L'individuazione automatica non rileva alcun rapporto relativo alla mia azione](#troubleshooting-reports-auto-discovery)
+ [La mia azione non riesce sui report rilevati automaticamente dopo aver configurato i criteri di successo](#troubleshooting-success-auto-discovery)
+ [L'individuazione automatica genera report che non voglio](#troubleshooting-unwanted-auto-discovery)
+ [L'individuazione automatica genera molti report di piccole dimensioni per un singolo framework di test](#troubleshooting-reports-combined)
+ [I flussi di lavoro elencati di seguito CI/CD non corrispondono a quelli del repository di origine](#troubleshooting-workflow-source)
+ [Non riesco a creare o aggiornare i flussi di lavoro](#troubleshooting-workflows-branchrules)
## Come posso correggere i messaggi «Workflow is inactive»?
**Problema**: nella CodeCatalyst console, in **CI/CD**, **Workflows**, il flusso di lavoro viene visualizzato con il seguente messaggio:
`Workflow is inactive.`
Questo messaggio indica che il file di definizione del flusso di lavoro contiene un trigger che non si applica al ramo in cui ti trovi attualmente. Ad esempio, il file di definizione del flusso di lavoro potrebbe contenere un `PUSH` trigger che fa riferimento al tuo `main` ramo, ma ti trovi su un feature branch. Poiché le modifiche che stai apportando al feature branch non si applicano a`main`, e non avvieranno, il flusso di lavoro viene eseguito in`main`, CodeCatalyst disattiva il flusso di lavoro sul branch e lo contrassegna come. `Inactive`
**Possibili soluzioni.**
Se desideri avviare un flusso di lavoro sul tuo feature branch, puoi fare quanto segue:
+ Nel tuo feature branch, nel file di definizione del flusso di lavoro, rimuovi la `Branches` proprietà dalla `Triggers` sezione in modo che abbia il seguente aspetto:
```
Triggers:
- Type: PUSH
```
Questa configurazione fa sì che il trigger si attivi quando viene inviato un push a qualsiasi branch, incluso il feature branch. Se il trigger è attivato, CodeCatalyst avvierà l'esecuzione di un flusso di lavoro utilizzando il file di definizione del flusso di lavoro e i file sorgente presenti nel ramo verso cui si sta eseguendo il push.
+ Nel tuo feature branch, nel file di definizione del flusso di lavoro, rimuovi la `Triggers` sezione ed esegui il flusso di lavoro manualmente.
+ Nel tuo feature branch, nel file di definizione del flusso di lavoro, modifica la `PUSH` sezione in modo che faccia riferimento al tuo feature branch anziché a un altro ramo (come`main`, ad esempio).
**Importante**
Fai attenzione a non confermare queste modifiche se non intendi unirle per tornare alla tua `main` filiale.
Per ulteriori informazioni sulla modifica del file di definizione del flusso di lavoro, consulta[Creazione di un flusso di lavoro](workflows-create-workflow.md).
Per ulteriori informazioni sui trigger, consulta [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md).
## Come posso correggere gli errori «La definizione del flusso di lavoro presenta *n* errori»?
**Problema**: viene visualizzato uno dei seguenti messaggi di errore:
**Errore 1:**
Nella pagina **CI/CD**, **Flussi di lavoro**, sotto il nome del flusso di lavoro, vedi:
`Workflow definition has n errors`
**Errore 2:**
Durante la modifica di un flusso di lavoro, scegli il pulsante **Convalida** e nella parte superiore della CodeCatalyst console viene visualizzato il seguente messaggio:
`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`
**Errore 3:**
Dopo aver visitato la pagina dei dettagli del flusso di lavoro, viene visualizzato il seguente errore nel campo **Definizione del flusso di lavoro**:
`n errors`
**Possibili soluzioni.**
+ Scegli **CI/CD**, scegli **Flussi di lavoro** e scegli il nome del flusso di lavoro che presenta l'errore. Nel campo **Definizione del flusso** di lavoro in alto, scegli il link all'errore. I dettagli sull'errore vengono visualizzati nella parte inferiore della pagina. Segui i suggerimenti per la risoluzione dei problemi riportati nell'errore per risolvere il problema.
+ Assicurati che il file di definizione del flusso di lavoro sia un file YAML.
+ Assicurati che le proprietà YAML nel file di definizione del flusso di lavoro siano annidate al livello corretto. Per vedere come devono essere annidate le proprietà nel file di definizione del flusso di lavoro, consultate o consultate la [Definizione YAML del flusso di lavoro](workflow-reference.md) documentazione dell'azione, che è collegata a from. [Aggiungere un'azione a un flusso di lavoro](workflows-add-action.md)
+ Accertatevi che gli asterischi (`*`) e gli altri caratteri speciali non compaiano correttamente. Per evitarli, aggiungete virgolette singole o doppie. Esempio:
```
Outputs:
Artifacts:
- Name: myartifact
Files:
- "**/*"
```
Per ulteriori informazioni sui caratteri speciali nel file di definizione del flusso di lavoro, consulta[Linee guida e convenzioni sulla sintassi](workflow-reference.md#workflow.terms.syntax.conv).
+ Assicurati che le proprietà YAML nel file di definizione del flusso di lavoro utilizzino le maiuscole corrette. Per ulteriori informazioni sulle regole di classificazione delle maiuscole, consulta. [Linee guida e convenzioni sulla sintassi](workflow-reference.md#workflow.terms.syntax.conv) Per determinare la classificazione delle maiuscole e minuscole corretta per ogni proprietà[Definizione YAML del flusso di lavoro](workflow-reference.md), consulta o consulta la documentazione relativa all'azione, che è collegata a from. [Aggiungere un'azione a un flusso di lavoro](workflows-add-action.md)
+ Assicurati che la `SchemaVersion` proprietà sia presente e impostata sulla versione corretta nel file di definizione del flusso di lavoro. Per ulteriori informazioni, consulta [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Assicuratevi che la `Triggers` sezione del file di definizione del flusso di lavoro includa tutte le proprietà richieste. Per determinare le proprietà richieste, scegli il trigger nell'[editor visivo](workflow.md#workflow.editors) e cerca i campi in cui mancano informazioni, oppure consulta la documentazione di riferimento del trigger all'indirizzo[Triggers](workflow-reference.md#triggers-reference).
+ Assicurati che la `DependsOn` proprietà nel file di definizione del flusso di lavoro sia configurata correttamente e non introduca dipendenze circolari. Per ulteriori informazioni, consulta [Azioni di sequenziamento](workflows-depends-on.md).
+ Assicuratevi che la `Actions` sezione del file di definizione del flusso di lavoro includa almeno un'azione. Per ulteriori informazioni, consulta [Azioni](workflow-reference.md#actions-reference).
+ Assicurati che ogni azione includa tutte le proprietà richieste. Per determinare le proprietà richieste, scegli l'azione nell'[editor visivo](workflow.md#workflow.editors) e cerca i campi in cui mancano informazioni, oppure consulta la documentazione dell'azione, a cui è collegato il link da[Aggiungere un'azione a un flusso di lavoro](workflows-add-action.md).
+ Assicurati che tutti gli artefatti di input abbiano artefatti di output corrispondenti. Per ulteriori informazioni, consulta [Definizione di un artefatto di output](workflows-working-artifacts-output.md).
+ Assicuratevi che le variabili definite in un'azione vengano esportate in modo che possano essere utilizzate in altre azioni. Per ulteriori informazioni, consulta [Esportazione di una variabile in modo che altre azioni possano utilizzarla](workflows-working-with-variables-export-input.md).
## Come posso correggere gli errori «Impossibile individuare le credenziali» e "ExpiredToken"?
**Problema**: durante l'elaborazione[Tutorial: distribuzione di un'applicazione su Amazon EKS](deploy-tut-eks.md), nella finestra del terminale della macchina di sviluppo vengono visualizzati uno o entrambi i seguenti messaggi di errore:
`Unable to locate credentials. You can configure credentials by running "aws configure".`
`ExpiredToken: The security token included in the request is expired`
**Possibili soluzioni.**
Questi errori indicano che le credenziali che stai utilizzando per accedere ai AWS servizi sono scadute. In questo caso, non eseguire il `aws configure` comando. Utilizzate invece le seguenti istruzioni per aggiornare la chiave di AWS accesso e il token di sessione.
**Per aggiornare la chiave di AWS accesso e il token di sessione**
1. Assicurati di avere l'URL del portale di AWS accesso, il nome utente e la password dell'utente che stai utilizzando per completare il tutorial Amazon EKS (`codecatalyst-eks-user`). Dovresti aver configurato questi elementi al termine [Passaggio 1: configura la tua macchina di sviluppo](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) del tutorial.
**Nota**
Se non disponi di queste informazioni, vai alla pagina dei `codecatalyst-eks-user` dettagli in IAM Identity Center, scegli **Reimposta password**, **Genera una password monouso [...]** e **Reimposta nuovamente la password** per visualizzare le informazioni sullo schermo.
1. Esegui una delle seguenti operazioni:
+ Incolla l'URL del portale di AWS accesso nella barra degli indirizzi del browser.
Or
+ Aggiorna la pagina del portale di AWS accesso se è già stata caricata.
1. Accedi con il nome `codecatalyst-eks-user` utente e la password, se non hai già effettuato l'accesso.
1. Scegli **Account AWS**, quindi scegli il nome Account AWS a cui hai assegnato l'`codecatalyst-eks-user`utente e il set di autorizzazioni.
1. Accanto al nome del set di autorizzazioni (`codecatalyst-eks-permission-set`), scegliete Accesso da **riga di comando o accesso programmatico**.
1. Copia i comandi al centro della pagina. Sono simili ai seguenti:
```
export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
export AWS_SESSION_TOKEN="session-token"
```
... *session-token* dov'è una lunga stringa casuale.
1. Incolla i comandi nel prompt del terminale sulla tua macchina di sviluppo e premi Invio.
Le nuove chiavi e il token di sessione vengono caricati.
Ora hai aggiornato le tue credenziali. I `kubectl` comandi AWS CLI`eksctl`, e ora dovrebbero funzionare.
## Come posso correggere gli errori «Impossibile connettersi al server»?
**Problema**: durante l'esecuzione del tutorial descritto in[Tutorial: distribuzione di un'applicazione su Amazon EKS](deploy-tut-eks.md), viene visualizzato un messaggio di errore simile al seguente nella finestra del terminale della macchina di sviluppo:
`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`
**Possibili soluzioni.**
Questo errore indica in genere che le credenziali utilizzate dall'`kubectl`utilità per connettersi al cluster Amazon EKS sono scadute. Per risolvere il problema, aggiorna le credenziali inserendo il seguente comando al prompt del terminale:
```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```
Dove:
+ *codecatalyst-eks-cluster*viene sostituito dal nome del tuo cluster Amazon EKS.
+ *us-west-2*viene sostituito dalla AWS regione in cui è distribuito il cluster.
## Perché mancano CodeDeploy dei campi nell'editor visivo?
**Problema**: stai utilizzando un'azione [Deploy to Amazon ECS](deploy-action-ecs.md) e non vedi CodeDeploy i campi come **CodeDeploy AppSpec**nell'editor visivo del flusso di lavoro. Questo problema può verificarsi perché il servizio Amazon ECS specificato nel campo **Servizio** non è configurato per eseguire distribuzioni blu/verdi.
**Possibili soluzioni.**
+ **Scegli un servizio Amazon ECS diverso nella scheda Configurazione dell'azione **Deploy to Amazon ECS.**** Per ulteriori informazioni, consulta [Distribuzione su Amazon ECS con un flusso di lavoro](deploy-action-ecs.md).
+ Configura il servizio Amazon ECS selezionato per eseguire le blue/green distribuzioni. Per ulteriori informazioni sulla configurazione delle distribuzioni, consulta [Blue/Green blue/green deployment with nella](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) *Amazon Elastic* Container Service CodeDeploy Developer Guide.
## Come posso correggere gli errori relativi alle funzionalità IAM?
**Problema****: stai utilizzando un'azione [Deploy CloudFormation stack](deploy-action-cfn.md) e lo vedi `##[error] requires capabilities: [capability-name]` nei log dell'azione Deploy stack. CloudFormation **
**Possibili correzioni**: completa la seguente procedura per aggiungere la funzionalità al file di definizione del flusso di lavoro. Per ulteriori informazioni sulle funzionalità IAM, consulta la sezione [Riconoscimento delle risorse IAM nei CloudFormation modelli nella Guida per](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) l'*utente IAM*.
------
#### [ Visual ]
**Per aggiungere una funzionalità IAM utilizzando l'editor visivo**
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **Visual**.
1. Nel diagramma del flusso di lavoro, scegli l'**azione Deploy CloudFormation stack.**
1. Scegli la scheda **Configurazione**.
1. In basso, scegli **Avanzato** - opzionale.
1. Nell'elenco a discesa **Funzionalità**, seleziona la casella di controllo accanto alla funzionalità menzionata nel messaggio di errore. Se la funzionalità non è disponibile nell'elenco, usa l'editor YAML per aggiungerla.
1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
1. Se l'esecuzione di un nuovo flusso di lavoro non si avvia automaticamente, esegui il flusso di lavoro manualmente per vedere se le modifiche correggono l'errore. Per ulteriori informazioni sull'esecuzione manuale di un flusso di lavoro, consulta[Avvio manuale dell’esecuzione di un flusso di lavoro](workflows-manually-start.md).
------
#### [ YAML ]
**Per aggiungere una funzionalità IAM utilizzando l'editor YAML**
1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **YAML**.
1. Nell'azione **Deploy CloudFormation stack**, aggiungi una `capabilities` proprietà, come questa:
```
DeployCloudFormationStack:
Configuration:
capabilities: capability-name
```
Sostituisci *capability-name* con il nome della funzionalità IAM mostrata nel messaggio di errore. Usa virgole e nessun spazio per elencare più funzionalità. Per ulteriori informazioni, vedere la descrizione della `capabilities` proprietà nel[Azione 'Implementa CloudFormation stack' YAML](deploy-action-ref-cfn.md).
1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
1. Se l'esecuzione di un nuovo flusso di lavoro non si avvia automaticamente, esegui il flusso di lavoro manualmente per vedere se le modifiche correggono l'errore. Per ulteriori informazioni sull'esecuzione manuale di un flusso di lavoro, consulta[Avvio manuale dell’esecuzione di un flusso di lavoro](workflows-manually-start.md).
------
## Come posso correggere gli errori di «npm install»?
**Problema**: l'azione [AWS CDK deploy o l'azione AWS CDK](cdk-dep-action.md) [bootstrap](cdk-boot-action.md) falliscono con un errore. `npm install` Questo errore può verificarsi perché stai archiviando le dipendenze AWS CDK dell'app in un registro di gestione dei pacchetti del nodo privato (npm) a cui l'azione non può accedere.
**Possibili correzioni**: utilizza le seguenti istruzioni per aggiornare il `cdk.json` file dell' AWS CDK app con informazioni aggiuntive sul registro e sull'autenticazione.
**Prima di iniziare**
1. Crea segreti per le tue informazioni di autenticazione. Farai riferimento a questi segreti nel `cdk.json` file invece di fornire gli equivalenti in chiaro. Per creare i segreti:
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Secrets.**
1. Crea due segreti con le seguenti proprietà:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Per ulteriori informazioni sui segreti, vedere[Mascherare i dati utilizzando segreti](workflows-secrets.md).
1. Aggiungi i segreti come variabili di ambiente alla tua AWS CDK azione. L'azione sostituirà le variabili con valori reali durante l'esecuzione. Per aggiungere i segreti:
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **Visual**.
1. Nel diagramma del flusso di lavoro, scegli la tua AWS CDK azione.
1. Scegli la scheda **Input**.
1. Aggiungi due variabili con le seguenti proprietà:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/troubleshooting-workflows.html)
Ora hai due variabili contenenti riferimenti a segreti.
Il codice YAML del file di definizione del flusso di lavoro dovrebbe essere simile al seguente:
**Nota**
Il seguente esempio di codice proviene da un'azione di **AWS CDK bootstrap**; un'azione di **AWS CDK distribuzione avrà un aspetto** simile.
```
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"
```
Ora sei pronto per utilizzare le `NPMTOKEN` variabili `NPMUSER` and nel tuo `cdk.json` file. Passate alla procedura successiva.
**Per aggiornare il file cdk.json**
1. Passa alla directory principale del AWS CDK progetto e apri il file. `cdk.json`
1. Trova la `"app":` proprietà e modificala per includere il codice mostrato in*red italics*:
**Nota**
Il codice di esempio seguente proviene da un TypeScript progetto. Se stai usando un JavaScript progetto, il codice avrà un aspetto simile ma non identico.
```
{
"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. Nel codice evidenziato in*red italics*, sostituisci:
+ *your-registry/folder/CDK-package/*con il percorso delle dipendenze AWS CDK del progetto nel registro privato.
+ *hello-cdk.ts\$1.js*con il nome del file entrypoint. Questo può essere un file `.ts` (TypeScript) o `.js` (JavaScript) a seconda della lingua che stai usando.
**Nota**
L'azione sostituirà *NPMTOKEN* le variabili *NPMUSER* and con il nome utente e il token di accesso npm che hai specificato in **Secrets**.
1. Salva il file `cdk.json`.
1. Esegui nuovamente l'azione manualmente per vedere se le modifiche risolvono l'errore. Per ulteriori informazioni sull'esecuzione manuale delle azioni, vedere[Avvio manuale dell’esecuzione di un flusso di lavoro](workflows-manually-start.md).
## Perché più flussi di lavoro hanno lo stesso nome?
I flussi di lavoro vengono archiviati per ramo per repository. Due flussi di lavoro diversi possono avere lo stesso nome se esistono in rami diversi. Nella pagina Flussi di lavoro, puoi differenziare i flussi di lavoro con lo stesso nome osservando il nome del ramo. Per ulteriori informazioni, consulta [Organizzazione del codice sorgente, lavoro con le filiali di Amazon CodeCatalyst](source-branches.md).
![\[Ramo Workflow\]](http://docs.aws.amazon.com/it_it/codecatalyst/latest/userguide/images/flows/workflow-branch.png)
## Posso archiviare i miei file di definizione del flusso di lavoro in un'altra cartella?
No, è necessario archiviare tutti i file di definizione del flusso di lavoro nella `.codecatalyst/workflows` cartella o nelle sottocartelle di tale cartella. Se utilizzi un repository mono con più progetti logici, posiziona tutti i file di definizione del flusso di lavoro `.codecatalyst/workflows` nella cartella o in una delle relative sottocartelle, quindi utilizza il campo **File modificati** (editor visivo) o la `FilesChanged` proprietà (editor YAML) all'interno di un trigger per attivare automaticamente il flusso di lavoro in un percorso di progetto specificato. Per ulteriori informazioni, consultare [Aggiungere trigger ai flussi di lavoro](workflows-add-trigger-add.md) e [Esempio: un trigger con push, branch e file](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).
## Come posso aggiungere azioni in sequenza al mio flusso di lavoro?
Per impostazione predefinita, quando aggiungi un'azione al tuo flusso di lavoro, questa non avrà dipendenze e verrà eseguita in parallelo con altre azioni.
Se desideri disporre le azioni in sequenza, puoi impostare una dipendenza da un'altra azione impostando il `DependsOn` campo. Puoi anche configurare un'azione per consumare artefatti o variabili che sono risultati di altre azioni. Per ulteriori informazioni, consulta [Azioni di sequenziamento](workflows-depends-on.md).
## Perché il mio flusso di lavoro viene convalidato correttamente ma fallisce in fase di esecuzione?
Se hai convalidato il flusso di lavoro utilizzando il `Validate` pulsante, ma il flusso di lavoro non è riuscito comunque, potrebbe trattarsi di una limitazione nel validatore.
Eventuali errori relativi a una CodeCatalyst risorsa come segreti, ambienti o flotte nella configurazione del flusso di lavoro non verranno registrati durante un commit. Se vengono utilizzati riferimenti non validi, l'errore verrà identificato solo quando viene eseguito un flusso di lavoro. Analogamente, se sono presenti errori nella configurazione delle azioni, ad esempio la mancanza di un campo obbligatorio o errori di battitura negli attributi delle azioni, tali errori verranno identificati solo durante l'esecuzione del flusso di lavoro. Per ulteriori informazioni, consulta [Creazione di un flusso di lavoro](workflows-create-workflow.md).
## L'individuazione automatica non rileva alcun rapporto relativo alla mia azione
**Problema:** ho configurato l'individuazione automatica per un'azione che esegue test, ma non viene rilevato alcun report. CodeCatalyst
**Possibili correzioni:** il problema potrebbe essere causato da diversi problemi. Prova una o più delle seguenti soluzioni:
+ Assicurati che lo strumento utilizzato per eseguire i test produca output in uno dei formati compatibili CodeCatalyst . Ad esempio, se desideri consentire CodeCatalyst di scoprire `pytest` i report sui test e sulla copertura del codice, includi i seguenti argomenti:
```
--junitxml=test_results.xml --cov-report xml:test_coverage.xml
```
Per ulteriori informazioni, consulta [Tipi di report sulla qualità](test-workflow-actions.md#test-reporting).
+ Assicurati che l'estensione del file per gli output sia coerente con il formato scelto. Ad esempio, quando configuri `pytest` per produrre risultati in `JUnitXML` formato, verifica che l'estensione del file sia. `.xml` Per ulteriori informazioni, consulta [Tipi di report sulla qualità](test-workflow-actions.md#test-reporting).
+ Assicuratevi che `IncludePaths` sia configurato per includere l'intero file system (`**/*`) a meno che non stiate escludendo alcune cartelle di proposito. Allo stesso modo, assicurati di `ExcludePaths` non escludere le directory in cui prevedi che si trovino i report.
+ Se hai configurato manualmente un report per utilizzare un file di output specifico, verrà escluso dal rilevamento automatico. Per ulteriori informazioni, consulta [Rapporti sulla qualità (esempio YAML).](test-config-action.md#test.success-criteria-example).
+ L'individuazione automatica potrebbe non trovare i report perché l'azione non è riuscita prima che venissero generati gli output. Ad esempio, la compilazione potrebbe aver avuto esito negativo prima dell'esecuzione di qualsiasi test unitario.
## La mia azione non riesce sui report rilevati automaticamente dopo aver configurato i criteri di successo
**Problema:** quando abilito l'individuazione automatica e configuro i criteri di successo, alcuni report non soddisfano i criteri di successo e di conseguenza l'azione fallisce.
**Possibili correzioni:** per risolvere il problema, prova una o più delle seguenti soluzioni:
+ Modifica `IncludePaths` o `ExcludePaths` escludi i report che non ti interessano.
+ Aggiorna i criteri di successo per consentire l'esecuzione di tutti i report. Ad esempio, se vengono rilevati due report con una copertura di linea del 50% e un altro del 70%, regola la copertura minima della linea al 50%. Per ulteriori informazioni, consulta [Criteri di successo](test-best-practices.md#test.best-success-criteria)
+ Trasforma il rapporto di errore in un rapporto configurato manualmente. Ciò consente di configurare diversi criteri di successo per quel rapporto specifico. Per ulteriori informazioni, consulta [Configurazione dei criteri di successo per i report](test-config-action.md#test.success-criteria).
## L'individuazione automatica genera report che non voglio
**Problema:** quando abilito l'individuazione automatica, genera report che non voglio. Ad esempio, CodeCatalyst genera report sulla copertura del codice per i file inclusi nelle dipendenze della mia applicazione archiviate in. `node_modules`
**Possibili correzioni:** è possibile regolare la `ExcludePaths` configurazione per escludere i file indesiderati. Ad esempio, per escludere`node_modules`, aggiungi`node_modules/**/*`. Per ulteriori informazioni, consulta [Includi/escludi percorsi](test-best-practices.md#test.best-include-exclude).
## L'individuazione automatica genera molti report di piccole dimensioni per un singolo framework di test
**Problema:** quando utilizzo determinati framework di reporting di test e copertura del codice, ho notato che l'individuazione automatica genera un gran numero di report. Ad esempio, quando si utilizza il [plug-in Maven Surefire](https://maven.apache.org/surefire/maven-surefire-plugin/), l'individuazione automatica produce un report diverso per ogni classe di test.
**Possibili correzioni:** il framework potrebbe essere in grado di aggregare gli output in un unico file. Ad esempio, se utilizzi il plug-in Maven Surefire, puoi utilizzarlo per aggregare i file manualmente. `npx junit-merge` L'espressione completa può essere simile a questa:
```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```
## I flussi di lavoro elencati di seguito CI/CD non corrispondono a quelli del repository di origine
**Problema:** [i flussi di lavoro visualizzati nella pagina **CI/CD**, **Flussi di lavoro** non corrispondono a quelli nella cartella del `~/.codecatalyst/workflows/` repository di origine.](source.md) È possibile che si verifichino le seguenti discrepanze:
+ Nella pagina **Flussi di lavoro viene visualizzato un flusso di lavoro**, ma nel repository di origine non esiste un file di definizione del flusso di lavoro corrispondente.
+ **Nel repository di origine esiste un file di definizione del flusso di lavoro, ma un flusso di lavoro corrispondente non viene visualizzato nella pagina Flussi di lavoro.**
+ Esiste un flusso di lavoro sia nel repository di origine che nella pagina **Flussi di lavoro**, ma i due sono diversi.
Questo problema può verificarsi se la pagina **Flussi di lavoro** non ha avuto il tempo di aggiornarsi o se è stata superata la quota del flusso di lavoro.
**Possibili soluzioni.**
+ Attesa. **In genere è necessario attendere due o tre secondi dopo il commit al codice sorgente prima di visualizzare la modifica nella pagina Flussi di lavoro.**
+ Se hai superato la quota del flusso di lavoro, esegui una delle seguenti operazioni:
**Nota**
**Per determinare se una quota di flusso di lavoro è stata superata[Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md), rivedi e confronta le quote documentate con i flussi di lavoro nel tuo repository di origine o nella pagina Flussi di lavoro.** Non viene visualizzato alcun messaggio di errore che indichi che una quota è stata superata, quindi dovrai indagare da solo.
+ Se hai superato il **numero massimo di flussi di lavoro per quota di spazio, elimina alcuni flussi** di lavoro e quindi esegui un test commit sul file di definizione del flusso di lavoro. Un esempio di commit di test potrebbe essere l'aggiunta di uno spazio al file.
+ Se hai superato la quota di **dimensione massima del file di definizione del flusso** di lavoro, modifica il file di definizione del flusso di lavoro per ridurne la lunghezza.
+ Se hai superato la **quota massima di file di workflow elaborati in un'unica quota di eventi di origine**, esegui diversi commit di test. Modifica un numero di flussi di lavoro inferiore al massimo in ogni commit.
## Non riesco a creare o aggiornare i flussi di lavoro
**Problema:** voglio creare o aggiornare un flusso di lavoro, ma visualizzo un errore quando tento di eseguire la modifica.
**Possibili correzioni:** a seconda del ruolo che ricopri nel progetto o nello spazio, potresti non avere le autorizzazioni per inviare codice agli archivi di origine del progetto. I file YAML per i flussi di lavoro sono archiviati nei repository. Per ulteriori informazioni, consulta [File di definizione del flusso di lavoro](workflows-concepts.md#workflows-concepts-workflows-def). Il ruolo di **amministratore dello spazio**, il ruolo di **amministratore del progetto** e il ruolo di **collaboratore** sono tutti autorizzati a eseguire il commit e inviare codice ai repository di un progetto.
Se hai il ruolo di **Collaboratore** ma non puoi creare o confermare modifiche al flusso di lavoro YAML in un ramo specifico, è possibile che per quel ramo sia configurata una regola di branch che impedisce agli utenti con quel ruolo di inviare codice a quel particolare ramo. Prova a creare un flusso di lavoro in un ramo diverso o a trasferire le modifiche in un ramo diverso. Per ulteriori informazioni, consulta [Gestisci le azioni consentite per una filiale con le regole della filiale](source-branches-branch-rules.md).
# Risoluzione dei problemi relativi ai problemi
Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni relativi a. CodeCatalyst
**Topics**
+ [Non riesco a scegliere un assegnatario per il mio problema](#troubleshooting-issues-assignees)
## Non riesco a scegliere un assegnatario per il mio problema
**Problema:** quando si crea un problema, l'elenco degli assegnatari è vuoto.
**Possibili correzioni:** l'elenco degli assegnatari è collegato direttamente CodeCatalyst agli utenti elencati come membri del progetto. **Per verificare che l'accesso al profilo utente funzioni correttamente, scegli l'icona del profilo, quindi scegli Profilo utente.** Se le informazioni del profilo utente non vengono inserite, consulta il rapporto sullo stato di salute per eventuali incidenti. Se viene compilato, invia un ticket di assistenza.
# Risoluzione dei problemi relativi alla ricerca in CodeCatalyst
Consulta le seguenti sezioni per risolvere i problemi relativi alla ricerca in. CodeCatalyst Per ulteriori informazioni sui flussi di lavoro, consulta [Cerca codice, problemi, progetti e utenti in CodeCatalystCerca codice, problemi, progetti e utenti](search.md).
**Topics**
+ [Non riesco a trovare un utente nel mio progetto](#troubleshooting-search-users)
+ [Non vedo cosa sto cercando nel mio progetto o nel mio spazio](#troubleshooting-missing-results)
+ [Il numero di risultati di ricerca continua a cambiare quando navigo tra le pagine](#troubleshooting-search-results)
+ [La mia query di ricerca non è stata completata](#troubleshooting-requests-limits)
## Non riesco a trovare un utente nel mio progetto
**Problema:** quando cerco di visualizzare i dettagli di un utente, non vedo le sue informazioni nel progetto.
**Possibili correzioni:** attualmente la ricerca non supporta la ricerca di utenti all'interno di un progetto. Per cercare utenti con accesso al tuo spazio, passa a **Questo spazio** in QuickSearch o rimuovi tutti i filtri di progetto che potresti aver specificato utilizzando il linguaggio di interrogazione avanzato.
## Non vedo cosa sto cercando nel mio progetto o nel mio spazio
**Problema:** i risultati non vengono visualizzati quando cerco di cercare informazioni particolari.
**Possibili correzioni:** è probabile che gli aggiornamenti dei contenuti richiedano alcuni secondi per essere aggiornati nei risultati di ricerca. Gli aggiornamenti di grandi dimensioni possono richiedere diversi minuti.
Per le risorse che non sono state aggiornate di recente, potrebbe essere necessario affinare la ricerca. Puoi perfezionare la ricerca aggiungendo altre parole chiave o utilizzando il linguaggio di interrogazione avanzato. Per ulteriori informazioni sul perfezionamento delle query, consulta. [Perfezionamento della query di ricerca](search.md#search-query-language-examples)
## Il numero di risultati di ricerca continua a cambiare quando navigo tra le pagine
**Problema:** il numero di risultati di ricerca sembra cambiare quando passo alla pagina successiva, quindi non è chiaro quanti risultati totali ci siano.
**Possibili correzioni:** quando navighi tra le pagine dei risultati di ricerca, potresti notare una modifica nel numero di risultati di ricerca che corrispondono alla tua query. Il numero di risultati potrebbe essere aggiornato per riflettere un numero più accurato di corrispondenze scoperte mentre navighi tra le pagine.
Mentre navighi tra i risultati, potresti visualizzare il seguente messaggio: **Nessun risultato per «test»**. Riceverai il messaggio se non avrai accesso ai risultati rimanenti.
## La mia query di ricerca non è stata completata
**Problema:** i risultati della mia query di ricerca non vengono visualizzati e sembra che stia impiegando troppo tempo.
**Possibili correzioni:** la ricerca potrebbe non essere completata quando nello spazio vengono eseguite molte ricerche contemporaneamente, a livello di programmazione o a causa dell'elevata attività del team. Se esegui ricerche programmatiche, mettile in pausa o riducile. Altrimenti, riprova tra qualche secondo.
# Risoluzione dei problemi relativi alle estensioni
Consulta le seguenti sezioni per risolvere i problemi relativi alle estensioni in. CodeCatalyst Per ulteriori informazioni sulle estensioni consulta [Aggiungi funzionalità ai progetti con estensioni in CodeCatalystAggiungi funzionalità ai progetti con estensioni](extensions.md).
**Topics**
+ [Non riesco a visualizzare le modifiche a un archivio di terze parti collegato o a cercare i risultati di tali modifiche](#troubleshooting-detect-3p-changes)
## Non riesco a visualizzare le modifiche a un archivio di terze parti collegato o a cercare i risultati di tali modifiche
**Problema:** le modifiche nel mio repository di terze parti non vengono visualizzate in. CodeCatalyst
**Possibili correzioni:** CodeCatalyst attualmente non supporta il rilevamento delle modifiche nel ramo predefinito per i repository collegati. Per modificare il ramo predefinito per un repository collegato, è necessario prima scollegarlo da CodeCatalyst, modificare il ramo predefinito e quindi collegarlo nuovamente. Per ulteriori informazioni, consulta [Collegamento di GitHub repository, repository Bitbucket, repository di progetti e GitLab progetti Jira in CodeCatalyst](extensions-link.md).
# Risoluzione dei problemi relativi agli account associati al tuo spazio
In CodeCatalyst, puoi aggiungerne uno Account AWS al tuo spazio per concedere autorizzazioni alle risorse e per scopi di fatturazione. Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni relativi agli account associati in. CodeCatalyst
**Topics**
+ [La mia richiesta di Account AWS connessione riceve un errore relativo a un token non valido](#troubleshooting-connection-token)
+ [Il flusso di lavoro CodeCatalyst del mio progetto Amazon non funziona con un errore per l'account configurato, l'ambiente o il ruolo IAM](#connections-troubleshoot-workflow)
+ [Ho bisogno di un account, un ruolo e un ambiente associati per creare un progetto](#connections-troubleshoot-environment)
+ [Non riesco ad accedere alla pagina Amazon CodeCatalyst Spaces nel Console di gestione AWS](#connections-troubleshoot-console)
+ [Voglio un account diverso come account di fatturazione](#connections-troubleshoot-billing)
+ [Il flusso di lavoro del mio progetto fallisce a causa di un errore nel nome della connessione](#connections-troubleshoot-restriction)
## La mia richiesta di Account AWS connessione riceve un errore relativo a un token non valido
**Problema:** quando si crea una richiesta di connessione con un token di connessione, la pagina non accetta il token e mostra un errore che indica che il token non è valido.
**Possibili correzioni:** assicurati di fornire l'ID dell'account che desideri aggiungere al tuo spazio. Per aggiungere l'account devi disporre delle autorizzazioni amministrative Account AWS o poter collaborare con l'amministratore.
Quando scegli di verificare l'account, si aprirà una nuova finestra del browser in. Console di gestione AWSÈ necessario accedere allo stesso account sul lato della console. Riprova dopo aver verificato quanto segue:
+ Hai effettuato l'accesso Console di gestione AWS con lo stesso nome Account AWS che desideri aggiungere al tuo spazio.
+ Hai effettuato l'accesso Console di gestione AWS con la regione impostata sulla regione corretta per il tuo spazio.
+ Se sei arrivato dalla pagina di fatturazione e desideri aggiungerlo Account AWS come account di fatturazione specifico per il tuo spazio, assicurati che l'account non abbia raggiunto la quota di account di fatturazione per uno o più spazi.
## Il flusso di lavoro CodeCatalyst del mio progetto Amazon non funziona con un errore per l'account configurato, l'ambiente o il ruolo IAM
**Problema:** quando il flusso di lavoro viene eseguito e non trova un account configurato o ruoli IAM associati al tuo spazio, devi compilare manualmente i campi ruolo, connessione e ambiente nel flusso di lavoro YAML. Visualizza l'azione del flusso di lavoro non riuscita e nota se i messaggi di errore sono i seguenti:
+ Il ruolo non è disponibile per l'uso con la connessione associata all'ambiente.
+ L'azione non è riuscita. Stato: NON RIUSCITO; Il valore fornito per la connessione o l'ambiente dell'account non è valido. Verifica che la connessione sia associata al tuo spazio e che l'ambiente sia associato al tuo progetto.
+ L'azione non è riuscita. Stato: NON RIUSCITO; Il valore fornito per il ruolo IAM non è valido. Verifica che il nome esista, che il ruolo IAM sia stato aggiunto alla connessione del tuo account e che la connessione sia già associata al tuo CodeCatalyst spazio Amazon
**Possibili correzioni:** [assicurati che i campi YAML del flusso di lavoro abbiano valori accurati per [Environment](build-action-ref.md#build.environment), [Connections](build-action-ref.md#build.environment.connections) e Role.](build-action-ref.md#build.environment.connections.role) Le azioni del CodeCatalyst flusso di lavoro che richiedono un ambiente sono azioni di creazione o distribuzione che eseguono AWS risorse o generano pile di risorse. AWS
**Scegli il blocco di azioni del flusso di lavoro non riuscito, quindi scegli Visual.** Scegli la scheda **Configurazione**. Se i campi **Ambiente**, **Nome connessione** e **Nome ruolo** non sono compilati, dovrai aggiornare manualmente il flusso di lavoro. Utilizza i seguenti passaggi per modificare il tuo flusso di lavoro YAML:
+ Espandi la `/.codecatalyst` directory, quindi espandi la `/workflows` directory. Aprire il file YAML del flusso di lavoro. Assicurati che i ruoli IAM e le informazioni sull'account siano specificati nello YAML che hai configurato per il tuo flusso di lavoro. Esempio:
```
Actions:
cdk_bootstrap:
Identifier: action-@v1
Inputs:
Sources:
- WorkflowSource
Environment:
Name: Staging
Connections:
- Name: account-connection
Role: build-role
```
Le proprietà **Environment, Connection e Role** sono necessarie per eseguire azioni di creazione e distribuzione CodeCatalyst del flusso di lavoro con risorse. AWS [Per un esempio, vedi l'azione di CodeCatalyst compilazione che fa riferimento ai parametri YAML per [Environment](build-action-ref.md#build.environment), [Connections](build-action-ref.md#build.environment.connections) e Role.](build-action-ref.md#build.environment.connections.role)
+ Assicurati che al tuo spazio sia stato aggiunto un account e assicurati che all'account siano stati aggiunti il ruolo o i ruoli IAM appropriati. Puoi modificare o aggiungere account se disponi del ruolo di **amministratore di Space**. Per ulteriori informazioni, consulta [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md).
## Ho bisogno di un account, un ruolo e un ambiente associati per creare un progetto
**Problema:** nelle opzioni di creazione del progetto, al mio progetto non è disponibile un account aggiuntivo nel mio spazio, oppure ho bisogno di aggiungere un altro account al mio spazio da utilizzare per il mio progetto.
**Possibili correzioni:** per il tuo spazio, puoi aggiungere l'autorizzazione Account AWS ad aggiungerli al tuo progetto se hai il ruolo di **amministratore dello spazio**. È inoltre necessario disporre di un account Account AWS in cui disporre delle autorizzazioni amministrative o poter lavorare con il proprio AWS amministratore.
Per assicurarti che un account e un ruolo siano disponibili nella schermata di creazione del progetto, devi prima aggiungere l'account e i ruoli. Per ulteriori informazioni, consulta [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md).
Hai la possibilità di scegliere di creare un ruolo di servizio con una politica di ruolo chiamata politica dei **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruoli. Il ruolo avrà un nome `CodeCatalystWorkflowDevelopmentRole-spaceName` con un identificatore univoco aggiunto. Per ulteriori informazioni sul ruolo e sulla politica relativa ai ruoli, vedere. [Comprensione del ruolo **CodeCatalystWorkflowDevelopmentRole-*spaceName***del servizio](ipa-iam-roles.md#ipa-iam-roles-service-role) Per i passaggi per creare il ruolo, vedere[Creazione del **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-service-create). Il ruolo viene aggiunto al tuo account e disponibile nelle pagine di creazione del progetto in CodeCatalyst.
## Non riesco ad accedere alla pagina Amazon CodeCatalyst Spaces nel Console di gestione AWS
**Problema:** quando provo ad accedere alla CodeCatalyst pagina Amazon in Console di gestione AWS per aggiungere un account al mio CodeCatalyst spazio o aggiungere ruoli a un account in AWS, ricevo un errore di autorizzazione.
**Possibili soluzioni.**
Per il tuo spazio, puoi aggiungere l'autorizzazione Account AWS ad aggiungerli al tuo progetto se hai il ruolo di **amministratore dello spazio**. È inoltre necessario disporre di un account Account AWS in cui si dispone delle autorizzazioni amministrative o è possibile collaborare con AWS l'amministratore. Devi prima assicurarti di aver effettuato l'accesso Console di gestione AWS con lo stesso account che desideri gestire. Dopo aver effettuato l'accesso a Console di gestione AWS, puoi aprire la console e riprovare.
Aprire la CodeCatalyst pagina Amazon Console di gestione AWS nella [https://us-west-2.console.aws.amazon.com/codecatalyst/home page? region=us-west-2\$1/.](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/)
## Voglio un account diverso come account di fatturazione
**Problema:** quando ho configurato il mio CodeCatalyst accesso, ho completato diversi passaggi per configurare il mio spazio e associare un account autorizzato Account AWS. Ora voglio autorizzare un altro account per la fatturazione.
**Possibili correzioni:** **per il tuo spazio, puoi autorizzare gli account di fatturazione se disponi del ruolo di amministratore dello spazio.** È inoltre necessario disporre di un account Account AWS in cui disporre delle autorizzazioni amministrative o poter collaborare con il proprio amministratore. AWS
Per ulteriori informazioni, consulta [Managing billing](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) nella Amazon CodeCatalyst Administrator Guide.
## Il flusso di lavoro del mio progetto fallisce a causa di un errore nel nome della connessione
**Problema:** durante la creazione di un progetto e quindi l'esecuzione del flusso di lavoro del progetto, il flusso di lavoro non riesce e mostra un errore che indica che il nome della connessione non è valido, come segue:
Errore in: il nome della connessione non è valido.
**Possibili correzioni:** assicurati di fornire l'ID dell'account che desideri aggiungere al tuo spazio e assicurati che l'account non sia abilitato per connessioni con account con restrizioni del progetto. Se l'account è abilitato per connessioni con account limitati al progetto, potrebbe essere necessario aggiornare la connessione all'account abilitando l'accesso al nuovo progetto. Per ulteriori informazioni, consulta [Configurazione delle connessioni di account con restrizioni del progetto](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).
# Risoluzione dei problemi tra Amazon CodeCatalyst e il AWS SDKs AWS CLI
Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni quando lavori con CodeCatalyst and the o il. AWS CLI AWS SDKs
**Topics**
+ [Ricevo un errore quando **aws codecatalyst** accedo da una riga di comando o da un terminale che dice che si tratta di una scelta non valida](#cli-sdk-troubleshoot-no-commands)
+ [Ricevo un errore relativo alle credenziali quando eseguo i comandi **aws codecatalyst**](#cli-sdk-troubleshoot-profile)
## Ricevo un errore quando **aws codecatalyst** accedo da una riga di comando o da un terminale che dice che si tratta di una scelta non valida
**Problema:** quando provo a usare AWS CLI with CodeCatalyst, uno o più **aws codecatalyst** comandi non vengono riconosciuti come validi.
**Soluzione:** la causa più comune di questo problema è l'utilizzo di una versione di AWS CLI che non contiene gli aggiornamenti più recenti per i servizi e i comandi più recenti. Aggiorna l'installazione di AWS CLI e riprova. Per ulteriori informazioni, consulta [Configurazione per l'utilizzo AWS CLI di CodeCatalyst](set-up-cli.md).
## Ricevo un errore relativo alle credenziali quando eseguo i comandi **aws codecatalyst**
**Problema:** quando provo a utilizzare il comando AWS CLI with CodeCatalyst, ricevo un messaggio che indica `You can configure credentials by running "aws configure".` o. `Unable to locate authorization token`
**Soluzione:** è necessario configurare un AWS CLI profilo per utilizzare i CodeCatalyst comandi. Per ulteriori informazioni, consulta . [Configurazione per l'utilizzo AWS CLI di CodeCatalyst](set-up-cli.md).