Guida introduttiva ai blueprint personalizzati

Durante il processo di creazione di un blueprint, puoi configurare il blueprint e generare un'anteprima delle risorse del progetto. Ogni blueprint personalizzato è gestito da un CodeCatalyst progetto, che per impostazione predefinita contiene un flusso di lavoro per la pubblicazione nel catalogo dei blueprint dello spazio.

Durante la configurazione dei dettagli del blueprint personalizzato, puoi anche scegliere di archiviare il codice sorgente del blueprint in un repository di terze parti, dove puoi comunque gestire il blueprint personalizzato e utilizzare le funzionalità di gestione del ciclo di vita per mantenere sincronizzati i progetti del tuo spazio quando il blueprint personalizzato viene modificato. Per ulteriori informazioni, consulta Aggiungi funzionalità ai progetti con estensioni in CodeCatalyst e Lavorare con la gestione del ciclo di vita come autore di progetti.

Se disponi già di un repository di origine con standardizzazione e best practice, puoi scegliere di convertire tale repository di origine in un blueprint personalizzato. Per ulteriori informazioni, consulta Conversione degli archivi di origine in blueprint personalizzati.

Prerequisiti

Prima di creare un blueprint personalizzato, considera i seguenti requisiti:

• Il tuo CodeCatalyst spazio deve essere di livello Enterprise. Per ulteriori informazioni, consulta Managing billing nella Amazon CodeCatalyst Administrator Guide.

• È necessario disporre del ruolo di amministratore di Space o Power user per creare blueprint personalizzati. Per ulteriori informazioni, consulta Concessione dell'accesso con ruoli utente.

Fase 1: Creare un blueprint personalizzato in CodeCatalyst

Quando crei un blueprint personalizzato dalle impostazioni del tuo spazio, viene creato automaticamente un repository. Il repository include tutte le risorse necessarie per sviluppare il blueprint prima di pubblicarlo nel catalogo dei blueprint dello spazio.

Per creare un blueprint personalizzato

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

2. Nella CodeCatalyst console, accedi allo spazio in cui desideri creare un blueprint personalizzato.

3. Nella dashboard dello spazio, scegli la scheda Impostazioni, quindi scegli Blueprints.

4. Scegli Crea progetto.

5. In Assegna un nome al tuo blueprint, 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, è possibile 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.

   Effettua una delle seguenti operazioni a seconda del provider di repository di terze parti che desideri utilizzare:

   • GitHub repository: Connect a un GitHub account.

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

     Nota

     Se utilizzi una connessione a 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.

   • Archivi Bitbucket: Connect uno spazio di lavoro Bitbucket.

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

   • GitLab repository: Connect a un GitLab utente.

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

7. In Dettagli del progetto, procedi come segue:

   1. Nel campo di immissione del testo del nome visualizzato del Blueprint, inserisci un nome che verrà visualizzato nel catalogo dei blueprint del tuo spazio.

   2. Nel campo di immissione del testo Descrizione, inserisci una descrizione per il tuo blueprint personalizzato.

   3. Nel campo di immissione del testo del nome dell'autore, inserisci il nome dell'autore per il tuo blueprint personalizzato.

   4. (Facoltativo) Scegli le impostazioni avanzate.

      1. Scegli + Aggiungi per aggiungere i tag che vengono aggiunti al package.json file.

      2. Scegli il menu a discesa Licenza, quindi scegli una licenza per il tuo blueprint personalizzato.

      3. Nel campo di immissione del testo del nome del pacchetto Blueprint, inserisci un nome per identificare il tuo pacchetto blueprint.

      4. Per impostazione predefinita, un flusso di lavoro di rilascio viene generato utilizzando un blueprint di pubblicazione all'interno del progetto chiamato Blueprint Builder. Il flusso di lavoro pubblica la versione più recente del blueprint nel tuo spazio quando inserisci le modifiche, poiché le autorizzazioni di pubblicazione sono abilitate dal flusso di lavoro di rilascio. Per disattivare la generazione del flusso di lavoro, deseleziona la casella di controllo Rilascia flusso di lavoro.

8. (Facoltativo) Un progetto blueprint viene fornito con un codice predefinito per supportare la pubblicazione del blueprint nel catalogo dei blueprint dello spazio. Per visualizzare i file di definizione con aggiornamenti basati sulle selezioni dei parametri di progetto effettuate, scegli Visualizza codice o Visualizza flusso di lavoro da Genera anteprima del blueprint.

9. Scegli Crea progetto.

Se non hai disattivato la generazione del flusso di lavoro per il tuo blueprint personalizzato, il flusso di lavoro inizia automaticamente a essere eseguito quando viene creato il blueprint. Una volta completata l'esecuzione del flusso di lavoro, il blueprint personalizzato è disponibile per essere aggiunto al catalogo dei blueprint del tuo spazio per impostazione predefinita. Puoi disattivare le autorizzazioni di pubblicazione se non desideri che la versione più recente del blueprint venga pubblicata automaticamente nel tuo spazio. Per ulteriori informazioni, consulta Impostazione delle autorizzazioni di pubblicazione per un blueprint personalizzato e Esecuzione di un workflow.

Poiché il flusso di lavoro di pubblicazione chiamato blueprint-release viene creato utilizzando un blueprint, il blueprint può essere trovato come blueprint applicato al progetto. Per ulteriori informazioni, consulta Aggiungere un modello in un progetto per integrare le risorse e Dissociazione di un blueprint da un progetto per interrompere gli aggiornamenti.

