View a markdown version of this page

Esegui la migrazione di contenuti locali o senza versione su AWS CodeCommit - AWS CodeCommit

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

Esegui la migrazione di contenuti locali o senza versione su AWS CodeCommit

Le procedure descritte in questo argomento mostrano come migrare un progetto o un contenuto locale esistente sul computer in un repository. CodeCommit Per eseguire il processo:

  • Completa la configurazione iniziale richiesta per. CodeCommit

  • Crea un CodeCommit repository.

  • Metti una cartella locale sotto il controllo della versione di Git e invia il contenuto di quella cartella al CodeCommit repository.

  • Visualizza i file nel CodeCommit repository.

  • Condividi il CodeCommit repository con il tuo team.

Migrazione di un progetto locale verso CodeCommit

Fase 0: Configurazione richiesta per accedere a CodeCommit

Prima di poter migrare i contenuti locali verso CodeCommit, è necessario creare e configurare un utente IAM CodeCommit e configurare il computer locale per l'accesso. È inoltre necessario installare AWS CLI per gestire CodeCommit. Sebbene sia possibile eseguire la maggior parte delle CodeCommit attività senza di essa, AWS CLI offre flessibilità quando si lavora con Git.

Se sei già configurato per CodeCommit, puoi passare aPassaggio 1: creare un repository CodeCommit.

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:

    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.

Quindi, installare Git.

  • Per Linux, macOS o Unix:

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

    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.

  • Per Windows:

    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:

    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.

