Utilizzo di Berkshelf con Test Kitchen e Vagrant Utilizzo di Berkshelf con AWS OpsWorks Stacks

Utilizzo di un libro di ricette esterno su un'istanza Linux: Berkshelf

Importante

AWS OpsWorks Stacksnon accetta più nuovi clienti. I clienti esistenti potranno utilizzare la OpsWorks console, l'API, la CLI e CloudFormation le risorse normalmente fino al 26 maggio 2024, momento in cui verranno interrotte. Per prepararti a questa transizione, ti consigliamo di trasferire i tuoi stack a il prima AWS Systems Manager possibile. Per ulteriori informazioni, consultare AWS OpsWorks StacksDomande frequenti sulla fine del ciclo di vita e Migrazione AWS OpsWorks Stacks delle applicazioni su AWS Systems Manager Application Manager.

Nota

Berkshelf è disponibile solo per gli stack Linux Chef 11.10.

Prima di avviare l'implementazione di un libro di ricette, consulta la pagina relativa ai libri di ricette della community, che contiene i libri di ricette creati dai membri della community Chef per un'ampia gamma di scopi. Molti di questi libri di ricette possono essere utilizzati con AWS OpsWorks Stacks senza dover apportare modifiche, pertanto puoi trarne vantaggio per alcune delle tue attività evitando di implementare tutto il codice.

Per usare un libro di ricette esterno su un'istanza, devi installarlo e gestire eventuali dipendenze. L'approccio preferito consiste nell'implementare un libro di ricette che supporta un gestore delle dipendenze denominato Berkshelf. Berkshelf funziona su istanze Amazon EC2, AWS OpsWorks incluse le istanze Stacks, ma è anche progettato per funzionare con Test Kitchen e Vagrant. Tuttavia, l'utilizzo su Vagrant è un po' diverso rispetto a AWS OpsWorks Stacks, perciò questo argomento include esempi per entrambe le piattaforme. Per ulteriori informazioni su come usare Berkshelf, consulta Berkshelf.

Argomenti

Utilizzo di Berkshelf con Test Kitchen e Vagrant
Utilizzo di Berkshelf con AWS OpsWorks Stacks

Utilizzo di Berkshelf con Test Kitchen e Vagrant

Questo esempio illustra come utilizzare Berkshelf per installare il libro di ricette della community getting-started ed eseguirne la ricetta, che consente di installare un breve file di testo nella tua directory principale sull'istanza.

Per installare Berkshelf e inizializzare un libro di ricette

Installare il pacchetto Berkshelf nella workstation, come descritto di seguito.
```
gem install berkshelf
```
A seconda della workstation, questo comando può richiedere sudo oppure è possibile anche utilizzare un gestore di ambiente Ruby come RVM. Per verificare che Berkshelf sia stato installato correttamente, eseguire berks --version.
Il libro di ricette per questo argomento è denominato external_cookbook. È possibile utilizzare Berkshelf per creare un libro di ricette inizializzato anziché ricorrere all'approccio manuale degli argomenti precedenti. Per farlo, accedere alla directory opsworks_cookbooks ed eseguire il comando seguente.
```
berks cookbook external_cookbook
```
Il comando crea la directory external_cookbook e diverse sottodirectory standard di Chef e Test Kitchen, incluse recipes e test. Inoltre, crea versioni predefinite di numerosi file standard, inclusi i seguenti:
- metadata.rb
- I file di configurazione per Vagrant, Test Kitchen e Berkshelf
- Una ricetta default.rb vuota nella directory recipes
Nota
Non è necessario eseguire kitchen init, il comando berks cookbook gestisce tali attività.
Esegui kitchen converge. Il libro di ricette appena creato non fa niente di interessante per il momento, ma converge.

Nota

Inoltre puoi usare berks init per inizializzare un libro di ricette esistente al fine di utilizzare Berkshelf.

Per usare Berkshelf allo scopo di gestire le dipendenze esterne di un libro di ricette, la directory radice del libro di ricette deve contenere un Berksfile, ovvero un file di configurazione che specifica come Berkshelf dovrebbe gestire le dipendenze. Quando hai utilizzato berks cookbook per creare il libro di ricette external_cookbook, è stato creato un Berksfile con i seguenti contenuti.



source "https://supermarket.chef.io"
metadata

Il file include le dichiarazioni seguenti:

source— L'URL della fonte di un libro di cucina.

Un Berksfile può avere un qualsiasi numero di dichiarazioni source, ciascuna delle quali specifica un'origine predefinita per i libri di ricette dipendenti. Se non specifichi esplicitamente un'origine del libro di ricette, Berkshelf cerca nei repository predefiniti un libro di ricette con lo stesso nome. Il Berksfile predefinito include un singolo attributo source che specifica il repository del libro di ricette della community. Questo repository contiene il libro di ricette getting-started, che ti consente di lasciare la riga invariata.
metadata— Indica a Berkshelf di includere le dipendenze dei libri di cucina dichiarate nel file del libro di cucina. metadata.rb

