Procedure di configurazione per le connessioni HTTPS a AWS CodeCommit repository su Windows con AWS CLI assistente credenziali

Prima di poterti connettere AWS CodeCommit per la prima volta, devi completare i passaggi di configurazione iniziali. Per la maggior parte degli utenti, ciò può essere eseguito più facilmente attenendosi alle fasi descritte in Per gli utenti HTTPS che utilizzano credenziali Git. Tuttavia, se desideri connetterti CodeCommit utilizzando un account root, un accesso federato o credenziali temporanee, puoi utilizzare l'helper per le credenziali incluso nel. AWS CLI

Nota

Sebbene l'helper per le credenziali sia un metodo supportato per la connessione CodeCommit tramite accesso federato, un provider di identità o credenziali temporanee, il metodo consigliato è installare e utilizzare l'utilità. git-remote-codecommit Per ulteriori informazioni, consulta Procedure di configurazione per le connessioni HTTPS a AWS CodeCommit con git-remote-codecommit.

Questo argomento illustra i passaggi necessari per installare AWS CLI, configurare il computer e il AWS profilo, connettersi a un CodeCommit repository e clonare tale repository sul computer, operazione nota anche come creazione di un repository locale. Se non hai mai utilizzato Git, ti consigliamo di consultare le informazioni in Dove posso saperne di più su Git?.

Fase 1: Configurazione iniziale per CodeCommit

Segui questi passaggi per configurare un account Amazon Web Services, creare e configurare un utente IAM e installare AWS CLI. AWS CLI Include un assistente per le credenziali che configuri per le connessioni HTTPS ai tuoi CodeCommit repository.

Per creare e configurare un utente IAM per l'accesso CodeCommit

1. Crea un account Amazon Web Services andando su http://aws.amazon.com e scegliendo Registrati.

2. Crea un utente IAM o utilizzane uno esistente nel tuo account Amazon Web Services. Assicurati di avere un ID della chiave di accesso e una chiave di accesso segreta associati a quell'utente IAM. Per ulteriori informazioni, consulta Creazione di un utente IAM nel tuo account Amazon Web Services.

   Nota

   CodeCommit richiede AWS Key Management Service. Se stai utilizzando un utente IAM esistente, assicurati che all'utente non siano associate politiche che negino espressamente le AWS KMS azioni richieste da. CodeCommit Per ulteriori informazioni, consulta AWS KMS e crittografia.

3. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. https://console.aws.amazon.com/iam/

4. Nella console IAM, nel pannello di navigazione, scegli Utenti, quindi scegli l'utente IAM che desideri configurare per CodeCommit l'accesso.

5. Nella scheda Permissions (Autorizzazioni), scegliere Add permissions (Aggiungi autorizzazioni).

6. In Grant permissions (Concedi autorizzazioni), scegliere Attach existing policies directly (Collega direttamente le policy esistenti).

7. Dall'elenco delle policy, seleziona AWSCodeCommitPowerUser un'altra policy gestita per CodeCommit l'accesso. Per ulteriori informazioni, consulta AWS politiche gestite per CodeCommit.

   Dopo aver selezionato la policy da allegare, scegli Avanti: Revisione per visualizzare l'elenco delle policy da allegare all'utente IAM. Se l'elenco è corretto, scegliere Add permissions (Aggiungi autorizzazioni).

   Per ulteriori informazioni sulle policy CodeCommit gestite e sulla condivisione dell'accesso ai repository con altri gruppi e utenti, consulta Condividere un repository eAutenticazione e controllo degli accessi per AWS CodeCommit.

Per installare e configurare AWS CLI

1. Sul computer locale, scarica e installa il AWS CLI. Questo è un prerequisito per interagire con CodeCommit dalla riga di comando. Ti consigliamo di installare la AWS CLI versione 2. È la versione principale più recente di AWS CLI e supporta tutte le funzionalità più recenti. È l'unica versione di AWS CLI che supporta l'utilizzo di un account root, accesso federato o credenziali temporanee con. git-remote-codecommit

   Per ulteriori informazioni, vedere Guida introduttiva all'interfaccia a AWS riga di comando.

   Nota

   CodeCommit funziona solo con AWS CLI le versioni 1.7.38 e successive. Come best practice, installa o aggiorna AWS CLI alla versione più recente disponibile. Per determinare quale versione AWS CLI è stata installata, esegui il aws --version comando.

   Per aggiornare una versione precedente di AWS CLI alla versione più recente, vedere Installazione di AWS Command Line Interface.

2. Esegui questo comando per verificare che i CodeCommit comandi per AWS CLI siano installati.

   aws codecommit help

   Questo comando restituisce un elenco di CodeCommit comandi.

