Creare un progetto

Con CodeCatalyst i progetti, puoi svolgere attività di sviluppo con flussi di lavoro e repository condivisi con continuous integration/continuous delivery (CI/CD), gestire le risorse, tenere traccia dei problemi e aggiungere utenti.

Prima di creare un progetto, devi avere il ruolo di amministratore di Space o Power user.

Creare un progetto vuoto in Amazon CodeCatalyst

Puoi creare un progetto vuoto senza risorse e aggiungere manualmente le risorse desiderate in un secondo momento.

Prima di creare un progetto, devi avere il ruolo di amministratore di Space o Power user.

Per creare un progetto vuoto

1. Vai allo spazio in cui desideri creare un progetto.

2. Nella dashboard dello spazio, scegli Crea progetto.

3. Scegli Inizia da zero.

4. In Assegna un nome al tuo progetto, inserisci il nome che desideri assegnare al tuo progetto. Il nome deve essere univoco all'interno del tuo spazio.

5. Seleziona Crea progetto.

Creazione di un progetto con un repository di terze parti collegato

Puoi conservare il codice sorgente del tuo progetto in un fornitore terzo preferito e continuare a utilizzare tutte le CodeCatalyst funzionalità come progetti, gestione del ciclo di vita, flussi di lavoro e altro ancora. Per fare ciò, puoi creare un nuovo CodeCatalyst progetto che si collega a un repository, a un GitHub repository Bitbucket o a un repository di progetto. GitLab Puoi quindi utilizzare il tuo repository sorgente collegato nel tuo progetto. CodeCatalyst

Prima di creare un CodeCatalyst progetto, devi avere il ruolo di amministratore di Space o Power user. Per ulteriori informazioni, consulta Creazione di uno spazio e Invitare un utente direttamente in uno spazio.

Per creare un progetto con collegamenti a un repository di origine nel tuo GitHub account, devi completare le tre attività seguenti: CodeCatalyst

1. Installa i GitHub repository, i repository Bitbucket o l'estensione dei repository. GitLab In un sito esterno ti viene richiesto di connetterti e fornire CodeCatalyst l'accesso al tuo repository, operazione che viene eseguita come parte del passaggio successivo.

   Importante

   Per installare i GitHub repository, i repository Bitbucket o l'estensione dei GitLab repository nel tuo CodeCatalyst spazio, devi accedere con un account con il ruolo di amministratore dello spazio.

2. Collega il tuo GitHub account, lo spazio di lavoro o l'utente di Bitbucket a. GitLab CodeCatalyst

   Importante

   Per connettere il tuo GitHub account, GitLab l'utente dello spazio di lavoro Bitbucket, al tuo CodeCatalyst spazio, devi essere sia l'amministratore della fonte di terze parti che l'amministratore dello spazio. CodeCatalyst

   Importante

   Dopo aver installato un'estensione del repository, tutti i repository a cui ti colleghi CodeCatalyst avranno il loro codice indicizzato e archiviato. CodeCatalyst Ciò renderà il codice ricercabile in. CodeCatalyst Per comprendere meglio la protezione dei dati del codice quando si utilizzano repository collegati in CodeCatalyst, consulta la sezione Protezione dei dati nella Amazon CodeCatalyst User Guide.

3. Crea un CodeCatalyst progetto collegato al tuo GitHub repository, al repository Bitbucket o al repository di progetto. GitLab

   Importante

   Sebbene tu possa collegare un GitHub repository, un repository Bitbucket o un repository di GitLab progetto come Collaboratore, puoi scollegare un repository di terze parti solo come amministratore dello spazio o amministratore del progetto. Per ulteriori informazioni, consulta Scollegamento di repository, GitHub repository Bitbucket, repository di progetti e GitLab progetti Jira 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.

   Nota

   • Un GitHub repository, un repository Bitbucket o un repository di GitLab progetto possono essere collegati a un solo progetto in uno spazio. CodeCatalyst

   • Non puoi usare repository vuoti o archiviati, repository Bitbucket o GitHub repository di progetto con i progetti. GitLab CodeCatalyst

   • Non puoi collegare un GitHub repository, un repository Bitbucket o un repository di progetto con lo stesso nome di un repository in un GitLab progetto. CodeCatalyst

   • L'estensione dei GitHub repositories non è compatibile con i repository di Enterprise Server. GitHub

   • L'estensione dei repository Bitbucket non è compatibile con i repository Bitbucket Data Center.

   • L'estensione dei repositories non è compatibile con GitLab i repository di progetto autogestiti. GitLab

   • Non puoi utilizzare le funzionalità Scrivi descrizione per me o Riepiloga commenti con i repository collegati. Queste funzionalità sono disponibili solo nelle richieste pull in. CodeCatalyst

