View a markdown version of this page

Guida introduttiva ai repository di CodeCatalyst origine e al blueprint dell' Single-page applicazione - Amazon CodeCatalyst
Creare un progetto con un blueprintVisualizzazione degli archivi per un progettoCreazione di un ambiente di sviluppoCreazione di una richiesta di pullUnione di una richiesta di pullVisualizzazione del codice distribuitoPulizia delle risorse

Amazon non CodeCatalyst è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Come migrare da CodeCatalyst.

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

Guida introduttiva ai repository di CodeCatalyst origine e al blueprint dell' Single-page applicazione

Segui i passaggi di questo tutorial per imparare a lavorare con i repository di origine in Amazon. CodeCatalyst

Il modo più rapido per iniziare a lavorare con i repository di origine in Amazon CodeCatalyst è creare un progetto utilizzando un modello. Quando crei un progetto utilizzando un modello, vengono create delle risorse per te, incluso un repository di sorgenti che include codice di esempio. Puoi usare questo repository e questo esempio di codice per imparare a:

  • Visualizza i repository dei sorgenti di un progetto e sfoglia i relativi contenuti

  • Crea un ambiente di sviluppo con un nuovo ramo in cui puoi lavorare sul codice

  • Cambia un file, esegui il commit e invia le modifiche

  • Crea una pull request e rivedi le modifiche al codice con gli altri membri del progetto

  • Visualizza il flusso di lavoro del tuo progetto, crea e testa automaticamente le modifiche nel ramo sorgente della pull request

  • Unisci le modifiche dal ramo di origine al ramo di destinazione e chiudi la pull request

  • Guarda le modifiche unite create e distribuite automaticamente

Per ottenere il massimo da questo tutorial, invita altre persone al tuo progetto in modo da poter lavorare insieme su una pull request. Puoi anche esplorare funzionalità aggiuntive in CodeCatalyst, ad esempio la creazione di problemi e l'associazione a una richiesta pull o la configurazione delle notifiche e la ricezione di avvisi quando viene eseguito il flusso di lavoro associato. Per un'esplorazione completa di, consulta. CodeCatalyst Tutorial introduttivi

Creare un progetto con un blueprint

La creazione di un progetto è il primo passo per poter lavorare insieme. Puoi utilizzare un blueprint per creare il tuo progetto, che creerà anche un repository di sorgenti con codice di esempio e un flusso di lavoro che genererà e distribuirà automaticamente il codice quando lo modifichi. In questo tutorial, ti guideremo attraverso un progetto creato con il blueprint dell'Single-page applicazione, ma puoi seguire le procedure per qualsiasi progetto con un repository di sorgenti. Assicurati di scegliere un ruolo IAM o di aggiungere un ruolo IAM se non ne hai uno come parte della creazione del progetto. Ti consigliamo di utilizzare il ruolo CodeCatalystWorkflowDevelopmentRole- spaceName di servizio per questo progetto.

Se hai già un progetto, puoi passare aVisualizzazione degli archivi per un progetto.

Nota

Solo gli utenti con il ruolo di amministratore di Space o Power user possono creare progetti in CodeCatalyst. Se non hai questo ruolo e hai bisogno di un progetto su cui lavorare per questo tutorial, chiedi a qualcuno con uno di questi ruoli di creare un progetto per te e aggiungerti al progetto creato. Per ulteriori informazioni, consulta Concessione dell'accesso con ruoli utente.