Fase 2: Sviluppa un blueprint personalizzato con componenti

Una procedura guidata per il blueprint viene generata quando si crea un blueprint personalizzato e può essere modificata con componenti durante lo sviluppo del blueprint personalizzato. È possibile aggiornare i src/defaults.json file src/blueprints.js and per modificare la procedura guidata.

Importante

Se desideri utilizzare pacchetti blueprint provenienti da fonti esterne, considera i rischi che tali pacchetti possono comportare. Sei responsabile dei blueprint personalizzati che aggiungi al tuo spazio e del codice che generano.

Crea un ambiente di sviluppo nel tuo CodeCatalyst progetto con un ambiente di sviluppo integrato (IDE) supportato prima di configurare il codice del blueprint. Un ambiente di sviluppo è necessario per lavorare con gli strumenti e i pacchetti richiesti.

Per creare un ambiente di sviluppo

1. Nel riquadro di navigazione, effettuate una delle seguenti operazioni:

   1. Scegli Panoramica, quindi vai alla sezione I miei ambienti di sviluppo.

   2. Scegli Code, quindi scegli Dev Environments.

   3. Scegli Code, scegli Archivi di origine e scegli il repository che hai creato durante la creazione del blueprint.

2. Scegli Create Dev Environment.

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

4. Scegli Lavora in un ramo esistente e dal menu a discesa Existing branch scegli il feature branch che hai creato.

5. (Facoltativo) Nel campo Alias - campo di immissione di testo opzionale, inserisci un alias per identificare l'ambiente di sviluppo.

6. Scegli Crea. Durante la creazione dell'ambiente di sviluppo, la colonna di stato dell'ambiente di sviluppo visualizza Avvio e la colonna di stato indica In esecuzione quando è stato creato l'ambiente di sviluppo.

Per ulteriori informazioni, consulta Scrivi e modifica il codice con Dev Environments in CodeCatalyst.

Per sviluppare il tuo blueprint personalizzato

1. In un terminale funzionante, usa il seguente yarn comando per installare le dipendenze:

   yarn

   Gli strumenti e i pacchetti necessari sono resi disponibili tramite CodeCatalyst Dev Environment, incluso Yarn. Se stai lavorando su un progetto personalizzato senza un ambiente di sviluppo, installa prima Yarn sul tuo sistema. Per ulteriori informazioni, consulta la documentazione di installazione di Yarn.

2. Sviluppa il tuo blueprint personalizzato in modo che sia configurato secondo le tue preferenze. Puoi modificare la procedura guidata del tuo blueprint aggiungendo componenti. Per ulteriori informazioni, consulta Sviluppo di un modello personalizzato per soddisfare i requisiti del progetto, Modifica delle funzionalità del blueprint con una procedura guidata di front-end e Pubblicazione di un blueprint personalizzato in uno spazio.

Passaggio 3: Visualizza l'anteprima di un blueprint personalizzato

Dopo aver configurato e sviluppato il tuo blueprint personalizzato, puoi visualizzare in anteprima e pubblicare la versione di anteprima del tuo blueprint nel tuo spazio. Una versione di anteprima ti dà la possibilità di verificare che il blueprint sia quello che desideri prima che venga utilizzato per creare nuovi progetti o applicato a progetti esistenti.

Per visualizzare in anteprima un blueprint personalizzato

1. In un terminale funzionante, utilizzate il seguente yarn comando:

   yarn blueprint:preview

2. Vai al See this blueprint at: link fornito per visualizzare in anteprima il tuo blueprint personalizzato.

3. Verifica che l'interfaccia utente, incluso il testo, appaia come previsto in base alla configurazione. Se desideri modificare il blueprint personalizzato, puoi modificare il blueprint.ts file, risintetizzare il blueprint e quindi pubblicare nuovamente una versione di anteprima. Per ulteriori informazioni, consulta Risintesi.

(Facoltativo) Passaggio 4: Pubblicare una versione di anteprima del blueprint personalizzata

Puoi pubblicare una versione di anteprima del tuo blueprint personalizzato nel tuo spazio se desideri aggiungerlo al catalogo dei blueprint del tuo spazio. Ciò consente di visualizzare il blueprint come utente prima di aggiungere la versione non in anteprima al catalogo. La versione di anteprima consente di pubblicare senza utilizzare una versione effettiva. Ad esempio, se lavori su una 0.0.1 versione, puoi pubblicare e aggiungere una versione di anteprima, in modo da pubblicare e aggiungere nuovi aggiornamenti per una seconda versione0.0.2.

Per pubblicare una versione di anteprima di un blueprint personalizzato

Vai al Enable version [version number] at: link fornito per abilitare il tuo blueprint personalizzato. Questo collegamento viene fornito quando si esegue il yarn comando inPassaggio 3: Visualizza l'anteprima di un blueprint personalizzato.

Dopo aver creato, sviluppato, visualizzato in anteprima e pubblicato il blueprint personalizzato, puoi pubblicare e aggiungere la versione finale del blueprint al catalogo dei blueprint del tuo spazio. Per ulteriori informazioni, consultare Pubblicazione di un blueprint personalizzato in uno spazio e Aggiungere un blueprint personalizzato a un catalogo di progetti spaziali.