Inoltre puoi dichiarare un libro di ricette dipendente nel Berksfile includendo un attributo cookbook, come illustrato in seguito.

Esistono due modi per dichiarare una dipendenza del libro di ricette:

Includendo una dichiarazione cookbook nel Berksfile.

Questo è l'approccio utilizzato da AWS OpsWorks Stacks. Ad esempio per specificare il libro di ricette getting-started utilizzato in questo esempio, includi cookbook "getting-started" nel Berksfile. Berkshelf cercherà quindi nei repository predefiniti un libro di ricette con tale nome. Puoi inoltre utilizzare cookbook per specificare in modo esplicito un'origine del libro di ricette, nonché una determinata versione. Per ulteriori informazioni, consulta Berkshelf.
Includendo una dichiarazione metadata nel Berksfile e dichiarando la dipendenza in metadata.rb.

Questa dichiarazione indica a Berkshelf di includere le dipendenze del libro di ricette dichiarate in metadata.rb. Ad esempio, per dichiarare una dipendenza getting-started, aggiungere una dichiarazione depends 'getting-started' al file metadata.rb del libro di ricette.

In questo esempio viene utilizzato il primo approccio, per coerenza con AWS OpsWorks Stacks.

Per installare il libro di ricette getting-started

Modificare il Berksfile predefinito per sostituire la dichiarazione metadata con una dichiarazione cookbook per getting-started. I contenuti devono essere simili ai seguenti.
```
source "https://supermarket.chef.io"

cookbook 'getting-started'
```
Eseguire berks install, che scarica il libro di ricette getting-started dal repository del libro di ricette della community alla directory Berkshelf della workstation, generalmente ~/.berkshelf. Spesso questa directory si chiama semplicemente il Berkshelf. Cercare nella directory cookbooks del Berkshelf la directory per il libro di ricette getting-started, che avrà un nome simile a getting-started-0.4.0.
Sostituire external_cookbook::default nell'elenco di esecuzione .kitchen.yml con getting-started::default. In questo esempio non viene eseguita alcuna ricetta da external_cookbook. È fondamentalmente solo un modo per utilizzare il libro di ricette getting-started. Adesso il file .kitchen.yml avrà un aspetto simile al seguente.
```
---
driver:
  name: vagrant

provisioner:
  name: chef_solo

platforms:
  - name: ubuntu-12.04

suites:
  - name: default
    run_list:
      - recipe[getting-started::default]
    attributes:
```
Eseguire kitchen converge e utilizzare kitchen login per accedere all'istanza. La directory di accesso deve contenere un file denominato chef-getting-started.txt con elementi simili ai seguenti:
```
Welcome to Chef!

This is Chef version 11.12.8.
Running on ubuntu.
Version 12.04.
```
Test Kitchen installa libri di ricette nella directory /tmp/kitchen/cookbooks dell'istanza. Se si elencano i contenuti di tale directory, verranno visualizzati due libri di ricette: external_cookbook e getting-started.
Eseguire kitchen destroy per arrestare l'istanza. L'esempio seguente usa un'istanza AWS OpsWorks Stacks.

Utilizzo di Berkshelf con AWS OpsWorks Stacks

AWS OpsWorks Stacks supporta facoltativamente Berkshelf per gli stack Chef 11.10. Per usare Berkshelf con il tuo stack, devi procedere come descritto di seguito.

Abilita Berkshelf per lo stack.

AWS OpsWorks Stacks quindi gestisce i dettagli dell'installazione di Berkshelf sulle istanze dello stack.
Aggiungi un Berksfile alla directory radice del repository del libro di ricette.

Il Berksfile deve contenere le dichiarazioni source e cookbook per tutti i libri di ricette dipendenti.

Quando installa il repository del tuo libro di ricette personalizzato in un'istanza, AWS OpsWorks Stacks utilizza Berkshelf per installare i libri di ricette dipendenti dichiarati nel Berksfile del repository. Per ulteriori informazioni, consulta Utilizzo di Berkshelf.

Questo esempio illustra come utilizzare il Berkshelf per installare il libro di ricette della community getting-started in un'istanza AWS OpsWorks Stacks. Inoltre, installa una versione del libro di ricette personalizzato createfile, che crea un file in una directory specificata. Per ulteriori informazioni sul funzionamento di createfile, consulta Installazione di un file da un libro di ricette.

Nota

Se questa è la prima volta che installi un libro di ricette personalizzato in uno stack AWS OpsWorks Stacks, consulta l'esempio Esecuzione di una ricetta su un'istanza Linux.

Inizia creando uno stack, come descritto brevemente di seguito. Per ulteriori informazioni, consulta Creare un nuovo stack.

Creare uno stack