Per creare un progetto con un progetto

  1. Nella CodeCatalyst console, vai allo spazio in cui desideri creare un progetto.

  2. Nella dashboard dello spazio, scegli Crea progetto.

  3. Scegli Inizia con un progetto.

    Suggerimento

    Puoi scegliere di aggiungere un blueprint indicando ad Amazon Q i requisiti del tuo progetto in modo che Amazon Q ti suggerisca un blueprint. Per ulteriori informazioni, consulta Usare Amazon Q per scegliere un modello durante la creazione di un progetto o l'aggiunta di funzionalità e Le migliori pratiche per l'utilizzo di Amazon Q per creare progetti o aggiungere funzionalità con i blueprint. Questa funzionalità è disponibile solo nella regione Stati Uniti occidentali (Oregon).

    Questa funzionalità richiede che le funzionalità di intelligenza artificiale generativa siano abilitate per lo spazio. Per ulteriori informazioni, consulta Gestione delle funzionalità di intelligenza artificiale generativa.

  4. Dalla scheda CodeCatalyst Blueprint o Space blueprint, scegli un blueprint, quindi scegli Avanti.

  5. In Assegna un nome al tuo progetto, inserisci il nome che desideri assegnare al progetto e i nomi delle risorse associate. Il nome deve essere univoco all'interno del tuo spazio.

  6. (Facoltativo) Per impostazione predefinita, il codice sorgente creato dal blueprint viene archiviato in un CodeCatalyst repository. In alternativa, puoi scegliere di archiviare il codice sorgente del blueprint in un repository di terze parti. Per ulteriori informazioni, consulta Aggiungi funzionalità ai progetti con estensioni in CodeCatalyst.

    Importante

    CodeCatalyst non supporta il rilevamento delle modifiche nel ramo predefinito per i repository collegati. Per modificare il ramo predefinito per un repository collegato, devi prima scollegarlo CodeCatalyst, modificare il ramo predefinito e quindi collegarlo nuovamente. Per ulteriori informazioni, consulta Collegamento di GitHub repository, repository Bitbucket, repository di GitLab progetti e progetti Jira in CodeCatalyst.

    Come procedura consigliata, assicurati sempre di disporre della versione più recente dell'estensione prima di collegare un repository.

    Effettuate una delle seguenti operazioni a seconda del provider di repository di terze parti che desiderate utilizzare:

    • GitHub repository: collega un GitHub account.

      Scegli il menu a discesa Avanzato, scegli GitHub come fornitore del repository, quindi scegli l' GitHub account in cui desideri archiviare il codice sorgente creato dal blueprint.

      Nota

      Se stai connettendo un GitHub account, devi creare una connessione personale per stabilire una mappatura delle identità tra la tua identità e la tua CodeCatalyst identità. GitHub Per ulteriori informazioni, consulta Connessioni personali e Accesso alle GitHub risorse con connessioni personali.

    • Repository Bitbucket: connetti uno spazio di lavoro Bitbucket.

      Scegli il menu a discesa Avanzato, scegli Bitbucket come provider del repository, quindi scegli lo spazio di lavoro Bitbucket in cui desideri archiviare il codice sorgente creato dal blueprint.

    • GitLab repository: connetti un utente. GitLab

      Scegli il menu a discesa Avanzato, scegli GitLab come fornitore del repository, quindi scegli l' GitLab utente in cui desideri archiviare il codice sorgente creato dal blueprint.

  7. In Risorse del progetto, configura i parametri del blueprint. A seconda del blueprint, potresti avere la possibilità di assegnare un nome al repository di origine.

  8. (Facoltativo) Per visualizzare i file di definizione con aggiornamenti in base alle selezioni dei parametri di progetto effettuate, scegli Visualizza codice o Visualizza flusso di lavoro da Genera anteprima del progetto.

  9. (Facoltativo) Scegli Visualizza dettagli dalla scheda del blueprint per visualizzare dettagli specifici sul blueprint, come una panoramica dell'architettura del blueprint, le connessioni e le autorizzazioni richieste e il tipo di risorse create dal blueprint.

  10. Seleziona Crea progetto.

La pagina di panoramica del progetto si apre non appena crei un progetto o accetti un invito a un progetto e completi la procedura di accesso. La pagina di panoramica del progetto per un nuovo progetto non contiene problemi aperti o pull request. Facoltativamente, puoi scegliere di creare un problema e assegnarlo a te stesso. Puoi anche scegliere di invitare qualcun altro al tuo progetto. Per ulteriori informazioni, consulta Creazione di un problema in CodeCatalyst e Invitare un utente a un progetto.

