

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

# Installazione di libri di ricette personalizzati
<a name="workingcookbook-installingcustom-enable"></a>

**Importante**  
Il AWS OpsWorks Stacks servizio ha raggiunto la fine del ciclo di vita il 26 maggio 2024 ed è stato disattivato sia per i clienti nuovi che per quelli esistenti. Consigliamo vivamente ai clienti di migrare i propri carichi di lavoro verso altre soluzioni il prima possibile. Se hai domande sulla migrazione, contatta il Supporto AWS Team su [AWS re:post](https://repost.aws/) o tramite Premium [AWS Support](https://aws.amazon.com/support).

Affinché uno stack installi e utilizzi i libri di ricette personalizzati, devi configurare lo stack in modo che vengano abilitati i libri di ricette personalizzati, se non hai già eseguito questa configurazione. Devi quindi fornire l'URL dell'archivio e qualsiasi altra informazione correlata, ad esempio una password.

**Importante**  
Dopo aver configurato lo stack per supportare libri di cucina personalizzati, OpsWorks Stacks installa automaticamente i tuoi libri di cucina su tutte le nuove istanze all'avvio. [**Tuttavia, devi indicare esplicitamente a OpsWorks Stacks di installare libri di cucina nuovi o aggiornati su tutte le istanze esistenti eseguendo il comando Update Custom Cookbooks stack.**](workingstacks-commands.md) Per ulteriori informazioni, consulta [Aggiornamento dei libri di ricette personalizzati](workingcookbook-installingcustom-enable-update.md). Prima di abilitare la funzionalità **Use custom Chef cookbooks (Utilizza i libri di ricette di Chef personalizzati)** sullo stack, assicurarsi che i libri di ricette personalizzati e della community eseguiti supportino la versione di Chef utilizzata dallo stack.

**Per configurare uno stack per i libri di ricette personalizzati**

1. Nella pagina dello stack fare clic su **Stack Settings (Impostazioni stack)** per visualizzare la pagina **Settings (Impostazioni)**. Fare clic su **Edit (Modifica)** per modificare le impostazioni.

1. Impostare **Use custom Chef Cookbooks (Utilizza i libri di ricette di Chef personalizzati)** su **Yes (Sì)**.  
![\[Modifica della pagina delle impostazioni dello stack\]](http://docs.aws.amazon.com/it_it/opsworks/latest/userguide/images/stack_settings_edit.png)

1. Configurare i libri di ricette personalizzati.

Al termine, fare clic su **Save (Salva)** per salvare lo stack aggiornato. 

## Specifica di un archivio di libri di ricette personalizzati
<a name="workingcookbook-installingcustom-enable-repo"></a>

Gli stack Linux possono installare libri di ricette personalizzati dai seguenti tipi di archivio:
+ Archivi HTTP o Amazon S3.

  Possono essere pubblici o privati, ma Amazon S3 è in genere l'opzione preferita per un archivio privato. 
+ Gli archivi Git e Subversion forniscono il controllo del codice sorgente e la possibilità di avere più versioni.

Gli stack di Windows possono installare libri di cucina personalizzati dagli archivi Amazon S3 e dai repository Git.

Tutti i tipi di archivio dispongono dei seguenti campi obbligatori.
+ Tipo di repository: il tipo di **repository**
+ **URL del repository: l'URL del repository**

OpsWorks Stacks supporta siti di repository Git ospitati pubblicamente come [GitHub](https://github.com/)o [Bitbucket](https://bitbucket.org), nonché server Git ospitati privatamente. Per gli archivi Git, devi utilizzare uno dei seguenti formati di URL, a seconda che l'archivio sia pubblico o privato. Utilizza le stesse linee guida per gli URL dei moduli secondari Git.

Per un archivio Git pubblico, utilizza i protocolli HTTPS o Git di sola lettura:
+ Git di sola lettura —. `git://github.com/amazonwebservices/opsworks-example-cookbooks.git`
+ HTTPS —. `https://github.com/amazonwebservices/opsworks-example-cookbooks.git`

Per un repository Git privato, è necessario utilizzare il read/write formato SSH, come mostrato negli esempi seguenti:
+ Archivi Github:. `git@github.com:project/repository`
+ Repository su un server Git — `user@server:project/repository`

Le restanti impostazioni variano a seconda del tipo di repository e sono descritte nelle seguenti sezioni.

### Archivio HTTP
<a name="workingcookbook-installingcustom-enable-repo-http"></a>

Selezionare **Http Archive (Archivio Http)** in **Repository type (Tipo di repository)** per visualizzare due impostazioni aggiuntive, che devono essere impostate se l'archivio è protetto mediante password.
+ **Nome utente: il tuo nome utente**
+ **Password: la tua password**

### Archivio Amazon S3
<a name="workingcookbook-installingcustom-enable-repo-s3"></a>

Selezionare **S3 Archive (Archivio S3)** in **Repository type (Tipo di repository)** per visualizzare le seguenti impostazioni aggiuntive opzionali. OpsWorks Gli stack possono accedere al tuo repository utilizzando EC2 i ruoli Amazon (autenticazione del gestore del sistema operativo host), indipendentemente dal fatto che utilizzi l'API OpsWorks Stacks o la console.
+ **ID chiave di accesso: un ID** della chiave di accesso AWS, ad esempioAKIAIOSFODNN7EXAMPLE.
+ Chiave di **accesso segreta: la chiave** di accesso segreta AWS corrispondente, ad esempiowJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY.

### Archivio Git
<a name="workingcookbook-installingcustom-enable-repo-git"></a>

Se selezioni **Git** in **Source Control (Controllo origine)** vengono visualizzate le seguenti impostazioni aggiuntive opzionali:

**Repository SSH key (Chiave SSH archivio)**  
Devi specificare una chiave SSH di distribuzione per accedere agli archivi Git privati. Per i moduli secondari Git, la chiave specificata deve avere accesso a tali moduli secondari. Per ulteriori informazioni, consulta [Utilizzo di chiavi SSH di repository Git](workingapps-deploykeys.md).  
La chiave SSH di distribuzione non può richiedere una password; OpsWorks Stacks non ha modo di passarla.

**Branch/Revision (Ramo/Versione)**  
Se il repository ha più rami, OpsWorks Stacks scarica il ramo principale per impostazione predefinita. Per specificare un ramo particolare, inserisci il nome del ramo, l' SHA1 hash o il nome del tag. Per specificare un determinato commit, immetti l'ID di commit completo a 40 cifre esadecimali.

### Archivio Subversion
<a name="workingcookbook-installingcustom-enable-repo-svn"></a>

Se selezioni **Subversion** in **Source Control (Controllo origine)** vengono visualizzate le seguenti impostazioni aggiuntive:
+ **Nome utente: il** tuo nome utente, per gli archivi privati.
+ **Password: la** tua password, per gli archivi privati.
+ **Revisione** — [Facoltativo] Il nome della revisione, se sono presenti più revisioni.

  Per specificare un ramo o un tag, devi modificare l'URL del repository, ad esempio: **http://repository\$1domain/repos/myapp/branches/my-apps-branch** o **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag**.