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

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

Importante

Il AWS OpsWorks Stacks il 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 Squadra su AWS Re:post o tramite AWS Supporto Premium.

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 AWS OpsWorks Si accumula 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 EC2 istanze Amazon, tra cui AWS OpsWorks Impila le istanze, ma è anche progettato per funzionare con Test Kitchen e Vagrant. Tuttavia, l'utilizzo su Vagrant è leggermente diverso rispetto a AWS 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
Utilizzo di Berkshelf con AWS OpsWorks Stack

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 potrebbe richiederesudo, oppure puoi anche usare 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— La fonte URL 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 usato da AWS OpsWorks Pile. 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 motivi di coerenza con AWS OpsWorks Pile.

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 AWS OpsWorks Istanza Stacks.

Utilizzo di Berkshelf con AWS OpsWorks Stack

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

AWS 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 AWS 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 AWS OpsWorks Istanza 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 è la prima volta che installi un ricettario personalizzato su un AWS OpsWorks Stacks stack, 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 AWS OpsWorksConsole Stacks e fai clic su Aggiungi stack.
Specificare le impostazioni seguenti, accettare i valori predefiniti di altre impostazioni e fare clic su Add Stack (Aggiungi stack).
- Nome — BerksTest
- SSHChiave predefinita: una coppia di EC2 chiavi Amazon
Se devi creare una coppia di EC2 chiavi Amazon, consulta Amazon EC2 Key Pairs. Nota che la key pair deve appartenere alla stessa AWS regione 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 Gli stack, i libri di cucina devono trovarsi in un archivio remoto con una struttura di directory standard. Fornisci quindi le informazioni per il download a AWS 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, ma AWS OpsWorks Stacks supporta anche HTTP archivi, 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'archivio. URL

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
- Repository URL: l'archivio dei libri di cucina URL che hai registrato in precedenza
- Gestisci Berkshelf — Sì
Le prime due impostazioni forniscono AWS OpsWorks Contiene 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 una volta terminata la procedura di avvio dell'istanza. AWS OpsWorks Stacks installa quindi il repository dei 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
Dopo che l'istanza è online, usala per accedere. SSH 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 le ricette come root, quindi Getting-started installa il file nella /root directory 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 AWS OpsWorks Indici di ricerca specifici per gli stack negli stack di Windows

Utilizzo di for Ruby SDK