Visualizzazione degli archivi per un progetto

Come membro di un progetto, puoi visualizzare gli archivi di origine del progetto. Puoi anche scegliere di creare repository aggiuntivi. Se qualcuno con il ruolo di amministratore di Space ha installato e configurato i GitHub repository, i repository Bitbucket o l'estensione dei GitLab repository, puoi anche aggiungere collegamenti a repository di terze parti negli GitHub account, negli spazi di lavoro Bitbucket o negli utenti configurati per l'estensione. GitLab Per ulteriori informazioni, consulta Creazione di un repository di sorgenti e Guida rapida: installazione di estensioni, connessione di provider e collegamento di risorse in CodeCatalyst.

Nota

Per i progetti creati con il blueprint dell' Single-page applicazione, il nome predefinito per il repository di origine che contiene il codice di esempio è. spa-app

Per accedere ai repository di origine di un progetto

  1. Accedi al tuo progetto ed esegui una delle seguenti operazioni:

    • Nella pagina di riepilogo del progetto, scegliete il repository desiderato dall'elenco, quindi scegliete Visualizza repository.

    • Nel riquadro di navigazione, scegli Codice, quindi scegli Repositori di origine. Nei repository di origine, scegli il nome del repository dall'elenco. È possibile filtrare l'elenco dei repository digitando parte del nome del repository nella barra dei filtri.

  2. Nella home page del repository, visualizza il contenuto del repository e le informazioni sulle risorse associate, ad esempio il numero di richieste pull e i flussi di lavoro. Per impostazione predefinita, vengono visualizzati i contenuti del ramo predefinito. È possibile modificare la visualizzazione scegliendo un ramo diverso dall'elenco a discesa.

La pagina di panoramica del repository include informazioni sui flussi di lavoro e sulle pull request configurati per i rami di questo repository e dei relativi file. Se hai appena creato il progetto, i flussi di lavoro iniziali per creare, testare e distribuire il codice saranno ancora in esecuzione, poiché il completamento richiede alcuni minuti. Puoi visualizzare i flussi di lavoro correlati e il loro stato scegliendo il numero sotto Flussi di lavoro correlati, ma questo apre la pagina Flussi di lavoro in. CI/CD Per questo tutorial, rimani nella pagina di panoramica ed esplora il codice nel repository. Il contenuto del README.md file viene visualizzato in questa pagina sotto i file del repository. In File, viene mostrato il contenuto del ramo predefinito. Puoi modificare la visualizzazione del file per mostrare il contenuto di un altro ramo, se ne hai uno. La .codecatalyst cartella contiene il codice utilizzato per altre parti del progetto, ad esempio i file YAML del flusso di lavoro.

Per visualizzare il contenuto delle cartelle, scegliete la freccia accanto al nome della cartella per espanderla. Ad esempio, scegliete la freccia accanto src a per visualizzare i file dell'applicazione Web a pagina singola contenuta in quella cartella. Per visualizzare il contenuto di un file, sceglierlo nell'elenco. Si aprirà Visualizza file, in cui è possibile sfogliare il contenuto di più file. Puoi modificare anche singoli file nella console, ma per modificare più file, ti consigliamo di creare un ambiente di sviluppo.

Creazione di un ambiente di sviluppo

Puoi aggiungere e modificare i file in un repository di origine nella console Amazon CodeCatalyst . Tuttavia, per lavorare efficacemente con più file e filiali, ti consigliamo di utilizzare un Dev Environment o di clonare il repository sul tuo computer locale. In questo tutorial, creeremo un AWS Cloud9 Dev Environment con un ramo denominato. develop Puoi scegliere un nome di ramo diverso, ma assegnando un nome al ramodevelop, verrà eseguito automaticamente un flusso di lavoro per creare e testare il codice quando crei una pull request più avanti in questo tutorial.

Suggerimento

