Pubblicazione di un blueprint personalizzato in uno spazio

Prima di inserire un blueprint personalizzato nel catalogo dei blueprint del tuo spazio, devi pubblicarlo nello spazio. È inoltre possibile visualizzare il blueprint nella CodeCatalyst console prima della pubblicazione. È possibile pubblicare una versione di anteprima o una versione normale del blueprint.

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.

Importante

Per pubblicare un blueprint personalizzato nel tuo CodeCatalyst spazio, devi accedere con un account che abbia il ruolo di amministratore dello spazio o Power user nello spazio.

Visualizzazione e pubblicazione di una versione di anteprima di un blueprint personalizzato

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.

Dopo aver apportato le modifiche, ricostruisci il pacchetto del tuo blueprint personalizzato eseguendo il package.json file e visualizza in anteprima le modifiche.

Per visualizzare e pubblicare una versione di anteprima di un blueprint personalizzato

1. Riprendi il tuo ambiente di sviluppo. Per ulteriori informazioni, consulta Ripresa del lavoro in un ambiente di sviluppo

2. Apri un terminale funzionante nel tuo ambiente di sviluppo.

3. (Facoltativo) In un terminale funzionante, installa le dipendenze necessarie per il tuo progetto se non le hai già installate. Utilizza il seguente comando:

   yarn

4. (Facoltativo) Se hai apportato modifiche al .projenrc.ts file, rigenera la configurazione del progetto prima di creare e visualizzare l'anteprima del blueprint. Utilizza il seguente comando:

   yarn projen

5. Ricostruisci e visualizza in anteprima il tuo blueprint personalizzato utilizzando il seguente comando. Utilizzate il seguente comando:

   yarn blueprint:preview

   Vai al See this blueprint at: link fornito per visualizzare in anteprima il tuo blueprint personalizzato. 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.

6. (Facoltativo) Puoi pubblicare una versione di anteprima del tuo blueprint personalizzato, che può quindi essere aggiunta al catalogo dei blueprint del tuo spazio. Vai al Enable version [preview version number] at: link per pubblicare una versione di anteprima nel tuo spazio.

Puoi emulare la creazione di un progetto senza dover creare un progetto in CodeCatalyst. Per sintetizzare il progetto, utilizzate il seguente comando:

yarn blueprint:synth

Nella cartella viene generato un blueprint. synth/synth.[options-name]/proposed-bundle/ Per ulteriori informazioni, consulta Sintesi.

Se stai aggiornando il tuo blueprint personalizzato, utilizza invece il seguente comando per risintetizzare il progetto:

yarn blueprint:resynth

Nella cartella viene generato un blueprint. synth/synth.[options-name]/proposed-bundle/ Per ulteriori informazioni, consulta Risintesi.

Dopo aver pubblicato la versione di anteprima, è possibile aggiungere il blueprint in modo che i membri dello spazio possano utilizzarlo per creare nuovi progetti o aggiungere progetti esistenti. Per ulteriori informazioni, consulta Aggiungere un blueprint personalizzato a un catalogo di progetti spaziali.

Visualizzazione e pubblicazione di una versione normale di un blueprint personalizzato

Dopo aver completato lo sviluppo e la visualizzazione in anteprima del blueprint personalizzato, puoi visualizzare e pubblicare la nuova versione che desideri aggiungere al catalogo dei blueprint del tuo spazio. Il flusso di lavoro di rilascio generato durante la creazione di un progetto pubblica automaticamente le modifiche che vengono inviate. Se hai disattivato la generazione del flusso di lavoro durante la creazione del blueprint, il tuo blueprint non viene automaticamente reso disponibile per essere aggiunto al catalogo dei blueprint del tuo spazio. Puoi comunque pubblicare il tuo blueprint personalizzato nel tuo spazio dopo aver eseguito un comando. yarn

Per visualizzare e pubblicare un blueprint personalizzato

1. Riprendi il tuo ambiente di sviluppo. Per ulteriori informazioni, consulta Ripresa del lavoro in un ambiente di sviluppo

2. Apri un terminale funzionante nel tuo ambiente di sviluppo.

3. • Se hai disattivato la generazione del workflow di rilascio durante la creazione del blueprint, usa il seguente comando:

     yarn blueprint:release

     Puoi comunque accedere al See this blueprint at: link fornito per visualizzare il tuo blueprint personalizzato.

     Pubblica la versione aggiornata del tuo blueprint personalizzato, che può quindi essere aggiunta al catalogo dei blueprint del tuo spazio. Vai al Enable version [release version number] at: link per pubblicare la versione più recente nel tuo spazio.

   • Se hai optato per un flusso di lavoro di rilascio durante la creazione del blueprint, la versione più recente del blueprint viene pubblicata automaticamente quando vengono inviate le modifiche. Utilizza il seguente comando:

     git add .

     git commit -m "commit message"

     git push

Dopo aver pubblicato la versione normale, puoi aggiungere il blueprint in modo che i membri dello spazio possano utilizzarlo per creare nuovi progetti o aggiungere progetti esistenti. Per ulteriori informazioni, consulta Aggiungere un blueprint personalizzato a un catalogo di progetti spaziali.

Pubblicazione e aggiunta di un blueprint personalizzato in spazi e progetti specifici

Per impostazione predefinita, i blueprint:release comandi blueprint:preview and vengono pubblicati nello CodeCatalyst spazio in cui è stato creato il blueprint. Se disponi di più spazi Enterprise, puoi visualizzare in anteprima e pubblicare lo stesso blueprint anche in quegli spazi. Puoi anche aggiungere un blueprint a un progetto esistente di un altro spazio.

Per pubblicare o aggiungere un blueprint personalizzato in uno spazio specificato

1. Riprendi il tuo ambiente di sviluppo. Per ulteriori informazioni, consulta Ripresa del lavoro in un ambiente di sviluppo.

2. Apri un terminale funzionante nel tuo ambiente di sviluppo.

3. (Opzionale) Installa le dipendenze necessarie per il tuo progetto se non le hai già installate. Utilizza il seguente comando:

   yarn

4. Utilizzate il --space tag per pubblicare un'anteprima o una versione normale in uno spazio specificato. Per esempio:

   • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

     Output di esempio:

     Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create

   • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

     Output di esempio:

     Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

   Utilizzate il --project per aggiungere una versione di anteprima di un blueprint personalizzato a un progetto esistente in uno spazio specificato. Per esempio:

   yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

   Output di esempio:

   Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
   Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add