3. Configuralo AWS CLI con un profilo utilizzando il configure comando, come segue:.

   aws configure

   Quando richiesto, specifica la chiave di AWS accesso e la chiave di accesso AWS segreta dell'utente IAM con CodeCommit cui utilizzare. Inoltre, assicurati di specificare Regione AWS dove si trova il repository, ad esempio. us-east-2 Quando viene richiesto il formato di output predefinito, specificare json. Ad esempio, se stai configurando un profilo per un utente IAM:

   AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
   AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
   Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
   Default output format [None]: Type json here, and then press Enter

   Per ulteriori informazioni sulla creazione e la configurazione dei profili da utilizzare con AWS CLI, consulta quanto segue:

   • Profili denominati

   • L'utilizzo di un ruolo IAM nel AWS CLI

   • Impostazione del comando

   • Connessione a AWS CodeCommit repository con credenziali rotanti

   Per connettersi a un repository o a una risorsa in un altro Regione AWS, è necessario riconfigurarlo AWS CLI con il nome della regione predefinito. I nomi di regione predefiniti supportati per CodeCommit includono:

   • us-east-2

   • us-east-1

   • eu-west-1

   • us-west-2

   • ap-northeast-1

   • ap-southeast-1

   • ap-southeast-2

   • ap-southeast-3

   • me-central-1

   • eu-central-1

   • ap-northeast-2

   • sa-east-1

   • us-west-1

   • eu-west-2

   • ap-south-1

   • ap-south-1

   • ca-central-1

   • us-gov-west-1

   • us-gov-east-1

   • eu-north-1

   • ap-east-1

   • me-south-1

   • cn-north-1

   • cn-northwest-1

   • eu-south-1

   • ap-northeast-3

   • af-south-1

   • il-central-1

   Per ulteriori informazioni su CodeCommit e Regione AWS, vedereRegioni ed endpoint di connessione Git. Per ulteriori informazioni su IAM, sulle chiavi di accesso e sulle chiavi segrete, consulta How Do I Get Credentials? e Gestione delle chiavi di accesso per gli utenti IAM. Per ulteriori informazioni sui profili AWS CLI e, consulta Named Profiles.

Fase 2: installazione di Git

Per lavorare con file, commit e altre informazioni nei CodeCommit repository, devi installare Git sul tuo computer locale. CodeCommit supporta le versioni Git 1.7.9 e successive. La versione 2.28 di Git supporta la configurazione del nome del ramo per i commit iniziali. Si consiglia di utilizzare una versione recente di Git.

Per installare Git, consigliamo siti web come Git per Windows. Se usi questo link per installare Git, puoi accettare tutte le impostazioni predefinite di installazione tranne le seguenti:

• Quando richiesto durante la fase Adjusting your PATH environment, scegli l'opzione per usare Git dalla riga di comando.

• (Facoltativo) Se intendi utilizzare HTTPS con l'helper per le credenziali incluso in AWS CLI anziché configurare le credenziali Git per CodeCommit, nella pagina Configurazione delle opzioni aggiuntive, assicurati che l'opzione Abilita Git Credential Manager sia deselezionata. Git Credential Manager è compatibile solo se gli utenti IAM configurano le credenziali Git. CodeCommit Per ulteriori informazioni, consulta Per gli utenti HTTPS che utilizzano credenziali Git e Git per Windows: ho installato Git per Windows, ma mi viene negato l'accesso al mio repository (403).

Nota

Git è una piattaforma in evoluzione e regolarmente aggiornata. Di tanto in tanto, una modifica delle funzionalità potrebbe influire sul modo in cui funziona. CodeCommit Se riscontri problemi con una versione specifica di Git and CodeCommit, consulta le informazioni inRisoluzione dei problemi.

Passaggio 3: configura l'helper per le credenziali

AWS CLI Include un helper per le credenziali Git che puoi usare con. CodeCommit L'helper per le credenziali Git richiede un profilo di AWS credenziali, che memorizza una copia dell'ID della chiave di accesso e della chiave di AWS accesso AWS segreta di un utente IAM (insieme a un Regione AWS nome e un formato di output predefiniti). L'helper per le credenziali Git utilizza queste informazioni per autenticarsi automaticamente, CodeCommit quindi non è necessario inserire queste informazioni ogni volta che si utilizza Git per interagire con. CodeCommit

