AWS CodeCommit non è più disponibile per i nuovi clienti. I clienti esistenti di AWS CodeCommit possono continuare a utilizzare il servizio normalmente. Scopri di più»
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 HTTPS le connessioni AWS CodeCommit a 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 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 informazioni sui ruoli per la federazione, consulta Creare un ruolo per un provider di identità di terze parti (federazione) nella Guida per l'utente. IAM Se utilizzi IAM Identity Center, configuri un set di autorizzazioni. Per controllare a cosa possono accedere le identità dopo l'autenticazione, IAM Identity Center correla il set di autorizzazioni a un ruolo in. IAM Per informazioni sui set di autorizzazioni, consulta Set di autorizzazioni 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 HTTPS connessione, git-remote-codecommit non richiede l'impostazione delle credenziali Git per l'utente.
Nota
Alcuni IDEs non supportano il URL formato clone utilizzato da. git-remote-codecommit
Potrebbe essere necessario clonare manualmente i repository sul computer locale prima di poterli utilizzare nella modalità preferita. IDE Per ulteriori informazioni, consulta Risoluzione dei problemi git-remote-codecommit e AWS CodeCommit.
Queste procedure sono scritte presupponendo che tu disponga di un account Amazon Web Services, abbia creato almeno un repository e utilizzi un IAM utente 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.
Argomenti
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
Per ulteriori informazioni sulla configurazione e l'utilizzo git-remote-codecommit, vederePassaggi di configurazione per HTTPS le connessioni AWS CodeCommit a 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
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 inRisoluzione dei problemi.
Fase 1: Configurazione iniziale per CodeCommit
Segui questi passaggi per creare un IAM utente, 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 IAM utente per l'accesso CodeCommit
Crea un account Amazon Web Services accedendo a http://aws.amazon.com
e scegliendo Registrati. Crea un IAM utente 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'IAMutente. Per ulteriori informazioni, consulta Creazione di un IAM utente nell'account Amazon Web Services.
Nota
CodeCommit richiede AWS Key Management Service. Se utilizzi un IAM utente esistente, assicurati che all'utente non siano associate politiche che neghino espressamente le AWS KMS azioni richieste da. CodeCommit Per ulteriori informazioni, consulta AWS KMSe crittografia.
Accedi a AWS Management Console e apri la IAM console all'indirizzo. https://console.aws.amazon.com/iam/
-
Nella IAM console, nel riquadro di navigazione, scegli Utenti, quindi scegli l'IAMutente che desideri configurare per CodeCommit l'accesso.
Nella scheda Permissions (Autorizzazioni), scegliere Add permissions (Aggiungi autorizzazioni).
-
In Grant permissions (Concedi autorizzazioni), scegliere Attach existing policies directly (Collega direttamente le policy esistenti).
Dall'elenco delle politiche, seleziona AWSCodeCommitPowerUsero un'altra politica gestita per CodeCommit l'accesso. Per ulteriori informazioni, consulta AWS politiche gestite per CodeCommit.
Dopo aver selezionato la politica da allegare, scegli Avanti: revisione per esaminare l'elenco delle politiche da allegare all'IAMutente. 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 eAutenticazione e controllo degli accessi per AWS CodeCommit.
Per installare e configurare AWS CLI
-
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.
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.
-
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.
-
Configurare AWS CLI con un profilo utilizzando il configure comando, come segue:.
aws configure
Quando richiesto, specificare la chiave di AWS accesso e la chiave di accesso AWS segreta dell'IAMutente con CodeCommit cui utilizzare. Inoltre, assicuratevi di specificare Regione AWS dove si trova il repository, ad esempio.
us-east-2
Quando viene richiesto il formato di output predefinito, specificarejson
. Ad esempio, se state configurando un profilo per un IAM utente: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
jsonhere, and then press Enter
Per ulteriori informazioni sulla creazione e la configurazione dei profili da utilizzare con AWS CLI, consulta quanto segue:
Per connettersi a un repository o a una risorsa in un altro Regione AWS, è necessario 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, vedereRegioni ed endpoint di connessione Git. Per ulteriori informazioni sulle IAM chiavi di accesso e sulle chiavi segrete, vedi Come posso ottenere le credenziali? e gestione delle chiavi di accesso per IAM gli utenti. Per ulteriori informazioni sui profili AWS CLI and, vedere Named Profiles.
-
Fase 2: Installazione git-remote-codecommit
Segui queste fasi per installare git-remote-codecommit.
Per installare git-remote-codecommit
-
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
-
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 il clone URL 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
Apri la CodeCommit console su https://console.aws.amazon.com/codesuite/codecommit/home
. -
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.
-
Trova e seleziona nell'elenco il repository che intendi collegare. Scegli Clone URL, quindi scegli il protocollo che desideri utilizzare per la clonazione o la connessione al repository. Questo copia il clone. URL
Copia il file HTTPS URL se stai utilizzando le credenziali Git con il tuo IAM utente o l'helper per le credenziali incluso in. AWS CLI
Copia il HTTPS (GRC) URL se stai usando il git-remote-codecommit comando sul tuo computer locale.
Copia SSH URL se stai usando una key pair SSH pubblica/privata con il tuo utenteIAM.
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 oppure segui la procedura del tutorial Guida introduttiva a Git e CodeCommit.
-
Al terminale o al prompt dei comandi, clonare il repository con il comando git clone. Usa il nome HTTPS git-remote-codecommit URL che hai copiato e il nome del AWS CLI profilo, se hai creato un profilo con nome. 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 un repository denominato
MyDemoRepo
a un repository locale denominatomy-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-repoPer clonare un repository in un repository Regione AWS diverso da quello configurato nel tuo profilo, includi il nome. Regione AWS Per esempio:
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
Passaggi successivi
Hai completato i prerequisiti. Segui i passaggi indicati Iniziare con CodeCommit per iniziare a utilizzare. CodeCommit
Per scoprire come creare e inviare il tuo primo commit, consultaCrea un commit in AWS CodeCommit. Se non hai familiarità con Git, ti consigliamo di consultare le informazioni in Dove posso trovare ulteriori informazioni su Git? e Guida introduttiva a Git e AWS CodeCommit.