Guida introduttiva a Git e AWS CodeCommit

Per creare il CodeCommit repository

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

2. Usa il selettore di regione per scegliere Regione AWS dove vuoi creare il repository. Per ulteriori informazioni, consulta Regioni ed endpoint di connessione Git.

3. Nella pagina Repositories (Repository), scegli Create repository (Crea repository).

4. Nella pagina Create repository (Crea repository), in Repository name (Nome repository), immetti un nome per il repository (ad esempio MyDemoRepo).

   Nota

   I nomi dei repository distinguono tra lettere maiuscole e minuscole e non possono superare i 100 caratteri. Per ulteriori informazioni, consulta Limiti.

5. (Facoltativo) In Description (Descrizione), immettere una descrizione, ad esempio My demonstration repository. Ciò può consentire agli utenti di identificare lo scopo del repository.

6. (Facoltativo) Scegliere Add tag (Aggiungi tag) per aggiungere uno o più tag del repository (un'etichetta attributo personalizzata che consente di organizzare e gestire le risorse AWS) all'archivio. Per ulteriori informazioni, consulta Inserimento di tag nei repository AWS CodeCommit.

7. (Facoltativo) Espandi Configurazione aggiuntiva per specificare se utilizzare la chiave predefinita Chiave gestita da AWS o la chiave gestita dal cliente per crittografare e decrittografare i dati in questo repository. Se scegli di utilizzare la tua chiave gestita dal cliente, devi assicurarti che sia disponibile nel luogo in Regione AWS cui stai creando il repository e che la chiave sia attiva. Per ulteriori informazioni, consulta AWS Key Management Servicee crittografia per i AWS CodeCommit repository.

8. (Facoltativo) Seleziona Abilita Amazon CodeGuru Reviewer per Java e Python se questo repository conterrà codice Java o Python e desideri che Reviewer analizzi CodeGuru quel codice. CodeGuru Reviewer utilizza diversi modelli di machine learning per trovare i difetti del codice e suggerire automaticamente miglioramenti e correzioni nelle pull request. Per ulteriori informazioni, consulta la Amazon CodeGuru Reviewer User Guide.

9. Scegli Crea.

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

2. 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.

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 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 chiavi pubblica/privata 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 cui hai effettuato l'Regione AWSaccesso. Per creare un repository, consulta Creare un repository AWS CodeCommit oppure segui la procedura del tutorial Guida introduttiva a Git e CodeCommit.

4. (Facoltativo) Ti consigliamo di configurare il tuo client Git locale da utilizzare main come nome per il ramo predefinito del tuo repository. Questo è il nome usato per il ramo predefinito in tutti gli esempi di questa guida. È anche lo stesso nome di ramo predefinito CodeCommit utilizzato per il primo commit nella console. Esegui il seguente comando per configurare globalmente il nome del ramo predefinito per il tuo sistema:

   git config --global init.defaultBranch main

   Se preferisci utilizzare un nome di ramo predefinito diverso per tutti i tuoi repository, sostituiscilo main con il tuo nome preferito. Questo tutorial presuppone che il ramo predefinito sia denominato main.

   Se desideri utilizzare nomi di ramo predefiniti diversi per repository diversi, puoi impostare questo attributo localmente (--local) anziché globalmente (--global).

5. Al terminale o al prompt dei comandi, clonate il repository con il git clone comando e fornite l'URL del clone che avete copiato nel passaggio 3. L'URL clone dipende dal protocollo e dalla configurazione utilizzati. Ad esempio, se utilizzi HTTPS con credenziali Git per clonare un repository denominato MyDemoReponella regione Stati Uniti orientali (Ohio):

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

   Se stai usando HTTPS con git-remote-codecommit:

   git clone codecommit://MyDemoRepo my-demo-repo

   Se stai usando SSH:

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

   Nota

   Se viene visualizzato un errore durante il tentativo di clonare un repository, è possibile che non sia stata completata la configurazione necessaria per il computer locale. Per ulteriori informazioni, consulta Configurazione per AWS CodeCommit.

1. Utilizza un editor di testo per creare i seguenti due file di testo di esempio nella directory. Denomina i file cat.txt e dog.txt:

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. Esegui git config per aggiungere il nome utente e l'indirizzo email rappresentati dai segnaposto your-user-namee your-email-addressal tuo repository locale. Ciò rende più semplice identificare i commit eseguiti:

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. Se non hai impostato il nome del ramo predefinito a livello globale quando hai creato il repository locale, esegui il comando seguente per impostare il nome del ramo predefinito su: main

   git config --local init.defaultBranch main

4. Esegui git add per preparare la modifica:

   git add cat.txt dog.txt

5. Esegui git commit per eseguire il commit della modifica:

   git commit -m "Added cat.txt and dog.txt"

   Suggerimento

   Per visualizzare i dettagli sul commit, esegui git log.

1. Passa alla directory /tmp o alla directory c:\temp.

2. Esegui git clone per scaricare una copia del repository nel repository condiviso:

   Per HTTPS:

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

   Per HTTPS con git-remote-codecommit:

   git clone codecommit://MyDemoRepo shared-demo-repo

   Per SSH:

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

   Nota

   Quando crei un clone di un repository utilizzando SSH nei sistemi operativi Windows, potrebbe essere necessario aggiungere l'ID della chiave SSH alla stringa di connessione come segue:

   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Per ulteriori informazioni, consulta Per le connessioni SSH in Windows.

   In questo comando, MyDemoRepo c'è il nome del tuo repository. CodeCommit shared-demo-repoè il nome della directory che Git crea nella /tmp directory o nella c:\temp directory. Dopo che Git ha creato la directory, scarica una copia del repository nella directory shared-demo-repo.

3. Passa alla directory shared-demo-repo:

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. Esegui git config per aggiungere un altro nome utente e indirizzo email rappresentati da segnaposto other-user-namee. other-email-address Ciò rende più semplice identificare i commit eseguiti dell'altro utente:

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. Utilizza un editor di testo per creare i seguenti file di testo di esempio nella directory shared-demo-repo. Denomina il file horse.txt:

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. Esegui git add per preparare la modifica al repository condiviso:

   git add horse.txt

7. Esegui git commit per effettuare il commit della modifica nel repository condiviso:

   git commit -m "Added horse.txt"

8. Esegui git push per inviare il tuo commit iniziale tramite il nome remoto predefinito che Git usa per il tuo CodeCommit repository (origin), dal ramo predefinito nel tuo repository locale (main):

   git push -u origin main

9. Passa al repository locale ed esegui git pull per inserire nel repository locale il commit che il repository condiviso ha effettuato sul repository. CodeCommit Esegui quindi git log per vedere il commit avviato dal repository condiviso.

1. Dal repository locale, eseguigit checkout, specificando il nome del ramo (ad esempioMyNewBranch) e l'ID del primo commit che hai effettuato nel repository locale.

   Se non conosci l'ID commit, esegui git log per ottenerlo. Verifica che il commit abbia il tuo nome utente e il tuo indirizzo e-mail e non il nome utente e l'indirizzo e-mail dell'altro utente. Questo serve a simulare che main si tratti di una versione stabile del CodeCommit repository e che il MyNewBranch branch riguardi una nuova funzionalità relativamente instabile:

   git checkout -b MyNewBranch commit-ID

2. Esegui git push per inviare il nuovo ramo dal repository locale al repository: CodeCommit

   git push origin MyNewBranch

3. A questo punto, esegui il pull del ramo al repository condiviso e controlla i risultati:

   1. Passa alla directory del repository condiviso (shared-demo-repo).

   2. Esegui il pull nel nuovo ramo (git fetch origin).

   3. Verifica che il pull del ramo sia stato eseguito (git branch --all visualizza un elenco di tutti rami per il repository).

   4. Passa al nuovo ramo (git checkout MyNewBranch).

   5. Verifica l'avvenuto passaggio al ramo MyNewBranch eseguendo git status o git branch. L'output mostra il ramo corrente. In questo caso, deve essere MyNewBranch.

   6. Visualizza l'elenco dei commit nel ramo (git log).

   Di seguito è riportato l'elenco dei comandi Git da chiamare:

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. Passa di nuovo al ramo main e visualizzane l'elenco di commit. I comandi Git devono risultare simili a quanto segue:

   git checkout main
   git log

5. Passa alla main filiale del tuo repository locale. Puoi eseguire git status o git branch. L'output mostra il ramo corrente. In questo caso, deve essere main. I comandi Git devono risultare simili a quanto segue:

   git checkout main
   git branch or git status

1. Dal tuo repository locale, eseguigit tag, specificando il nome del nuovo tag (release) e l'ID del primo commit che hai effettuato nel repository locale.

   Se non conosci l'ID commit, esegui git log per ottenerlo. Verifica che il commit abbia il tuo nome utente e il tuo indirizzo e-mail e non il nome utente e l'indirizzo e-mail dell'altro utente. Questo serve a simulare che il tuo commit sia una versione stabile del repository: CodeCommit

   git tag release commit-ID

   Esegui di nuovo git tag per taggare il commit di un altro utente con il tag beta. Ciò è necessario per simulare che il commit è destinato a una nuova funzionalità relativamente instabile:

   git tag beta commit-ID

2. Esegui git push --tags per inviare i tag al repository. CodeCommit

3. A questo punto, esegui il pull dei tag nel repository condiviso e controlla i risultati:

   1. Passa alla directory del repository condiviso (shared-demo-repo).

   2. Esegui il pull dei nuovi tag (git fetch origin).

   3. Verifica che il pull dei tag è stato eseguito (git tag visualizza un elenco di tutti i tag per il repository).

   4. Visualizza le informazioni su ogni tag (git log release e git log beta).

   Di seguito è riportato l'elenco dei comandi Git da chiamare:

   git fetch origin
   git tag
   git log release
   git log beta

4. Provalo anche nel repository locale:

   git log release
   git log beta

1. Accedi a AWS Management Console e apri la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

   Assicurati di effettuare l'accesso con il nome utente e la password utilizzati in Configurazione .

2. Nel riquadro di navigazione, seleziona Users (Utenti), quindi scegli Create New Users (Crea nuovi utenti).

3. Nella prima casella Enter User Names (Immetti i nomi utente), immetti un nome utente di esempio (ad esempio, JaneDoe-CodeCommit). Seleziona la casella Generate an access key for each user (Genera una chiave di accesso per ogni utente), quindi scegli Create (Crea).

4. Sceglie Show User SMTP Credentials (Mostra credenziali di sicurezza utente). Annota l'ID chiave di accesso e la chiave di accesso segreta oppure scegli Download Credentials (Credenziali di download).

5. Segui le istruzioni Per utenti HTTPS che utilizzano credenziali Git per generare e fornire le credenziali dell'utente IAM.

   Se desideri utilizzare SSH, segui le istruzioni in SSH e Linux, macOS o Unix: configura le chiavi pubbliche e private per Git eCodeCommit o Fase 3: Impostare le chiavi pubbliche e private per Git e CodeCommit per configurare l'utente con le chiavi private e pubbliche.

6. Esegui git pull. Deve essere visualizzato l'errore seguente:

   Per HTTPS:

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Per SSH:

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   L'errore viene visualizzato perché il nuovo utente non dispone dell'autorizzazione per sincronizzare il repository condiviso con il repository. CodeCommit

7. Torna alla console IAM. Nel riquadro di navigazione, seleziona Policies (Policy) e Create Policy (Crea policy). (Se viene visualizzato il pulsante Get Started (Inizia), sceglierlo, quindi scegliere Create Policy (Crea policy)).

8. Accanto a Create Your Own Policy (Crea la tua policy) scegli Select (Seleziona).

9. Nella casella Policy Name (Nome policy), immetti un nome (ad esempio CodeCommitAccess-GettingStarted).

10. Nella casella Policy Document, inserisci quanto segue, che consente a un utente IAM di estrarre da qualsiasi repository associato all'utente IAM:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    Suggerimento

    Se desideri che l'utente IAM sia in grado di inviare i commit a qualsiasi repository associato all'utente IAM, inserisci invece questo:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    Per informazioni su altre autorizzazioni per CodeCommit azioni e risorse che puoi concedere agli utenti, consulta. Autenticazione e controllo degli accessi per AWS CodeCommit

11. Nel pannello di navigazione, seleziona Utenti.

12. Scegli il nome utente di esempio (ad esempio, JaneDoe-CodeCommit) a cui desideri collegare la policy.

13. Scegli la scheda Permissions (Autorizzazioni).

14. In Managed Policies (Policy gestite), scegli Attach Policy (Collega policy).

15. Seleziona la policy CodeCommitAccess-GettingStarted appena creata, quindi scegli Attach policy (Collega policy).

16. Esegui git pull. Questa volta il comando dovrebbe funzionare e dovrebbe essere visualizzato un messaggio Already up-to-date.

17. Se stai usando HTTPS, passa alle credenziali Git originali oppure se stai utilizzando git-remote-codecommit, al tuo profilo abituale. Per ulteriori informazioni, consulta le istruzioni in Configurazione per utenti HTTPS che utilizzano credenziali Git o Passaggi di configurazione per le connessioni HTTPS aAWS CodeCommitcongit-remote-codecommit.

    Se utilizzi SSH, passa alle chiavi originali. Per ulteriori informazioni, consulta SSH e Linux, macOS o Unix: configura le chiavi pubbliche e private per Git eCodeCommit o Fase 3: Impostare le chiavi pubbliche e private per Git e CodeCommit.

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

2. Nella pagina Dashboard (Pannello di controllo), nell'elenco di repository, scegli MyDemoRepo.

3. Nel pannello di navigazione scegli Settings (Impostazioni).

4. Nella pagina Settings (Impostazioni) in Delete repository (Elimina repository), scegliere Delete repository (Elimina repository).

5. Nella casella accanto a Type the name of the repository to confirm deletion (Digita il nome del repository per confermare l'eliminazione), immettere MyDemoRepo e quindi scegliere Delete (Elimina).