CodeCommit supporta l'autenticazione HTTPS e SSH. Per completare la configurazione, è necessario configurare le credenziali Git per CodeCommit (HTTPS, consigliato per la maggior parte degli utenti), una coppia di chiavi SSH (SSH) da utilizzare per l'accesso CodeCommit git-remote-codecommit (consigliato per gli utenti che utilizzano l'accesso federato) o l'helper per le credenziali incluso nel. AWS CLI

Passaggio 1: creare un repository CodeCommit

In questa sezione, usi la CodeCommit console per creare il CodeCommit repository che usi per il resto di questo tutorial. Per usare il AWS CLI per creare il repository, vedi. Crea un repository (AWS CLI)

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

  2. Nel selettore di regione, scegli 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) immettere un nome per il repository in Repository name (Nome repository).

    Nota

    I nomi dei repository distinguono tra maiuscole e minuscole. Il nome deve essere univoco nel nome del Regione AWS tuo account Amazon Web Services.

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

    Nota

    Il campo della descrizione visualizza Markdown nella console e accetta tutti i caratteri HTML e i caratteri Unicode validi. Se sei uno sviluppatore di applicazioni che utilizza le BatchGetRepositories API GetRepository o e intendi visualizzare il campo di descrizione del repository in un browser web, consulta l'API Reference. CodeCommit

  6. (Facoltativo) Scegli Aggiungi tag per aggiungere uno o più tag del repository (un'etichetta di attributo personalizzata che ti aiuta a organizzare e gestire AWS le tue risorse) al tuo repository. Per ulteriori informazioni, consulta Etichettatura dei repository in AWS CodeCommit.

  7. (Facoltativo) Espandi la configurazione aggiuntiva per specificare se utilizzare la chiave predefinita Chiave gestita da AWS o 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 Service e crittografia per i AWS CodeCommit repository.

  8. (Facoltativo) Seleziona Abilita Amazon CodeGuru Reviewer for Java and Python se questo repository contiene codice Java o Python e desideri che CodeGuru Reviewer lo analizzi. CodeGuru Reviewer utilizza diversi modelli di machine learning per individuare difetti nel codice e suggerire miglioramenti e correzioni nelle richieste pull. Per ulteriori informazioni, consulta la Amazon CodeGuru Reviewer User Guide.

  9. Scegli Crea.

Una volta creato, il repository viene visualizzato nell'elenco in Repositories (Repository). Nella colonna URL scegliere l'icona di copia, quindi scegliere il protocollo (HTTPS o SSH) da utilizzare per connettersi ad CodeCommit. Copia l’URL.

Ad esempio, se hai dato un nome al tuo repository MyFirstRepo e utilizzi HTTPS, l'URL sarà simile al seguente:

https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo

L'URL sarà necessario in seguito in Fase 2: migrazione dei contenuti locali nel repository CodeCommit.

Fase 2: migrazione dei contenuti locali nel repository CodeCommit

Ora che hai un CodeCommit repository, puoi scegliere una directory sul tuo computer locale da convertire in un repository Git locale. Il comando git init può essere utilizzato per convertire il contenuto senza versione esistente in un repository Git o, se ancora non sono disponibili file o contenuto, per inizializzare un nuovo repository vuoto.

  1. Dal terminale o dalla riga di comando sul computer locale passare alla directory da usare come origine per il repository.

  2. Esegui il comando seguente per configurare Git in modo che utilizzi un ramo predefinito denominato: main

    git config --local init.defaultBranch main

    Puoi anche eseguire questo comando per impostare il nome del ramo predefinito main per tutti i repository appena creati:

    git config --global init.defaultBranch main
  3. Eseguire il comando git init per inizializzare il controllo di versione Git nella directory. In questo modo si crea una sottodirectory .git nella radice della directory che consente il monitoraggio del controllo di versione. La cartella .git contiene anche tutti i metadati necessari per il repository.

    git init
  4. Verificate lo stato della directory inizializzata eseguendo il comando seguente:

    git status

    Aggiungere i file desiderati al controllo di versione. In questo tutorial eseguiremo il comando git add con l'identificatore . per aggiungere tutti i file in questa directory. Per altre opzioni, consulta la documentazione di Git.

    git add .
  5. Creare un commit per i file aggiunti con un messaggio di commit.

    git commit -m "Initial commit"
  6. Esegui il git push comando, specificando l'URL e il nome del CodeCommit repository di destinazione e l'opzione. --all (Si tratta dell'URL copiato in Passaggio 1: creare un repository CodeCommit).

    Ad esempio, se hai dato un nome al tuo repository MyFirstRepo e sei impostato per utilizzare HTTPS, esegui il seguente comando:

    git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo --all

Passo 3: Visualizza i file in CodeCommit

Dopo aver inserito il contenuto della directory, puoi utilizzare la CodeCommit console per visualizzare rapidamente tutti i file nel repository.

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

  2. In Repositories, scegli il nome del repository (ad esempio,MyFirstRepository) dall'elenco.

  3. Visualizzare i file nel repository per i rami, gli URL clone, le impostazioni e altro ancora.

Passaggio 4: condividere il repository CodeCommit

Quando si crea un repository in CodeCommit, vengono generati due endpoint: uno per le connessioni HTTPS e uno per le connessioni SSH. Entrambi offrono connessioni protette in rete. Gli utenti possono scegliere quale dei due protocolli utilizzare. Gli endpoint rimangono entrambi attivi, indipendentemente dal protocollo consigliato per i propri utenti. Prima di poter condividere il tuo repository con altri, devi creare policy IAM che consentano ad altri utenti di accedere al tuo repository. Fornire queste istruzioni di accesso ai propri utenti.

Creazione di una policy gestita dal cliente per il repository
  1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. https://console.aws.amazon.com/iam/

  2. Nell'area di navigazione Dashboard (Pannello di controllo) scegliere Policies (Policy) e quindi Crea Policy (Crea policy).

  3. Nella pagina Crea policy, scegli Importa policy gestita.

  4. Nella pagina Importa politiche gestite, in Filtra politiche, inserisciAWSCodeCommitPowerUser. Scegli il pulsante accanto al nome della policy, quindi scegli Importa.

  5. Nella pagina Create policy (Crea policy), scegli JSON. Sostituisci la parte «*» della Resource riga relativa CodeCommit alle azioni con l'Amazon Resource Name (ARN) del CodeCommit repository, come mostrato qui:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" ]
    Suggerimento

    Per trovare l'ARN del CodeCommit repository, vai alla CodeCommit console, scegli il nome del repository dall'elenco, quindi scegli Impostazioni. Per ulteriori informazioni, consulta Visualizza i dettagli del repository.

    Per fare in modo che questa policy venga applicata a più repository, aggiungere ogni repository come una risorsa, specificandone l'ARN. Includere una virgola tra ciascuna dichiarazione di risorsa, come nell'esempio seguente:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" ]

    Quando hai finito di modificare, scegli Politica di revisione.

  6. Nella pagina Revisione politica, in Nome, inserisci un nuovo nome per la politica (ad esempio,AWSCodeCommitPowerUser-MyDemoRepo). Facoltativamente, fornisci una descrizione per questa politica.

  7. Scegli Crea policy.

Per gestire l'accesso al tuo repository, crea un gruppo IAM per i suoi utenti, aggiungi utenti IAM a quel gruppo e quindi allega la policy gestita dal cliente che hai creato nel passaggio precedente. Collegare qualsiasi altra policy necessaria per l'accesso, ad esempio IAMSelfManageServiceSpecificCredentials o IAMUserSSHKeys.

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

  2. Nell'area di navigazione Dashboard (Pannello di controllo), scegliere Groups (Gruppi) e quindi Create New Group (Crea nuovo gruppo).

  3. Nella pagina Imposta nome gruppo, in Nome gruppo, inserisci un nome per il gruppo (ad esempioMyDemoRepoGroup), quindi scegli Passaggio successivo. Valutare la possibilità di includere il nome del repository nel nome del gruppo.

    Nota

    Questo nome deve essere univoco in un account Amazon Web Services.

  4. Seleziona la casella accanto alla policy gestita dal cliente che hai creato nella sezione precedente (ad esempio, AWSCodeCommitPowerUser-MyDemoRepo).

  5. Nella pagina Review (Verifica), scegliere Create Group (Crea gruppo). IAM crea questo gruppo con le politiche specificate già allegate. Il gruppo viene visualizzato nell'elenco dei gruppi associati al tuo account Amazon Web Services.

  6. Selezionare il gruppo dall'elenco.

  7. Nella pagina di riepilogo del gruppo, scegliere la scheda Users (Utenti) e quindi scegliere Add Users to Group (Aggiungi utenti al gruppo). Nell'elenco che mostra tutti gli utenti associati al tuo account Amazon Web Services, seleziona le caselle accanto agli utenti a cui desideri consentire l'accesso al CodeCommit repository, quindi scegli Aggiungi utenti.

    Suggerimento

    È possibile utilizzare la casella di ricerca per trovare rapidamente gli utenti per nome.

  8. Dopo aver aggiunto gli utenti, chiudi la console IAM.

Dopo aver creato un utente IAM da utilizzare per accedere CodeCommit utilizzando il gruppo di policy e le policy configurate, invia a quell'utente le informazioni necessarie per connettersi al repository.

  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. Nella pagina Repositories (Repository) scegliere il repository che si desidera eliminare.

  4. In Clone URL (URL clone), scegliere il protocollo che deve essere utilizzato dagli utenti. L'URL clone viene copiato per il protocollo di connessione scelto.

  5. Invia ai tuoi utenti l'URL del clone insieme a qualsiasi altra istruzione, come installare AWS CLI, configurare un profilo o installare Git. Assicurarsi di includere le informazioni di configurazione per il protocollo di connessione (ad esempio HTTPS).