Se decidi di clonare un repository localmente anziché o in aggiunta all'utilizzo di un Dev Environment, assicurati di avere Git sul tuo computer locale o che il tuo IDE includa Git. Per ulteriori informazioni, consulta Configurazione per l'utilizzo dei repository di origine.

Per creare un ambiente di sviluppo con un nuovo ramo

  1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

  2. Passa al progetto in cui desideri creare un ambiente di sviluppo.

  3. Scegli il nome del repository dall'elenco dei repository di origine per il progetto. In alternativa, nel pannello di navigazione, scegli Codice, scegli Repositori di origine e scegli il repository per il quale desideri creare un ambiente di sviluppo.

  4. Nella home page del repository, scegli Create Dev Environment.

  5. Scegli un IDE supportato dal menu a discesa. Per ulteriori informazioni, consulta Ambienti di sviluppo integrati supportati per ambienti di sviluppo.

  6. Scegli il repository da clonare, scegli Lavora in un nuovo ramo, inserisci il nome di un ramo nel campo Nome del ramo e scegli un ramo dal quale creare il nuovo ramo dal menu a discesa Crea ramo.

  7. Facoltativamente, aggiungi un alias per Dev Environment.

  8. Facoltativamente, scegli il pulsante di modifica della configurazione di Dev Environment per modificare la configurazione di calcolo, archiviazione o timeout dell'ambiente di sviluppo.

  9. Scegli Crea. Durante la creazione dell'ambiente di sviluppo, la colonna di stato dell'ambiente di sviluppo mostrerà Avvio e la colonna di stato verrà visualizzata in esecuzione una volta creato l'ambiente di sviluppo. Si aprirà una nuova scheda con il tuo Dev Environment nell'IDE di tua scelta. Puoi modificare il codice e confermare e inviare le modifiche.

Una volta creato l'ambiente di sviluppo, puoi modificare i file, eseguire il commit delle modifiche e inviarle al test ramo. Per questo tutorial, modifica il contenuto tra i <p> tag nel App.tsx file nella src cartella per cambiare il testo visualizzato sulla pagina web. Conferma e invia la modifica, quindi torna alla CodeCatalyst scheda.

Per effettuare e inviare una modifica da un AWS Cloud9 Ambiente di sviluppo

  1. In AWS Cloud9, espandi il menu di navigazione laterale per sfogliare i file. srcEspandi e apriApp.tsx.

  2. Apporta una modifica al testo all'interno dei <p> tag.

  3. Salva il file, quindi esegui il commit e invia le modifiche utilizzando il menu Git. In alternativa, nella finestra del terminale, esegui il commit e invia le modifiche con i git push comandi git commit and.

    git commit -am "Making an example change"
git push
    Suggerimento

    Potrebbe essere necessario cambiare le directory nel terminale inserendole nella directory del repository Git prima di poter eseguire correttamente i comandi Git.

Creazione di una richiesta di pull

Puoi utilizzare le richieste pull per esaminare le modifiche al codice in modo collaborativo per apportare modifiche o correzioni minori, aggiungere funzionalità importanti o nuove versioni del software rilasciato. In questo tutorial, creerai una pull request per esaminare le modifiche apportate al test ramo rispetto al ramo principale. La creazione di una pull request in un progetto creato con un modello avvierà anche l'esecuzione degli eventuali flussi di lavoro associati.