Per ulteriori informazioni, consulta Aggiungi funzionalità ai progetti con estensioni in CodeCatalyst.

Per installare l'estensione di terze parti

1. Vai allo spazio in cui desideri creare un progetto.

2. Nella dashboard dello spazio, scegli Crea progetto.

3. Scegli Porta il tuo codice.

4. In Collega un repository esistente, scegli GitHub repository, repository Bitbucket, repository a seconda del provider di GitLab repository di terze parti che desideri utilizzare. Ti viene richiesto di connettere il tuo GitHub account, lo spazio di lavoro Bitbucket o l'account se non l'hai fatto in precedenza. GitLab Se l'estensione di terze parti di tua scelta non è già installata, viene visualizzata una richiesta di installazione.

5. Se richiesto, scegli Installa. Controlla le autorizzazioni richieste dall'estensione e, se desideri continuare, scegli nuovamente Installa.

Dopo aver installato l'estensione di terze parti, il passaggio successivo consiste nel connettere il tuo GitHub account, l'area di lavoro Bitbucket o GitLab l'utente al tuo spazio. CodeCatalyst

Per connettere il tuo GitHub account, l'area di lavoro Bitbucket o l'utente a GitLab CodeCatalyst

Effettua una delle seguenti operazioni a seconda dell'estensione di terze parti che hai scelto di configurare:

• GitHub repository: connettiti a un GitHub account.

  1. Scegli Connect GitHub account per accedere al sito esterno per GitHub.

  2. Accedi al tuo GitHub account utilizzando GitHub le tue credenziali, quindi scegli l'account in cui desideri installare Amazon CodeCatalyst.

     Suggerimento

     Se hai già collegato un GitHub account allo spazio, non ti verrà richiesto di effettuare una nuova autorizzazione. Vedrai invece una finestra di dialogo che ti chiede dove desideri installare l'estensione se sei un membro o un collaboratore in più di uno GitHub spazio o la pagina di configurazione dell' CodeCatalyst applicazione Amazon se appartieni a un solo spazio. GitHub Configura l'applicazione per l'accesso al repository che desideri consentire, quindi scegli Salva. Se il pulsante Salva non è attivo, apporta una modifica alla configurazione e riprova.

  3. Scegli se consentire l'accesso CodeCatalyst a tutti i repository attuali e futuri o scegli i GitHub repository specifici in cui desideri utilizzare. CodeCatalyst L'opzione predefinita è includere tutti i GitHub repository nell' GitHub account, inclusi i repository futuri a cui accederanno. CodeCatalyst

  4. Controlla le autorizzazioni concesse a CodeCatalyst, quindi scegli Installa.

  Dopo aver collegato il tuo GitHub account a CodeCatalyst, verrai indirizzato alla pagina dei dettagli dell'estensione dei GitHub repository, in cui puoi visualizzare e gestire GitHub gli account connessi e i repository collegati GitHub .

