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

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

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 AWS Support Team su AWS re:post o tramite Premium AWS Support.

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 cucina possono essere utilizzati con OpsWorks Stacks senza modifiche, quindi potresti sfruttarli per alcune delle tue attività invece di implementare tutto il codice da solo.

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, incluse EC2 le istanze OpsWorks Stacks, ma è anche progettato per funzionare con Test Kitchen e Vagrant. Tuttavia, l'utilizzo su Vagrant è leggermente diverso rispetto a OpsWorks Stacks, quindi 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
Usare Berkshelf con Stacks OpsWorks

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 di una fonte di libri 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 usato da Stacks. OpsWorks 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.

Questo esempio utilizza il primo approccio, per garantire la coerenza con 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 successivo utilizza un' OpsWorks istanza Stacks.

Usare Berkshelf con Stacks OpsWorks

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

Abilita Berkshelf per lo stack.

OpsWorks Stacks gestisce quindi 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 OpsWorks Stacks installa il tuo repository di libri di cucina personalizzato su un'istanza, utilizza Berkshelf per installare i libri di cucina dipendenti dichiarati nel Berksfile del repository. Per ulteriori informazioni, consulta Utilizzo di Berkshelf.

Questo esempio mostra come utilizzare Berkshelf per installare il ricettario della community per iniziare su un'istanza Stacks. OpsWorks 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 è la prima volta che installi un ricettario personalizzato su uno OpsWorks stack Stacks, dovresti prima seguire 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 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 EC2 chiavi Amazon
Se devi creare una coppia di EC2 chiavi Amazon, 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 OpsWorks Stacks, i libri di cucina devono trovarsi in un archivio remoto con una struttura di directory standard. Quindi fornisci le informazioni di download a OpsWorks Stacks, che scarica automaticamente il repository su ciascuna istanza dello stack all'avvio. Per semplicità, il repository di questo esempio è un archivio Amazon S3 pubblico, 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 OpsWorks Stacks le informazioni necessarie per scaricare l'archivio dei libri di cucina nelle tue 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. 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 and. 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.
  
  OpsWorks Stacks esegue le ricette come root, quindi Getting-Started installa il file nella directory anziché nella directory home. /root

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 OpsWorks specifici per Stacks su Windows Stacks

Utilizzo dell'SDK for Ruby