Aprire la console AWS OpsWorks Stacks e fare clic su Add Stack (Aggiungi stack).
Specificare le impostazioni seguenti, accettare i valori predefiniti di altre impostazioni e fare clic su Add Stack (Aggiungi stack).
- Nome — BerksTest
- Chiave SSH predefinita: una coppia di chiavi Amazon EC2
Se devi creare una coppia di chiavi Amazon EC2, consulta Amazon EC2 Key Pairs. La coppia di chiavi deve appartenere alla stessa regione AWS dell'istanza. L'esempio utilizza la regione predefinita degli Stati Uniti occidentali (Oregon).
Fare clic su Add a layer (Aggiungi un livello) e aggiungere un livello personalizzato allo stack con le impostazioni seguenti.
- Nome: BerksTest
- Nome abbreviato: berkstest
Puoi effettivamente usare qualsiasi tipo di livello per questo esempio. Tuttavia, l'esempio non richiede nessuno dei pacchetti che vengono installati da altri tipi di livelli, pertanto un livello personalizzato è l'approccio più semplice.
Aggiungi un'istanza 24 ore su 24, 7 giorni su 7 al BerksTest layer con le impostazioni predefinite, ma non avviarla ancora.

Con AWS OpsWorks Stacks, i libri di ricette devono essere in un repository remoto con una struttura di directory standard. Quindi, fornisci le informazioni di download a AWS OpsWorks Stacks, che scarica automaticamente il repository in ciascuna delle istanze dello stack all'avvio. Per semplicità, il repository di questo esempio è un archivio Amazon S3 pubblico, AWS OpsWorks ma Stacks supporta anche archivi HTTP, repository Git e repository Subversion. Per ulteriori informazioni, consulta Repository dei libri di ricette.

I contenuti distribuiti ai bucket Amazon S3 potrebbero contenere informazioni dei clienti. Per ulteriori informazioni sulla rimozione di dati sensibili, vedi Come svuotare un bucket S3? o Come eliminare un bucket S3?.

Per creare il repository del libro di ricette

Nella directory opsworks_cookbooks creare una directory denominata berkstest_cookbooks. Se lo si preferisce, è possibile creare questa directory ovunque si ritiene che possa essere utile, perché verrà caricata in un repository.
Aggiungere un file denominato Berksfile a berkstest_cookbooks con i contenuti seguenti.
```
source "https://supermarket.chef.io"

cookbook 'getting-started'
```
Questo file dichiara la dipendenza del libro di ricette getting-started e indica a Berkshelf di scaricarlo dal sito del libro di ricette della community.
Aggiungere una directory createfile a berkstest_cookbooks contenente quanto segue.
- Un file metadata.rb con i seguenti contenuti.
```
name "createfile"
version "0.1.0"
```
- Una directory files/default con un file example_data.json che include il contenuto seguente.
```
{
  "my_name" : "myname",
  "your_name" : "yourname",
  "a_number" : 42,
  "a_boolean" : true
}
```
  Il nome e il contenuto del file sono arbitrari. La ricetta semplicemente copia il file nel percorso specificato.
- Una directory recipes contenente un file default.rb con il codice ricetta seguente.
```
directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end

cookbook_file "/srv/www/shared/example_data.json" do
  source "example_data.json"
  mode 0644
  action :create_if_missing
end
```
  Questa ricetta crea /srv/www/shared e copia example_data.json in tale directory dalla directory files del libro di ricette.
Crea un .zip archivio diberkstest_cookbooks, carica l'archivio in un bucket Amazon S3, rendi l'archivio pubblico e registra l'URL dell'archivio.

Adesso puoi installare i libri di ricette ed eseguire la ricetta.

Per installare i libri di ricette ed eseguire le ricette

Modificare lo stack per abilitare i libri di ricette personalizzati e specificare le impostazioni seguenti.
- Tipo di repository: Http Archive
- URL del repository: l'URL dell'archivio del libro di cucina che hai registrato in precedenza
- Gestisci Berkshelf — Sì
Le prime due impostazioni forniscono a AWS OpsWorks Stacks le informazioni necessarie per scaricare il repository del libro di ricette nelle istanze. L'ultima impostazione abilita il supporto di Berkshelf, che scarica il libro di ricette getting-started nell'istanza. Accettare i valori predefiniti per altre impostazioni e fare clic su Save (Salva) per aggiornare la configurazione dello stack.
Modifica il BerksTest layer per aggiungere le seguenti ricette all'evento Setup lifecycle del layer.
- getting-started::default
- createfile::default
Avviare l'istanza. L'evento Setup si verifica al termine dell'avvio dell'istanza. AWS OpsWorks Stacks installa quindi il repository di libri di cucina, utilizza Berkshelf per scaricare il ricettario introduttivo ed esegue la configurazione del layer e distribuisce le ricette, tra cui e. getting-started::default createfile::default
Una volta che l'istanza è online, utilizzare SSH per accedere. Verrà visualizzato un codice analogo al seguente
- /srv/www/shared deve contenere example_data.json.
- /root deve contenere chef-getting-started.txt.
  
  AWS OpsWorks Stacks esegue ricette come root, perciò getting-started installa il file nella directory /root anziché nella home directory.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Utilizzo di indici di ricerca specifici di AWS OpsWorks Stacks sugli stack Windows

Utilizzo dell'SDK for Ruby