• Repository Bitbucket: connettiti a uno spazio di lavoro Bitbucket.

  1. Scegli Connect Bitbucket workspace per accedere al sito esterno di Bitbucket.

  2. Accedi al tuo spazio di lavoro Bitbucket utilizzando le tue credenziali Bitbucket e rivedi le autorizzazioni concesse a. CodeCatalyst

  3. Dal menu a discesa Autorizza per lo spazio di lavoro, scegli lo spazio di lavoro Bitbucket a cui vuoi fornire l'accesso, quindi scegli Concedi l'accesso. CodeCatalyst

     Suggerimento

     Se in precedenza hai collegato uno spazio di lavoro Bitbucket allo spazio, non ti verrà richiesto di effettuare una nuova autorizzazione. Vedrai invece una finestra di dialogo che ti chiede dove desideri installare l'estensione se sei un membro o un collaboratore in più di uno spazio di lavoro Bitbucket, o la pagina di configurazione per l'applicazione Amazon CodeCatalyst se appartieni a un solo spazio di lavoro Bitbucket. Configura l'applicazione per l'accesso allo spazio di lavoro che desideri consentire, quindi scegli Concedi l'accesso. Se il pulsante Concedi l'accesso non è attivo, apporta una modifica alla configurazione e riprova.

  Dopo aver collegato il tuo spazio di lavoro Bitbucket a CodeCatalyst, verrai indirizzato alla pagina dei dettagli dell'estensione dei repository Bitbucket, dove puoi visualizzare e gestire gli spazi di lavoro Bitbucket connessi e i repository Bitbucket collegati.

• GitLab repository: connettiti a un utente. GitLab

  1. Scegli Connetti GitLab utente per cui accedere al sito esterno. GitLab

  2. Accedi al tuo GitLab utente utilizzando le tue GitLab credenziali e rivedi le autorizzazioni concesse a. CodeCatalyst

     Suggerimento

     Se in precedenza hai connesso un GitLab utente allo spazio, non ti verrà richiesto di effettuare una nuova autorizzazione. Verrai invece reindirizzato alla console. CodeCatalyst

  3. Scegli Authorize AWS Connector per. GitLab

  Dopo aver collegato GitLab l'utente a CodeCatalyst, verrai indirizzato alla pagina dei dettagli dell'estensione dei GitLab repository, in cui puoi visualizzare e gestire i repository GitLab degli utenti connessi e dei GitLab progetti collegati.

Dopo aver collegato la fonte di terze parti a CodeCatalyst, puoi collegare i repository di terze parti ai tuoi progetti. CodeCatalyst

Creazione del tuo progetto

1. Nella pagina Crea progetto, scegli l' GitHub account che hai collegato.

2. A seconda del provider di repository di terze parti che hai collegato, scegli il menu a discesa dei GitHub repository, dei repository di Bitbucket o dei GitLab repository di terze parti per visualizzare i repository di terze parti, quindi scegli il repository che desideri collegare al tuo progetto.

3. Nel campo di immissione di testo Assegna un nome al tuo progetto, inserisci il nome che desideri assegnare al tuo progetto. Il nome deve essere univoco all'interno del tuo spazio.

4. Seleziona Crea progetto.

Dopo aver installato i GitHub repository, i repository Bitbucket o l'estensione dei GitLab repository, aver collegato il fornitore di risorse e collegato il repository di terze parti al CodeCatalyst progetto, puoi utilizzarlo nei flussi di lavoro e negli ambienti di sviluppo. CodeCatalyst Puoi anche creare repository di terze parti nell' GitHub account connesso, nell'area di lavoro di Bitbucket o nell'utente con codice generato da un blueprint. GitLab Puoi anche utilizzare i repository collegati con Amazon Q Developer, blueprint e altro ancora. Per ulteriori informazioni, consulta Avvio automatico di un flusso di lavoro dopo eventi di repository di terze parti e Creazione di un ambiente di sviluppo.

Creazione di un progetto con un blueprint

Puoi fornire a tutte le risorse del progetto e al codice di esempio un blueprint di progetto. Per informazioni sui progetti, vedere. Creazione di un progetto completo con CodeCatalyst blueprint

Per creare un progetto con un blueprint

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.

Le migliori pratiche per l'utilizzo di Amazon Q per creare progetti o aggiungere funzionalità con i blueprint

Quando crei un progetto o desideri aggiungere nuovi componenti a un progetto esistente, potresti non essere sicuro del modello da utilizzare o di come integrare le funzionalità. CodeCatalyst include l'integrazione con un assistente di intelligenza artificiale generativo chiamato Amazon Q in grado di analizzare i requisiti del progetto e suggerire un modello che meglio si adatta alle tue esigenze.