Come creare una richiesta pull

  1. Passa al tuo progetto.

  2. Esegui una delle seguenti operazioni:

    • Nel pannello di navigazione, scegli Codice, scegli Richieste pull, quindi scegli Crea richiesta pull.

    • Nella home page del repository, scegli Altro, quindi scegli Crea richiesta pull.

    • Nella pagina del progetto, scegli Crea pull request.

  3. Nel repository dei sorgenti, assicurati che il repository sorgente specificato sia quello che contiene il codice salvato. Questa opzione appare solo se non hai creato la pull request dalla pagina principale del repository.

  4. Nel ramo di destinazione, scegli il ramo in cui unire il codice dopo averlo esaminato.

  5. Nel ramo Source, scegli il ramo che contiene il codice salvato.

  6. Nel Titolo della richiesta Pull, inserisci un titolo che aiuti gli altri utenti a capire cosa deve essere esaminato e perché.

  7. (Facoltativo) Nella descrizione della richiesta Pull, fornisci informazioni come un link ai problemi o una descrizione delle modifiche.

    Suggerimento

    Puoi scegliere Scrivi descrizione per farmi generare CodeCatalyst automaticamente una descrizione delle modifiche contenute nella pull request. Puoi apportare modifiche alla descrizione generata automaticamente dopo averla aggiunta alla pull request.

    Questa funzionalità richiede che le funzionalità di intelligenza artificiale generativa siano abilitate per lo spazio e non è disponibile per le richieste pull nei repository collegati. Per ulteriori informazioni, consulta Gestione delle funzionalità di intelligenza artificiale generativa.

  8. (Facoltativo) In Problemi, scegli Collega problemi, quindi scegli un problema dall'elenco o inserisci il relativo ID. Per scollegare un problema, scegli l'icona di scollegamento.

  9. (Facoltativo) In Revisori obbligatori, scegli Aggiungi revisori obbligatori. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori obbligatori devono approvare le modifiche prima che la pull request possa essere unita al ramo di destinazione.

    Nota

    Non è possibile aggiungere un revisore sia come revisore obbligatorio che come revisore opzionale. Non puoi aggiungerti come revisore.

  10. (Facoltativo) In Revisori opzionali, scegli Aggiungi revisori opzionali. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori opzionali non devono approvare le modifiche come requisito prima che la pull request possa essere unita al ramo di destinazione.

  11. Esamina le differenze tra le filiali. La differenza mostrata in una richiesta pull sono le modifiche tra la revisione nel ramo di origine e la merge base, che è il commit principale del ramo di destinazione al momento della creazione della richiesta pull. Se non viene visualizzata alcuna modifica, i rami potrebbero essere identici oppure potresti aver scelto lo stesso ramo sia per l'origine che per la destinazione.

  12. Quando sei soddisfatto che la pull request contenga il codice e le modifiche che desideri esaminare, scegli Crea.

    Nota

    Dopo aver creato la pull request, puoi aggiungere commenti. I commenti possono essere aggiunti alla pull request o a singole righe dei file, nonché alla pull request complessiva. Puoi aggiungere collegamenti a risorse, ad esempio file, utilizzando il segno @ seguito dal nome del file.

È possibile visualizzare le informazioni sui flussi di lavoro associati avviati dalla creazione di questa pull request scegliendo Panoramica e quindi esaminando le informazioni nell'area dei dettagli della richiesta di pull in Esecuzioni del flusso di lavoro. Per visualizzare l'esecuzione del flusso di lavoro, scegli l'esecuzione.

Suggerimento

Se hai assegnato al ramo un nome diverso dadevelop, non verrà eseguito automaticamente un flusso di lavoro per creare e testare le modifiche. Se desideri configurarlo, modifica il file YAML per il flusso di lavoro in PullRequestBuildAndTest corso. Per ulteriori informazioni, consulta Creazione di un flusso di lavoro.

Puoi commentare questa pull request e chiedere agli altri membri del progetto di commentarla. Puoi anche scegliere di aggiungere o modificare revisori facoltativi o obbligatori. Puoi scegliere di apportare ulteriori modifiche al ramo di origine del repository e vedere come tali modifiche confermate creano revisioni per la pull request. Per ulteriori informazioni, vedereRevisione di una richiesta di pull, Aggiornamento di una richiesta di pullRevisione del codice con richieste pull in Amazon CodeCatalyst, e. Visualizzazione dello stato e dei dettagli dell'esecuzione del flusso di lavoro

Unione di una richiesta di pull

