Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).
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 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 CodeCatalystAggiungi funzionalità ai progetti con estensioni](extensions.md) e [Lavorare con la gestione del ciclo di vita come autore di progetti](lifecycle-management-dev.md).
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](convert-bp.md).
**Topics**
+ [Prerequisiti](#prerequisites-bp)
+ [Fase 1: Creare un blueprint personalizzato in CodeCatalyst](#getting-started-create-bp)
+ [Fase 2: Sviluppa un blueprint personalizzato con componenti](#getting-started-develop-bp)
+ [Passaggio 3: Visualizza l'anteprima di un blueprint personalizzato](#getting-started-publish-bp)
+ [(Facoltativo) Passaggio 4: Pubblicare una versione di anteprima del blueprint personalizzata](#getting-started-add-bp)
## 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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-view-plan.html) 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](ipa-roles.md).
## 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/](https://codecatalyst.aws/).
1. Nella CodeCatalyst console, accedi allo spazio in cui desideri creare un blueprint personalizzato.
1. Nella dashboard dello spazio, scegli la scheda **Impostazioni**, quindi scegli **Blueprints**.
1. Scegli **Crea progetto**.
1. 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.
1. (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 CodeCatalystAggiungi funzionalità ai progetti con estensioni](extensions.md).
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](concepts.md#personal-connection-concept) e [Accesso alle GitHub risorse con connessioni personali](ipa-settings-connections.md).
+ **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.
1. 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.
1. Nel campo di immissione **del testo Descrizione**, inserisci una descrizione per il tuo blueprint personalizzato.
1. Nel campo di immissione del testo del **nome dell'autore**, inserisci il nome dell'autore per il tuo blueprint personalizzato.
1. (Facoltativo) Scegli le **impostazioni avanzate**.
1. Scegli **\$1 Aggiungi** per aggiungere i tag che vengono aggiunti al `package.json` file.
1. Scegli il menu a discesa **Licenza**, quindi scegli una licenza per il tuo blueprint personalizzato.
1. Nel campo di immissione del testo **del nome del pacchetto Blueprint**, inserisci un nome per identificare il tuo pacchetto blueprint.
1. **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.**
1. (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.**
1. 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](manage-permissions-bp.md) e [Esecuzione di un workflow](workflows-working-runs.md).
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](apply-bp.md) e [Dissociazione di un blueprint da un progetto per interrompere gli aggiornamentiDissociazione di un blueprint da un progetto](disassociate-bp.md).
## 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**.
1. Scegli **Code**, quindi scegli **Dev Environments**.
1. Scegli **Code**, scegli **Archivi di origine** e scegli il repository che hai creato durante la creazione del blueprint.
1. Scegli **Create** Dev Environment.
1. Scegli un IDE supportato dal menu a discesa. Per ulteriori informazioni, consulta [Ambienti di sviluppo integrati supportati per gli ambienti](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html#devenvironment-supported-ide) di sviluppo.
1. Scegli **Lavora in un ramo esistente** e dal menu a discesa Existing **branch** scegli il feature branch che hai creato.
1. (Facoltativo) Nel campo **Alias - campo di immissione di testo *opzionale***, inserisci un alias per identificare l'ambiente di sviluppo.
1. Scegli **Create (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 CodeCatalystScrivi e modifica il codice con Dev Environments](devenvironment.md).
**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.](https://classic.yarnpkg.com/en/docs/install#mac-stable)
1. 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](develop-bp.md), [Modifica delle funzionalità del blueprint con una procedura guidata di front-end](wizard-bp.md) e [Pubblicazione di un blueprint personalizzato in uno spazio](publish-bp.md).
## 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
```
1. Vai al `See this blueprint at:` link fornito per visualizzare in anteprima il tuo blueprint personalizzato.
1. 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](custom-bp-concepts.md#resynthesis-concept).
## (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 versione`0.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 in[Passaggio 3: Visualizza l'anteprima di un blueprint personalizzato](#getting-started-publish-bp).
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, consulta [Pubblicazione di un blueprint personalizzato in uno spazio](publish-bp.md) e [Aggiungere un blueprint personalizzato a un catalogo di progetti spaziali](add-bp.md).