Puoi usare Amazon Q per aiutarti a creare un progetto con un blueprint che crea componenti in base ai tuoi requisiti, oppure puoi usare Amazon Q per aiutarti ad aggiungere un blueprint a un progetto esistente. Ad esempio, per aggiungere risorse per un'applicazione web o un'applicazione moderna a un progetto, specifica i requisiti e le risorse verranno aggiunte con un progetto consigliato. I problemi relativi ai componenti rimanenti possono essere creati automaticamente.

Amazon Q crea anche problemi relativi ai requisiti che non possono essere risolti con un modello suggerito. Inoltre, puoi assegnare questi problemi ad Amazon Q. Se assegni il problema ad Amazon Q, tenterà di creare una bozza di soluzione da valutare. Questo può aiutare te e il tuo team a concentrarti e ottimizzare il lavoro sui problemi che richiedono la tua attenzione, mentre Amazon Q lavora a una soluzione per problemi che non hai risorse per risolvere immediatamente.

Nota

Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi. Poiché le funzionalità Scrivi una descrizione per me, Crea un riepilogo dei commenti, Attività consigliate, Usa Amazon Q per creare o aggiungere funzionalità a un progetto e Assegna i problemi ad Amazon Q con Amazon Q Developer Agent per lo sviluppo software sono supportate da Amazon Bedrock, gli utenti possono utilizzare al meglio i controlli implementati in Amazon Bedrock per rafforzare la protezione, la sicurezza e l’uso responsabile dell’intelligenza artificiale (IA).

Di seguito sono riportate alcune best practice per aiutarti a creare progetti e aggiungere blueprint con Amazon Q.

Importante

Le funzionalità di intelligenza artificiale generativa sono disponibili solo nella regione Stati Uniti occidentali (Oregon).

• Utilizza i prompt predefiniti forniti da Amazon Q. Amazon Q fa meglio a scegliere i blueprint tra i prompt forniti.

• Utilizza le opzioni di configurazione suggerite da Amazon Q per visualizzare in anteprima i blueprint. Scegli un blueprint per visualizzare in anteprima il codice di esempio e le risorse che verranno create dal blueprint.

• Usa uno spazio abilitato per Amazon Q. Per creare un progetto con Amazon Q o per aggiungere funzionalità a un progetto con blueprint utilizzando Amazon Q, utilizza uno spazio abilitato per le funzionalità di intelligenza artificiale generativa. Per ulteriori informazioni, consulta Abilitare o disabilitare le funzionalità di intelligenza artificiale generativa per uno spazio.

• Ottieni maggiori informazioni sui progetti consigliati da Amazon Q. Potresti voler scoprire di più sul tipo di risorse di progetto, codice di esempio e componenti creati con uno specifico blueprint consigliato. Per ulteriori informazioni sui blueprint disponibili in CodeCatalyst, vedere. Creazione di un progetto completo con CodeCatalyst blueprint

• Consenti ad Amazon Q di risolvere i problemi. Consenti ad Amazon Q di creare problemi per te, assegnarli e monitorarli. Per ulteriori informazioni, consulta Tutorial: utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo.

• Annulla l'assegnazione di Amazon Q ai problemi su cui non si lavora più. Dopo aver completato l'esempio, annulla l'assegnazione di Amazon Q da eventuali problemi su cui non si sta più lavorando. Se Amazon Q ha terminato il lavoro su un problema o non è riuscito a trovare una soluzione, assicurati di annullare l'assegnazione di Amazon Q per evitare di raggiungere la quota massima di funzionalità di intelligenza artificiale generativa. Per ulteriori informazioni, consulta Gestione delle funzionalità e dei prezzi dell'IA generativa. https://codecatalyst.aws/explore/pricing

• Visualizza l'utilizzo di Amazon Q. Puoi visualizzare l'utilizzo delle funzionalità di intelligenza artificiale generativa a livello di utente. Vai a Le mie impostazioni per gestire le quote AI generative e visualizzarne l'utilizzo in base al tuo Builder ID o all'identità Single Sign-on (SSO). Per ulteriori informazioni, consulta Visualizzazione dell'utilizzo delle funzionalità di intelligenza artificiale generativa in uno spazio.