Una volta che una pull request è stata esaminata e ha ricevuto le approvazioni dai revisori richiesti, puoi unire il ramo di origine a quello di destinazione nella console. CodeCatalyst L'unione di una richiesta pull avvierà anche una serie di modifiche attraverso tutti i flussi di lavoro associati al ramo di destinazione. In questo tutorial, unirai il ramo di test a quello principale, il che avvierà l'esecuzione del flusso di lavoro attivo. PushToMainDeployPipeline

Per unire una pull request (console)

  1. Nelle richieste pull, scegli la pull request che hai creato nel passaggio precedente. Nella pull request, scegli Unisci.

  2. Scegli tra le strategie di unione disponibili per la pull request. Facoltativamente, seleziona o deseleziona l'opzione per eliminare il ramo di origine dopo aver unito la pull request, quindi scegli Unisci. Una volta completata l'unione, lo stato della pull request cambia in Unita e non appare più nella visualizzazione predefinita delle pull request. La visualizzazione predefinita mostra le richieste pull con lo stato Aperto. Puoi ancora visualizzare una richiesta pull unita, ma non puoi approvarla o modificarne lo stato.

    Nota

    Se il pulsante Unisci non è attivo o vedi l'etichetta Non unificabile, un revisore richiesto non ha ancora approvato la pull request oppure la pull request non può essere unita nella console. CodeCatalyst Un revisore che non ha approvato una pull request è indicato da un'icona a forma di orologio in Panoramica nell'area dei dettagli della richiesta di pull. Se tutti i revisori obbligatori hanno approvato la pull request ma il pulsante Unisci non è ancora attivo, è possibile che si sia verificato un conflitto di unione o che sia stata superata la quota di archiviazione per lo spazio. Puoi risolvere i conflitti di unione per il ramo di destinazione in un ambiente di sviluppo, inviare le modifiche e quindi unire la pull request, oppure puoi risolvere i conflitti e unirti localmente, quindi inviare il commit contenente l'unione a. CodeCatalyst Per ulteriori informazioni, consulta Unire una pull request (Git) la documentazione di Git.

Visualizzazione del codice distribuito

Ora è il momento di visualizzare il codice originariamente distribuito che si trovava nel ramo predefinito e le modifiche unite una volta che sono state create, testate e distribuite automaticamente. Per farlo, puoi tornare alla pagina di panoramica del repository e scegliere il numero accanto all'icona dei flussi di lavoro correlati oppure, nel riquadro di navigazione, scegli, quindi scegli CI/CD Flussi di lavoro.

Per visualizzare il codice distribuito

  1. In Flussi di lavoro, inonPushToMainDeployPipeline, espandi Esecuzioni recenti.

    Nota

    Questo è il nome predefinito del flusso di lavoro per i progetti creati con il blueprint dell'Single-page applicazione.

  2. L'esecuzione più recente è quella avviata dalla richiesta pull unita inviata alla main filiale e probabilmente mostrerà lo stato In corso. Scegli una corsa completata con successo dall'elenco per aprirne i dettagli.

  3. Scegli Variabili. Copia il valore per AppUrl. Questo è l'URL dell'applicazione Web a pagina singola distribuita. Apri una nuova scheda del browser e incolla il valore per visualizzare il codice creato e distribuito. Lascia aperta la scheda.

  4. Torna all'elenco delle esecuzioni del flusso di lavoro e attendi il completamento dell'esecuzione più recente. In tal caso, torna alla scheda che hai aperto per visualizzare l'applicazione web e aggiornare il browser. Dovresti vedere le modifiche che hai apportato nella tua pull request unita.

Pulizia delle risorse

Dopo aver esplorato l'utilizzo di un repository di sorgenti e di una pull request, potresti voler rimuovere tutte le risorse che non ti servono. Non puoi eliminare le pull request, ma puoi chiuderle. Puoi eliminare tutti i rami che hai creato.

Se non hai più bisogno del repository di origine o del progetto, puoi anche eliminare tali risorse. Per ulteriori informazioni, consulta Eliminazione di un repository di origine e Eliminazione di un progetto.