

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

# Tutorial: crea una pipeline da utilizzare AWS AppConfig come provider di distribuzione
<a name="tutorials-AppConfig"></a>

In questo tutorial, configurerai una pipeline che fornisce continuamente file di configurazione, utilizzandola AWS AppConfig come provider di azioni di distribuzione nella fase di distribuzione.

**Importante**  
Come parte della creazione di una pipeline, per gli artefatti verrà utilizzato un bucket di artefatti S3 fornito dal cliente. CodePipeline (Questo è diverso dal bucket utilizzato per un'azione sorgente S3.) Se il bucket di artefatti S3 si trova in un account diverso da quello della pipeline, assicurati che il bucket di artefatti S3 sia di proprietà di utenti sicuri e affidabili. Account AWS 

**Topics**
+ [Prerequisiti](#tutorials-AppConfig-prereq)
+ [Fase 1: Crea le tue risorse AWS AppConfig](#tutorials-AppConfig-application)
+ [Passaggio 2: carica i file nel tuo bucket di origine S3](#tutorials-AppConfig-bucket)
+ [Fase 3: creazione della pipeline](#tutorials-AppConfig-pipeline)
+ [Passaggio 4: apporta una modifica a qualsiasi file di origine e verifica la distribuzione](#tutorials-AppConfig-verify)

## Prerequisiti
<a name="tutorials-AppConfig-prereq"></a>

Prima di iniziare, devi completare quanto segue:
+ Questo esempio utilizza una sorgente S3 per la pipeline. Crea o usa un bucket Amazon S3 con il controllo delle versioni abilitato. Per creare un bucket S3, segui le istruzioni contenute in [Passaggio 1: crea un bucket di origine S3 per la tua applicazione](tutorials-simple-s3.md#s3-create-s3-bucket).

## Fase 1: Crea le tue risorse AWS AppConfig
<a name="tutorials-AppConfig-application"></a>

In questa sezione, crei le seguenti risorse:
+ Un'*applicazione* in AWS AppConfig è un'unità logica di codice che fornisce funzionalità ai clienti.
+ Un *ambiente* in AWS AppConfig è un gruppo logico di AppConfig destinazione di distribuzione, ad esempio applicazioni in un ambiente beta o di produzione.
+ Un *profilo di configurazione* è una raccolta di impostazioni che influenzano il comportamento dell'applicazione. Il profilo di configurazione consente AWS AppConfig di accedere alla configurazione nella posizione memorizzata.
+ (Facoltativo) Una *strategia di distribuzione* AWS AppConfig definisce il comportamento di una distribuzione di configurazione, ad esempio la percentuale di client che deve ricevere la nuova configurazione distribuita in un dato momento durante una distribuzione.

**Per creare un'applicazione, un ambiente, un profilo di configurazione e una strategia di distribuzione**

1. Accedi alla Console di gestione AWS.

1. Utilizza i passaggi descritti nei seguenti argomenti per creare le tue risorse in AWS AppConfig.
   + [Crea un'applicazione](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html).
   + [Crea un ambiente](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html).
   + [Crea un profilo AWS CodePipeline di configurazione](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html).
   + (Facoltativo) [Scegli una strategia di implementazione predefinita o creane una personalizzata.](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html)

## Passaggio 2: carica i file nel tuo bucket di origine S3
<a name="tutorials-AppConfig-bucket"></a>

In questa sezione, crea uno o più file di configurazione. Quindi comprimi e invia i file sorgente nel bucket utilizzato dalla pipeline per la fase di origine.

**Per creare file di configurazione**

1. Crea un `configuration.json` file per ogni configurazione in ogni regione. Includi i seguenti contenuti:

   ```
   Hello World!
   ```

1. Utilizza i seguenti passaggi per comprimere e caricare i file di configurazione.

**Per comprimere e caricare i file sorgente**

1. Crea un file.zip con i tuoi file e assegna un nome al file.zip. `configuration-files.zip` Ad esempio, il tuo file.zip può utilizzare la seguente struttura:

   ```
   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json
   ```

1. Nella console Amazon S3 del tuo bucket, scegli **Carica** e segui le istruzioni per caricare il tuo file.zip.

## Fase 3: creazione della pipeline
<a name="tutorials-AppConfig-pipeline"></a>

In questa sezione, andrai a creare una pipeline con le operazioni seguenti:
+ Una fase di origine con un'azione Amazon S3 in cui gli artefatti di origine sono i file per la configurazione.
+ Una fase di distribuzione con un' AppConfig azione di distribuzione.

**Per creare una pipeline con la procedura guidata**

1. Accedi Console di gestione AWS e apri la CodePipeline console all'[indirizzo http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Nella pagina **Welcome (Benvenuto)**, pagina **Getting started (Nozioni di base)** o pagina **Pipelines (Pipeline)**, scegliere **Create pipeline (Crea pipeline)**.

1. Nella pagina **Passaggio 1: Scegli l'opzione di creazione**, in **Opzioni di creazione**, scegli l'opzione **Crea pipeline personalizzata**. Scegli **Next (Successivo)**.

1. Nel **Passaggio 2: Scegliete le impostazioni della pipeline**, in **Nome della tubazione**, immettete. **MyAppConfigPipeline**

1. CodePipeline fornisce condotte di tipo V1 e V2, che differiscono per caratteristiche e prezzo. Il tipo V2 è l'unico tipo che puoi scegliere nella console. Per ulteriori informazioni, consulta i tipi di [pipeline.](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel) Per informazioni sui prezzi di CodePipeline, consulta la sezione [Prezzi](https://aws.amazon.com/codepipeline/pricing/).

1. In **Ruolo di servizio**, scegli **Nuovo ruolo di servizio** CodePipeline per consentire la creazione di un ruolo di servizio in IAM.

1. Lasciare i valori predefiniti delle impostazioni in **Advanced settings (Impostazioni avanzate)**, quindi scegliere **Next (Successivo)**.

1. Nel **passaggio 3: Aggiungi la fase di origine**, in **Provider di origine**, scegli **Amazon S3**. In **Bucket**, scegli il nome del tuo bucket di origine S3. 

   Nella **chiave dell'oggetto S3**, inserisci il nome del tuo file.zip:. `configuration-files.zip`

   Scegli **Next (Successivo)**.

1. **Nel **passaggio 4: aggiungi la fase di compilazione**, scegli **Ignora fase di compilazione**, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.** 

   Scegli **Next (Successivo)**.

1. **Nel **passaggio 5: aggiungi la fase di test**, scegli **Ignora fase di test**, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.** 

   Scegli **Next (Successivo)**.

1. Nel **passaggio 6: aggiungi la fase di implementazione**:

   1. In **Deploy provider, scegli**. **AWS AppConfig** 

   1. In **Applicazione**, scegli il nome dell'applicazione in AWS AppConfig cui hai creato. Il campo mostra l'ID dell'applicazione.

   1. In **Ambiente**, scegli il nome dell'ambiente in cui hai creato AWS AppConfig. Il campo mostra l'ID del tuo ambiente.

   1. In **Profilo di configurazione**, scegli il nome del profilo di configurazione in cui hai creato AWS AppConfig. Il campo mostra l'ID del tuo profilo di configurazione.

   1. In **Strategia di implementazione**, scegli il nome della tua strategia di distribuzione. Può trattarsi di una strategia di distribuzione creata in precedenza AppConfig o di una strategia di distribuzione scelta tra quelle predefinite. AppConfig Il campo mostra l'ID della tua strategia di distribuzione.

   1. In **Input artifact configuration path**, inserisci il percorso del file. Assicurati che il percorso di configurazione degli artefatti di input corrisponda alla struttura di directory nel file.zip del bucket S3. Per questo esempio, inserisci il seguente percorso del file:. `appconfig-configurations/MyConfigurations/us-west-2/configuration.json` 

   1. Scegli **Next (Successivo)**.

1. Nel **passaggio 7: Rivedi**, esamina le informazioni, quindi scegli **Crea pipeline**.

## Passaggio 4: apporta una modifica a qualsiasi file di origine e verifica la distribuzione
<a name="tutorials-AppConfig-verify"></a>

Apporta una modifica ai file sorgente e carica la modifica nel tuo bucket. In questo modo viene attivata la pipeline per l'esecuzione. Verifica che la tua configurazione sia disponibile visualizzando la versione.