Importante

Le funzionalità di intelligenza artificiale generativa in CodeCatalyst sono soggette a quote. Per ulteriori informazioni, consulta Amazon Q Developer Pricing, Abilitazione o disabilitazione delle funzionalità AI generative per uno spazio e Fatturazione. https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html

Le migliori pratiche per l'utilizzo dei blueprint nei progetti

Di seguito sono riportate alcune best practice per aiutarti a creare un progetto con blueprint o ad aggiungere blueprint.

• Usa i blueprint forniti da CodeCatalyst per creare o aggiungere progetti. Puoi utilizzare i blueprint per creare un progetto completo con codice sorgente e risorse per gli sviluppatori. Ad esempio, il blueprint dell'applicazione Web crea risorse per l'applicazione e l'infrastruttura e distribuisce un'applicazione Web. È possibile creare un progetto con un blueprint o aggiungere un blueprint personalizzato a un progetto esistente. Per ulteriori informazioni, consulta Creazione di un progetto con un blueprint. Visualizza qualsiasi blueprint in CodeCatalyst per visualizzare in anteprima il codice di esempio e le risorse che verranno create dal blueprint.

• Usa progetti personalizzati progettati dalla tua organizzazione. Puoi utilizzare progetti personalizzati per creare un progetto completo nel tuo spazio. Il progetto personalizzato progettato dalla tua organizzazione può fornire standardizzazione e best practice, che possono anche aiutare a ridurre gli sforzi per creare un nuovo progetto. In qualità di autore di un blueprint personalizzato, puoi visualizzare i dettagli sui progetti che utilizzano il tuo blueprint in tutto il tuo spazio. La gestione del ciclo di vita consente di gestire centralmente il ciclo di vita dello sviluppo del software di ogni progetto e gli utenti del blueprint possono utilizzare la gestione del ciclo di vita per rigenerare una base di codice a partire da opzioni o versioni aggiornate di un blueprint. Per ulteriori informazioni, consulta Lavorare con la gestione del ciclo di vita come autore di progetti.

• Aggiungi il ruolo di sviluppatore o i ruoli IAM appropriati all'account per il tuo progetto. Durante o dopo aver completato i passaggi di creazione del progetto, puoi configurare le autorizzazioni del blueprint scegliendo o creando ruoli IAM in un Account AWS modulo connesso allo spazio.

Aggiungere risorse e attività ai progetti creati

Una volta che il progetto è pronto, puoi aggiungere risorse e attività.

• Per ulteriori informazioni sui CI/CD flussi di lavoro creati con il progetto, consultaGuida introduttiva ai flussi di lavoro.

• Per lavorare con azioni di compilazione simili a quelle del tuo nuovo progetto che distribuiscono gli artefatti di compilazione in un bucket Amazon S3, consulta e. Costruire con flussi di lavoro Tutorial: Caricare artefatti su Amazon S3

• Per iniziare con un progetto vuoto e lavorare con la distribuzione di un'applicazione serverless simile con una distribuzione in stack, consulta. CloudFormation Tutorial: Implementazione di un'applicazione serverless

• Per aggiungere una scheda di pianificazione dei problemi, vedere. Tieni traccia e organizza il lavoro con problemi in CodeCatalyst

• Per visualizzare la panoramica del progetto, lo stato del progetto, l'attività recente del team e il lavoro assegnato, vedereOttenere un elenco di progetti.

• Per visualizzare il codice sorgente o creare una pull request, consultaArchivia e collabora sul codice con i repository di sorgenti in CodeCatalyst.

• Per configurare le notifiche che inviano avvisi di stato relativi al successo o al fallimento del flusso di lavoro, consultaInvio di notifiche via email e su Slack da CodeCatalyst.

• Per invitare membri al tuo progetto, consultaConcessione delle autorizzazioni di progetto agli utenti.

• Per configurare Dev Environments, consultaScrivi e modifica codice con Dev Environments in CodeCatalyst.