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

# Utilizzo degli strumenti Blueprint e della CLI
<a name="bp-cli"></a>

La [CLI del blueprint](https://www.npmjs.com/package/@amazon-codecatalyst/blueprint-util.cli) fornisce strumenti per gestire e lavorare con i tuoi blueprint personalizzati.

**Topics**
+ [Lavorare con gli strumenti Blueprint](#working-with-bp-cli)
+ [Strumento di caricamento delle immagini](#image-upload-tool)

## Lavorare con gli strumenti Blueprint
<a name="working-with-bp-cli"></a>

**Per lavorare con gli strumenti del blueprint**

1. Apri la CodeCatalyst console all'indirizzo [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Riprendi il tuo ambiente di sviluppo. Per ulteriori informazioni, consulta [Ripresa del lavoro in un ambiente di sviluppo](devenvironment-resume.md).

   Se non disponi di un ambiente di sviluppo, devi prima crearne uno. Per ulteriori informazioni, consulta [Creazione di un ambiente di sviluppo](devenvironment-create.md).

1. In un terminale funzionante, esegui il seguente comando per installare la CLI del blueprint:

   ```
   npm install -g @amazon-codecatalyst/blueprint-util.cli
   ```

1. Nel `blueprint.ts` file, importa gli strumenti che desideri utilizzare nel seguente formato:

   ```
   import { {{<tooling-function-name>}} } from '@amazon-codecatalyst/blueprint-util.cli/lib/{{<tooling-folder-name>}}/{{<tooling-file-name>}};
   ```
**Suggerimento**  
Puoi andare su [https://github.com/aws/codecatalyst-blueprints/tree/main/packages/utils/blueprint-cli](https://github.com/aws/codecatalyst-blueprints/tree/main/packages/utils/blueprint-cli)per trovare il nome dell'utensile che desideri utilizzare.

   **Se desideri utilizzare lo strumento di caricamento delle immagini, aggiungi quanto segue allo script:**

   ```
   import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
   ```

   **Examples** (Esempi)
   + **Se desideri utilizzare la funzione di pubblicazione, aggiungi quanto segue allo script:**

     ```
     import { publish } from '@amazon-codecatalyst/blueprint-util.cli/lib/publish/publish';
     ```
   + **Se desideri utilizzare lo strumento di caricamento delle immagini, aggiungi quanto segue allo script:**

     ```
     import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
     ```

1. Chiamate la funzione.

   **Esempi:**
   + **Se desideri utilizzare la funzione di pubblicazione, aggiungi quanto segue allo script:**

     ```
     await publish(logger, config.publishEndpoint, {{{<your publishing options>}}});
     ```
   + **Se desideri utilizzare lo strumento di caricamento delle immagini, aggiungi quanto segue allo script:**

     ```
     const {imageUrl, imageName} = await uploadImagePublicly(logger, 'path/to/image'));
     ```

## Strumento di caricamento delle immagini
<a name="image-upload-tool"></a>

Lo strumento di caricamento delle immagini ti offre la possibilità di caricare la tua immagine in un bucket S3 nel tuo account AWS e poi distribuirla pubblicamente. CloudFront Lo strumento utilizza come input un percorso dell'immagine nello storage locale (e il nome del bucket opzionale) e restituisce l'URL dell'immagine che è disponibile pubblicamente. Per ulteriori informazioni, consulta [What is Amazon CloudFront?](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) e [cos'è Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)?

**Per utilizzare lo strumento di caricamento delle immagini**

1. Clona l'[ GitHub archivio di blueprints open source](https://github.com/aws/codecatalyst-blueprints) che fornisce l'accesso al blueprints SDK e ai blueprint di esempio. In un terminale funzionante, esegui il seguente comando:

   ```
   git clone https://github.com/aws/codecatalyst-blueprints.git
   ```

1. Esegui il comando seguente per accedere al GitHub repository dei blueprints:

   ```
   cd codecatalyst-blueprints
   ```

1. Esegui il comando seguente per installare le dipendenze:

   ```
   yarn && yarn build
   ```

1. Esegui il comando seguente per assicurarti che sia installata la versione CLI più recente del blueprint:

   ```
   yarn upgrade @amazon-codecatalyst/blueprint-util.cli
   ```

1. Accedi all'account AWS con il bucket S3 in cui desideri caricare l'immagine. Per ulteriori informazioni, consulta [Configurare l'AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) e [accedere tramite l'interfaccia a riga di comando AWS](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html).

1. Esegui il seguente comando dalla radice del tuo CodeCatalyst repository per accedere alla directory con la CLI blueprint:

   ```
   cd packages/utils/blueprint-cli
   ```

1. Esegui il comando seguente per caricare l'immagine in un bucket S3:

   ```
   yarn blueprint upload-image-public {{<./path/to/your/image>}} 
         {{<optional:optional-bucket-name>}}
   ```

Viene generato un URL per la tua immagine. L'URL non sarà disponibile immediatamente poiché la CloudFront distribuzione richiede del tempo per essere distribuita. Controlla lo stato della distribuzione per ottenere lo stato di distribuzione più recente. Per ulteriori informazioni, consulta [Lavorare con le distribuzioni](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html).