1. Apri un prompt dei comandi e usa Git per l'esecuzionegit config, specificando l'uso dell'helper per le credenziali Git con il profilo delle credenziali, che consente all'helper per AWS le credenziali Git di inviare il percorso ai repository:

   git config --global credential.helper "!aws codecommit credential-helper $@"
   git config --global credential.UseHttpPath true

   L'assistente credenziali Git scrive il seguente valore nel file .gitconfig.

   [credential]    
       helper = !aws codecommit credential-helper $@ 
       UseHttpPath = true  

   Importante

   • Se stai utilizzando un emulatore Bash anziché la riga di comando di Windows, dovrai utilizzare le virgolette singole anziché quelle doppie.

   • L'helper per le credenziali utilizza il profilo predefinito o il ruolo dell'istanza Amazon EC2. AWS Se hai creato un profilo di AWS credenziali da utilizzare, ad esempioCodeCommitProfile, puoi modificare il comando come segue per utilizzarlo al suo posto:

     git config --global credential.helper "!aws codecommit credential-helper --profile CodeCommitProfile $@"

     Nel file .gitconfig viene scritto quanto segue:

     [credential]    
         helper = !aws codecommit credential-helper --profile=CodeCommitProfile $@ 
         UseHttpPath = true  

   • Se il nome del profilo include spazi, dovrai modificare il file .gitconfig dopo avere eseguito il comando per includerlo tra virgolette singole ('). In caso contrario, l'assistente credenziali non funzionerà.

   • Se l'installazione di Git per Windows includeva l'utilità Git Credential Manager, vengono visualizzati errori 403 o richieste di specifica delle credenziali nell'utilità Credential Manager dopo i primi tentativi di connessione. Il modo più sicuro per risolvere questo problema è disinstallare e reinstallare Git per Windows senza l'opzione per l'utilità Git Credential Manager, poiché non è compatibile con CodeCommit. Se desideri mantenere l'utilità Git Credential Manager, devi eseguire ulteriori passaggi di configurazione da utilizzare CodeCommit, inclusa la modifica manuale del file .gitconfig per specificare l'uso dell'helper per le credenziali durante la connessione a. AWS CodeCommit CodeCommit Rimuovi eventuali credenziali archiviate dall'utilità Credential Manager (disponibile nel Pannello di controllo). Dopo avere rimosso le credenziali archiviate, aggiungi quanto segue al file .gitconfig, salva il file ed effettua una nuova connessione da una nuova finestra del prompt dei comandi:

     [credential "https://git-codecommit.us-east-2.amazonaws.com"]
         helper = !aws codecommit credential-helper $@ 
         UseHttpPath = true
     
     [credential "https://git-codecommit.us-east-1.amazonaws.com"]
         helper = !aws codecommit credential-helper $@ 
         UseHttpPath = true
     

     Potrebbe anche essere necessario riconfigurare le impostazioni git config specificando --system anziché --global o --local perché tutte le connessioni funzionino come previsto.

   • Se desideri utilizzare diversi utenti IAM sullo stesso computer locale per CodeCommit, devi specificare git config --local invece di ed eseguire la configurazione per ciascun profilo di git config --global credenziali. AWS

2. Esegui git config --global --edit per verificare che i valori precedenti siano stati scritti nel file .gitconfig per il profilo utente (per impostazione predefinita, %HOME%\.gitconfig oppure drive:\Users\UserName\.gitconfig). In caso di esito positivo, vengono visualizzati i valori precedenti (in aggiunta ai valori che potrebbero essere già presenti nel file di configurazione globale Git). Per uscire, in genere è sufficiente digitare :q e premere Invio.

Passaggio 4: connettiti alla CodeCommit console e clona il repository

Se un amministratore ti ha già inviato il nome e i dettagli di connessione per il CodeCommit repository, puoi saltare questo passaggio e clonare direttamente il repository.

Per connettersi a un repository CodeCommit

1. Apri la CodeCommit console all'indirizzo. https://console.aws.amazon.com/codesuite/codecommit/home

2. Nel selettore di regione, scegli Regione AWS dove è stato creato il repository. I repository sono specifici di un. Regione AWS Per ulteriori informazioni, consulta Regioni ed endpoint di connessione Git.

3. Trova e seleziona nell'elenco il repository che intendi collegare. Scegliere Clone URL (URL clone), quindi scegliere il protocollo che si desidera utilizzare durante la clonazione o la connessione al repository. In questo modo si copia l'URL del clone.

   • Copia l'URL HTTPS se stai utilizzando le credenziali Git con il tuo utente IAM o il credenziale helper incluso nel. AWS CLI

   • Copia l'URL HTTPS (GRC) se usi il comando git-remote-codecommit sul computer locale.

   • Copia l'URL SSH se stai usando una coppia di public/private chiavi SSH con il tuo utente IAM.

   Nota

   Se visualizzi una pagina di benvenuto anziché un elenco di repository, significa che non ci sono repository associati al tuo AWS account nel punto in Regione AWS cui hai effettuato l'accesso. Per creare un repository, consulta Crea un AWS CodeCommit repository oppure segui la procedura del tutorial Guida introduttiva a Git e CodeCommit.

4. Apri un prompt dei comandi ed esegui il git clone comando con l'URL HTTPS che hai copiato. Il repository locale viene creato in una sottodirectory della directory in cui viene eseguito il comando. Ad esempio, per clonare un repository denominato MyDemoRepo in un repository locale denominato my-demo-repo nella regione Stati Uniti orientali (Ohio):

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   In alcune versioni di Windows, potrebbe venire visualizzato un messaggio popup con la richiesta di nome utente e password. Questo è il sistema di gestione delle credenziali integrato per Windows, che tuttavia non è compatibile con l'assistente credenziali per AWS CodeCommit. Seleziona Annulla.

Fasi successive

Hai completato i prerequisiti. Segui i passaggi indicati per iniziare a Guida introduttiva con CodeCommit utilizzare. CodeCommit