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à. # Passaggi di configurazione per le connessioni HTTPS a AWS CodeCommit con git-remote-codecommit Se desideri connetterti CodeCommit utilizzando un account root, un accesso federato o credenziali temporanee, devi configurare l'accesso utilizzando. **git-remote-codecommit** Questa utilità fornisce un metodo semplice per inviare ed estrarre codice dai CodeCommit repository estendendo Git. È il metodo consigliato per supportare le connessioni effettuate con accesso federato, provider di identità e credenziali temporanee. Per assegnare autorizzazioni a un'identità federata, è necessario creare un ruolo e definire le autorizzazioni per il ruolo. Quando un’identità federata viene autenticata, l’identità viene associata al ruolo e ottiene le autorizzazioni da esso definite. Per ulteriori informazioni sulla federazione dei ruoli, consulta [ Creare un ruolo per un provider di identità di terze parti (federazione)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) nella *Guida per l'utente IAM*. Se si utilizza IAM Identity Center, configurare un set di autorizzazioni. IAM Identity Center mette in correlazione il set di autorizzazioni con un ruolo in IAM per controllare a cosa possono accedere le identità dopo l’autenticazione. Per informazioni sui set di autorizzazioni, consulta [Set di autorizzazioni](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) nella *Guida per l’utente di AWS IAM Identity Center *. Puoi utilizzarlo anche **git-remote-codecommit** con un utente IAM. A differenza di altri metodi di connessione HTTPS, **git-remote-codecommit** non richiede l'impostazione delle credenziali Git per l'utente. **Nota** Alcuni IDEs non supportano il formato URL clone utilizzato da`git-remote-codecommit`. Potrebbe essere necessario clonare manualmente i repository nel computer locale prima di poterli utilizzare nell'IDE preferito. Per ulteriori informazioni, consulta [Risoluzione dei problemi git-remote-codecommit e AWS CodeCommit](troubleshooting-grc.md). Queste procedure sono scritte presupponendo che tu disponga di un account Amazon Web Services, abbia creato almeno un repository e utilizzi un utente IAM con una policy gestita per la connessione ai CodeCommit repository. CodeCommit Per informazioni su come configurare l'accesso per gli utenti federati e altri tipi di rotazione delle credenziali, consulta [Connessione ai AWS CodeCommit repository con credenziali rotanti](temporary-access.md). **Topics** + [Fase 0: Installare i prerequisiti per git-remote-codecommit](#setting-up-git-remote-codecommit-prereq) + [Fase 1: Configurazione iniziale per CodeCommit](#setting-up-git-remote-codecommit-account) + [Fase 2: Installazione git-remote-codecommit](#setting-up-git-remote-codecommit-install) + [Passaggio 3: Connect alla CodeCommit console e clona il repository](#setting-up-git-remote-codecommit-connect-console) + [Fasi successive](#setting-up-git-remote-codecommit-next-step) ## Fase 0: Installare i prerequisiti per git-remote-codecommit Prima di poter utilizzare **git-remote-codecommit**, è necessario installare alcuni prerequisiti nel computer locale. Ciò include: + Una versione supportata di Python. Per ulteriori informazioni sulle versioni supportate di Python, vedere. [git-remote-codecommit](https://pypi.org/project/git-remote-codecommit/) Per ulteriori informazioni sulla configurazione e l'utilizzo git-remote-codecommit, vedere[Passaggi di configurazione per le connessioni HTTPS a AWS CodeCommit con git-remote-codecommit](#setting-up-git-remote-codecommit). + Git **Nota** Quando installi Python su Windows, assicurati di scegliere l'opzione per aggiungere Python al percorso. **git-remote-codecommit** richiede pip versione 9.0.3 o successiva. Per controllare la versione di pip, apri un terminale o una riga di comando ed esegui il comando seguente: ``` pip --version ``` Puoi eseguire i due comandi seguenti per aggiornare pip alla versione più recente: ``` curl -O https://bootstrap.pypa.io/get-pip.py python3 get-pip.py --user ``` 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 Git 2.28 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 Downloads](http://git-scm.com/downloads). **Nota** Git è una piattaforma in evoluzione e regolarmente aggiornata. Occasionalmente, 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 in[Risoluzione dei problemi](troubleshooting.md). ## Fase 1: Configurazione iniziale per CodeCommit Segui questi passaggi per creare un utente IAM, configurarlo con le politiche appropriate, ottenere una chiave di accesso e una chiave segreta e installare e configurare AWS CLI. **Per creare e configurare un utente IAM per l'accesso CodeCommit** 1. Crea un account Amazon Web Services accedendo a [http://aws.amazon.com](https://aws.amazon.com/) e scegliendo **Registrati**. 1. Crea un utente IAM o usane uno esistente nel tuo account Amazon Web Services. Assicurati di avere un ID 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html). **Nota** CodeCommit richiede AWS Key Management Service. Se utilizzi un utente IAM esistente, assicurati che all'utente non siano associate policy che neghino espressamente le AWS KMS azioni richieste da. CodeCommit Per ulteriori informazioni, consulta [AWS KMS e crittografia](encryption.md). 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/) 1. Nella console IAM, nel pannello di navigazione, scegli **Utenti**, quindi scegli l'utente IAM che desideri configurare per CodeCommit l'accesso. 1. Nella scheda **Permissions (Autorizzazioni)**, scegliere **Add permissions (Aggiungi autorizzazioni)**. 1. In **Grant permissions (Concedi autorizzazioni)**, scegliere **Attach existing policies directly (Collega direttamente le policy esistenti)**. 1. Dall'elenco delle politiche, seleziona **AWSCodeCommitPowerUser**o un'altra politica gestita per CodeCommit l'accesso. Per ulteriori informazioni, consulta [AWS politiche gestite per CodeCommit](security-iam-awsmanpol.md). Dopo aver selezionato la policy da allegare, scegli **Avanti: Revisione** per esaminare l'elenco delle politiche da allegare all'utente IAM. Se l'elenco è corretto, scegliere **Add permissions (Aggiungi autorizzazioni)**. Per ulteriori informazioni sulle politiche CodeCommit gestite e sulla condivisione dell'accesso ai repository con altri gruppi e utenti, consulta [Condividi un repository](how-to-share-repository.md) e[Autenticazione e controllo degli accessi per AWS CodeCommit](auth-and-access-control.md). **Per installare e configurare AWS CLI** 1. Sul computer locale, scarica e installa il AWS CLI. Questo è un prerequisito per interagire con la riga CodeCommit 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, un accesso federato o credenziali temporanee con. **git-remote-codecommit** Per ulteriori informazioni, vedere [Configurazione con l'interfaccia a riga di AWS comando](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html). **Nota** CodeCommit funziona solo con AWS CLI le versioni 1.7.38 e successive. Come procedura consigliata, installa o esegui l'aggiornamento AWS CLI all'ultima versione disponibile. Per determinare quale versione di AWS CLI è installata, esegui il **aws --version** comando. Per aggiornare una versione precedente di AWS CLI alla versione più recente, vedi [Installazione di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html). 1. Esegui questo comando per verificare che i CodeCommit comandi relativi a AWS CLI siano installati. ``` aws codecommit help ``` Questo comando restituisce un elenco di CodeCommit comandi. 1. Configurare 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) + [Utilizzo di un ruolo IAM in AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html) + [Impostazione del comando](https://docs.aws.amazon.com/cli/latest/reference/set.html) + [Connessione ai AWS CodeCommit repository con credenziali rotanti](temporary-access.md) Per connetterti a un repository o a una risorsa in un altro Regione AWS, devi riconfigurarlo AWS CLI con il nome predefinito della regione. I nomi di regione predefiniti supportati includono: CodeCommit + 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, vedere[Regioni ed endpoint di connessione Git](regions.md). Per ulteriori informazioni su IAM, chiavi di accesso e chiavi segrete, consulta [How Do I Get Credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html#IAM_SecurityCredentials)? e [gestione delle chiavi di accesso per gli utenti IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html). Per ulteriori informazioni sui profili AWS CLI and, consulta [Named Profiles](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html). ## Fase 2: Installazione git-remote-codecommit Segui queste fasi per installare **git-remote-codecommit**. **Per installare git-remote-codecommit** 1. Dal terminale o dalla riga di comando, eseguire il comando seguente: ``` pip install git-remote-codecommit ``` **Nota** A seconda del sistema operativo e della configurazione, potrebbe essere necessario eseguire questo comando con autorizzazioni elevate, come sudo, o utilizzare il parametro --user per l'installazione in una directory che non richiede privilegi speciali, come l'account utente corrente. Ad esempio, su un computer che esegue Linux, macOS o Unix: ``` sudo pip install git-remote-codecommit ``` Su un computer con sistema operativo Windows: ``` pip install --user git-remote-codecommit ``` 1. Monitora il processo di installazione finché non viene visualizzato un messaggio di successo. ## Passaggio 3: Connect alla CodeCommit console e clona il repository Se un amministratore ti ha già inviato l'URL del clone da utilizzare **git-remote-codecommit** per il CodeCommit repository, puoi saltare la connessione alla console e clonare direttamente il repository. **Per connettersi a un repository CodeCommit** 1. Apri la CodeCommit console su [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. Nel selettore della 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](regions.md). 1. 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 utilizzi le credenziali Git con il tuo utente IAM o l'helper per le credenziali incluso in. AWS CLI + Copia l'URL HTTPS (GRC) se usi il comando **git-remote-codecommit** sul computer locale. + Copia l'URL SSH se utilizzi una coppia di public/private chiavi SSH con il tuo utente IAM. **Nota** Se vedi una pagina di **benvenuto** anziché un elenco di repository, significa che non ci sono repository associati al tuo AWS account nel luogo in Regione AWS cui hai effettuato l'accesso. Per creare un repository, consulta [Creare un repository AWS CodeCommit](how-to-create-repository.md) oppure segui la procedura del tutorial [Guida introduttiva a Git e CodeCommit](getting-started.md). 1. Al terminale o al prompt dei comandi, clonare il repository con il comando **git clone**. Usa l' git-remote-codecommitURL HTTPS che hai copiato e il nome del AWS CLI profilo, se hai creato un profilo denominato. Se non si specifica un profilo, il comando utilizza il profilo predefinito. Il repository locale viene creato in una sottodirectory della directory in cui viene eseguito il comando. Ad esempio, per clonare il repository *MyDemoRepo* nel repository locale *my-demo-repo*: ``` git clone codecommit://MyDemoRepo my-demo-repo ``` Per clonare lo stesso repository utilizzando un profilo denominato: *CodeCommitProfile* ``` git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo ``` Per clonare un repository in un repository Regione AWS diverso da quello configurato nel tuo profilo, includi il nome. Regione AWS Esempio: ``` git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo ``` ## Fasi successive Hai completato i prerequisiti. Segui i passaggi indicati [Iniziare con CodeCommit ](getting-started-cc.md) per iniziare a utilizzare. CodeCommit Per scoprire come creare e inviare il tuo primo commit, consulta[Crea un commit in AWS CodeCommit](how-to-create-commit.md). Se non hai familiarità con Git, ti consigliamo di consultare le informazioni in [Dove posso saperne di più su Git?](welcome.md#welcome-get-started-with-git) e [Guida introduttiva a Git e AWS CodeCommit](getting-started.md).