Questo è il comando Knife-Cookbook che può essere eseguito nel provider di hosting gratuito OnWorks utilizzando una delle nostre molteplici workstation online gratuite come Ubuntu Online, Fedora Online, emulatore online Windows o emulatore online MAC OS
PROGRAMMA:
NOME
Knife-cookbook - La pagina man per il sottocomando Knife cookbook.
Un libro di cucina è l'unità fondamentale della configurazione e della distribuzione delle politiche. Ogni libro di cucina
definisce uno scenario, come tutto il necessario per installare e configurare MySQL, e quindi
contiene tutti i componenti necessari per supportare tale scenario, tra cui:
· Valori degli attributi impostati sui nodi
· Definizioni che consentono la creazione di raccolte riutilizzabili di risorse
· Distribuzioni di file
· Librerie che estendono lo chef-client e/o forniscono aiutanti al codice Ruby
· Ricette che specificano quali risorse gestire e l'ordine in cui tali risorse
sarà applicato
· Risorse e fornitori personalizzati
· Modelli
· Versioni
· Metadati su ricette (comprese le dipendenze), vincoli di versione, supportati
piattaforme e così via
I coltello ricettario il sottocomando viene utilizzato per interagire con i libri di cucina che si trovano sul
Chef server o lo chef-repo locale.
COMUNI VERSIONI
Le seguenti opzioni possono essere usate con uno qualsiasi degli argomenti disponibili per il coltello
ricettario sottocomando:
--chef-zero-porta PORT
La porta su cui ascolterà chef-zero.
-c FILE_CONFIG, --config FILE_CONFIG
Il file di configurazione da utilizzare.
-D, --disabilita-modifica
Utilizzare per impedire l'apertura di $EDITOR e per accettare i dati così come sono.
--default
Utilizzare per fare in modo che il coltello utilizzi il valore predefinito invece di chiedere a un utente di fornirne uno.
-e EDITORE, --editore EDITOR
Il $EDITOR utilizzato per tutti i comandi interattivi.
-E AMBIENTE, --ambiente AMBIENTE
Il nome dell'ambiente. Quando questa opzione viene aggiunta a un comando, il comando
verrà eseguito solo sull'ambiente denominato.
-F FORMATO, --formato FORMATO
Il formato di output: sommario (Impostazione predefinita), testo, json, YAMLe pp.
-H, --Aiuto
Mostra l'aiuto per il comando.
-k CHIAVE, --chiave KEY
La chiave privata che il coltello utilizzerà per firmare le richieste fatte dal client API al
Cuoco servitore.
--[no-]colore
Utilizzare per visualizzare l'output colorato.
--stampa-dopo
Utilizzare per mostrare i dati dopo un'operazione distruttiva.
-s Url, --URL-server URL
L'URL del server Chef.
-u UTENTE, --utente UTENTE
Il nome utente utilizzato dal coltello per firmare le richieste fatte dal client API allo Chef
server. L'autenticazione avrà esito negativo se il nome utente non corrisponde alla chiave privata.
-V, --verboso
Impostato per output più dettagliati. Utilizzo -VV per la massima verbosità.
-in, --versione
La versione dello chef-cliente.
-sì, --sì
Utilizzare per rispondere a tutte le richieste di conferma con "Sì". il coltello non chiederà
conferma.
-z, --modalità locale
Utilizzare per eseguire il client chef in modalità locale. Ciò consente tutti i comandi che funzionano
contro il server Chef per lavorare anche contro lo chef-repo locale.
QUANTITA’ DELETE
I massa delete l'argomento viene utilizzato per eliminare i file del libro di cucina che corrispondono a un modello definito da
un'espressione regolare. L'espressione regolare deve essere racchiusa tra virgolette e non essere racchiusa tra virgolette
da barre (/).
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario eliminazione in blocco REGEX (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-P, --epurazione
Utilizzare per rimuovere completamente un libro di cucina (o una versione del libro di cucina) dal server Chef. Questo
l'azione dovrebbe essere usata con attenzione perché viene memorizzata solo una copia di ogni singolo file
sul server Chef. Di conseguenza, l'eliminazione di un libro di cucina ne disabiliterà qualsiasi altro
libro di cucina che fa riferimento a uno o più file di un libro di cucina che è stato eliminato.
Esempi
Utilizza un'espressione regolare per definire il modello utilizzato per eliminare in blocco i libri di cucina:
$ coltello ricettario eliminazione in blocco "^[0-9]{3}$" -p
CREA
I creare l'argomento viene utilizzato per creare una nuova directory del libro di cucina sulla macchina locale,
inclusi le seguenti directory e file:
· ricettario/attributi
· ricettario/CHANGELOG.md
· ricettario/definizioni
· ricettario/file/predefinito
· ricettario/biblioteche
· ricettario/metadata.rb
· ricettario/fornitori
· ricettario/README.md (o .rdoc)
· ricettario/ricette/default.rb
· ricettario/risorse
· ricettario/modelli/predefinito
Dopo che il libro di cucina è stato creato, può essere caricato sul server Chef utilizzando il pulsante coltello
caricare discussione.
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario creare COOKBOOK_NAME (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-C TITOLARE_DEL COPYRIGHT, --diritto d'autore COPYRIGHT_TITOLARE
Il nome del titolare del copyright. Questa opzione inserirà un avviso di copyright che
contiene il nome del titolare del copyright in ciascuno dei file pre-creati. Se questo
opzione non è specificata, verrà utilizzato un nome di copyright di "your_company_name"
Invece; può essere facilmente modificato in seguito.
-I LICENZA, --licenza LICENZA ILLIMITATA
Il tipo di licenza con cui viene distribuito un libro di cucina: apachev2, gplv2, gplv3,
con, o nessuna (predefinito). Questa opzione inserirà l'avviso di licenza appropriato in
i file pre-creati: Apache v2.0 (Per apachev2), GPL v2 (Per gplv2), GPL v3 (Per
gplv3), CON (Per con), o licenza "Proprietario" - Tutti Diritti RISERVATO (Per nessuna). Essere
conoscere le licenze per i file all'interno di un libro di cucina e assicurarsi di seguire qualsiasi
restrizioni che descrivono.
-m E-MAIL, --e-mail E-MAIL
L'indirizzo e-mail della persona che gestisce il libro di cucina. Questa opzione sarà
inserire un indirizzo e-mail in ciascuno dei file pre-creati. Se questa opzione non lo è
specificato, verrà invece utilizzato un nome email di "tua_email"; può essere facilmente
modificato in seguito.
-o SENTIERO, --percorso-libro di cucina PERCORSO
La directory in cui vengono creati i libri di cucina. Questo può essere un percorso separato da due punti.
-r FORMATO, --readme-formato FORMATO
Il formato del documento del file readme: md (ribasso) e rddoc (Ruby documenti).
Esempi
Per creare un libro di cucina denominato "my_cookbook" con copyright, e-mail, licenza e formato readme
opzioni specificate, inserire:
$ coltello ricettario create my_cookbook -C "Il mio nome" -m "[email protected]" -I apachev2 -r md
per restituire qualcosa come:
** Creazione del libro di cucina my_cookbook
** Creazione di README per ricettario: my_cookbook
** Creazione di metadati per il libro di cucina: my_cookbook
DELETE
I delete l'argomento viene utilizzato per eliminare un libro di cucina specificato o una versione del libro di cucina sullo Chef
server (e non localmente).
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario delete COOKBOOK_NAME [COOKBOOK_VERSION] (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-un, --tutti
Utilizzare per eliminare tutti i libri di cucina (e le versioni dei libri di cucina).
LIBRO DI CUCINA_VERSIONE
La versione di un libro di cucina da eliminare. Se un libro di cucina ha una sola versione, questa
non è necessario specificare l'opzione. Se un libro di cucina ha più di una versione e
questa opzione non è specificata, Knife richiederà una versione.
-P, --epurazione
Utilizzare per rimuovere completamente un libro di cucina (o una versione del libro di cucina) dal server Chef. Questo
l'azione dovrebbe essere usata con attenzione perché viene memorizzata solo una copia di ogni singolo file
sul server Chef. Di conseguenza, l'eliminazione di un libro di cucina ne disabiliterà qualsiasi altro
libro di cucina che fa riferimento a uno o più file di un libro di cucina che è stato eliminato.
Esempi
$ coltello ricettario elimina ricettario_nome versione
Per esempio:
$ coltello ricettario elimina smartmon 0.8
Tipologia Y per confermare una cancellazione.
DOWNLOAD
I scaricare argomento viene utilizzato per scaricare un libro di cucina dal server Chef al corrente
directory di lavoro.
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario download COOKBOOK_NAME [COOKBOOK_VERSION] (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-d SCARICA_DIRECTORY, --dir DOWNLOAD_DIRECTORY
La directory in cui si trovano i libri di cucina.
-F, --vigore
Utilizzare per sovrascrivere una directory esistente.
-N, --più recente
Utilizzare per scaricare la versione più recente di un libro di cucina.
Esempi
Per scaricare un libro di cucina chiamato "smartmon", inserisci:
$ coltello ricettario download smartmon
ELENCO
I stratagemma argomento viene utilizzato per visualizzare un elenco di libri di cucina attualmente disponibili su
Cuoco servitore. L'elenco conterrà solo la versione più recente per ogni ricettario di
predefinito.
Sintassi
Questo argomento ha la seguente sintassi:
$ lista del ricettario coltello (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-un, --tutti
Utilizzare per restituire tutte le versioni disponibili per ogni ricettario.
-w, --con-uri
Utilizzare per mostrare gli URI corrispondenti.
Esempi
Per visualizzare un elenco di libri di cucina:
$ lista dei libri di cucina del coltello
METADATA
I metadati argomento viene utilizzato per generare i metadati per uno o più libri di cucina.
Sintassi
Questo argomento ha la seguente sintassi:
$ metadati del ricettario coltello (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-un, --tutti
Utilizzare per generare metadati per tutti i libri di cucina.
-o PERCORSO: PERCORSO, --percorso-libro di cucina PERCORSO:PERCORSO
La directory in cui vengono creati i libri di cucina. Questo può essere un percorso separato da due punti.
Esempi
$ metadati del libro di cucina del coltello -a
METADATA DA RISORSE
I metadati da filetto argomento viene utilizzato per caricare i metadati per un libro di cucina da un file.
Sintassi
Questo argomento ha la seguente sintassi:
$ metadati del libro di cucina del coltello dal file FILE
Opzioni
Questo comando non ha opzioni specifiche.
Esempi
$ metadati del libro di cucina del coltello dal file /percorso/del/file
MOSTRARE
I mostrare attraverso le sue creazioni l'argomento viene utilizzato per visualizzare le informazioni su un libro di cucina, parti di un libro di cucina
(attributi, definizioni, file, librerie, fornitori, ricette, risorse e modelli),
o un file associato a un libro di cucina (inclusi attributi come checksum o
specificità).
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario show COOKBOOK_NAME [COOKBOOK_VERSION] [PART...] [FILE_NAME] (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
LIBRO DI CUCINA_VERSIONE
La versione di un libro di cucina da mostrare. Se un libro di cucina ha una sola versione, questa
non è necessario specificare l'opzione. Se un libro di cucina ha più di una versione e
questa opzione non è specificata, verrà restituito un elenco di versioni del libro di cucina.
-f nome di dominio completo, --fqdn FQDN
Il nome di dominio completo dell'host.
NOME DEL FILE
Il nome di un file associato a un libro di cucina.
-p PIATTAFORMA, --piattaforma PIATTAFORMA
La piattaforma per la quale è progettato un libro di cucina.
PARTE La parte del ricettario da mostrare: gli attributi, definizioni, file, biblioteche,
fornitori, ricette, risorse, o modelli. È possibile specificare più di una parte.
-V VERSIONE_PIATTAFORMA, --versione-piattaforma VERSIONE_PIATTAFORMA
La versione della piattaforma.
-w, --con-uri
Utilizzare per mostrare gli URI corrispondenti.
Esempi
Per ottenere l'elenco delle versioni disponibili di un libro di cucina denominato "per iniziare", inserisci:
$ coltello libro di cucina mostra come iniziare
per restituire qualcosa come:
per iniziare 0.3.0 0.2.0
Per visualizzare un elenco di dati su un libro di cucina utilizzando il nome del libro di cucina e la versione,
accedere:
$ coltello libro di cucina mostra come iniziare 0.3.0
per restituire qualcosa come:
attributi:
checksum: fa0fc4abf3f6787aeb5c3c5c35de667c
nome: default.rb
percorso: attributi/default.rb
specificità: default
URL: https://somelongurlhere.com
chef_type: versione_libro di cucina
cookbook_name: come iniziare
definizioni: []
File: []
congelato?: falso
json_class: Chef::Versione libro di cucina
biblioteche: []
Per visualizzare solo i dati sui "modelli", inserisci:
$ coltello ricettario mostra i modelli 0.3.0 per iniziare
per restituire qualcosa come:
checksum: a29d6f254577b830091f140c3a78b1fe
nome: chef-getting-started.txt.erb
percorso: templates/default/chef-getting-started.txt.erb
specificità: default
URL: https://someurlhere.com
Per visualizzare le informazioni in formato JSON, utilizzare il -F opzione comune come parte del comando like
Questo:
$ coltello spettacolo di ruolo devops -F json
Altri formati disponibili includono testo, YAMLe pp.
TEST
I test argomento viene utilizzato per testare un libro di cucina per errori di sintassi. Questo argomento usa Ruby
controllo della sintassi per verificare ogni file in un libro di cucina che termina con .rb e Embedded Ruby
(ERB). Questo argomento rispetterà i file .chefignore nel determinare quali libri di cucina
test per errori di sintassi.
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario test COOKBOOK_NAME (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-un, --tutti
Utilizzare per testare tutti i libri di cucina.
-o PERCORSO: PERCORSO, --percorso-libro di cucina PERCORSO:PERCORSO
La directory in cui vengono creati i libri di cucina. Questo può essere un percorso separato da due punti.
Esempi
$ coltello ricettario test ricetta_nome
CARICARE
I caricare viene utilizzato per caricare uno o più libri di cucina (e tutti i file che sono
associati a quei libri di cucina) da un repository locale al server Chef. Solo file
che non esistono già sul server Chef verranno caricati.
NOTA:
Utilizzare un file .chefignore per impedire il caricamento di file e tipi di file specifici, come
file temporanei o file inseriti in cartelle dai sistemi di controllo della versione. Lo .chefignore
il file deve trovarsi nella radice del repository del libro di cucina e deve utilizzare regole simili
al filename globbing (come definito da Ruby File.fnmatch sintassi).
NOTA:
Le directory vuote non vengono caricate sul server Chef. Per caricare una directory vuota,
creare un file "punto" --- ad es .mantenere---in quella directory per garantire che la directory
di per sé non è vuoto.
Sintassi
Questo argomento ha la seguente sintassi:
$ coltello ricettario upload [COOKBOOK_NAME...] (opzioni)
Opzioni
Questo argomento ha le seguenti opzioni:
-un, --tutti
Utilizzare per caricare tutti i libri di cucina.
--concorrenza
Il numero di connessioni simultanee consentite. Predefinito: 10.
-D, --include-dipendenze
Utilizzare per garantire che quando un libro di cucina dipende da uno (o più) libri di cucina,
verranno caricati anche quei libri di cucina.
-E AMBIENTE, --ambiente AMBIENTE
Utilizzare per impostare la dipendenza della versione dell'ambiente dalla versione del libro di cucina in corso
caricato.
--vigore
Utilizzare per aggiornare un libro di cucina anche se il --congelare bandiera è stata impostata.
--congelare
Utilizzare per richiedere che le modifiche a un libro di cucina vengano incluse come nuova versione. Solo il --vigore
l'opzione può sovrascrivere questa impostazione.
-o PERCORSO: PERCORSO, --percorso-libro di cucina PERCORSO:PERCORSO
La directory in cui vengono creati i libri di cucina. Questo può essere un percorso separato da due punti.
Esempi
$ coltello ricettario carica ricettario_nome
Per caricare un libro di cucina e quindi impedire ad altri utenti di modificarlo,
accedere:
$ coltello ricettario upload redis --freeze
per restituire qualcosa come:
Caricamento redis...
Caricamento completato
Se un libro di cucina è congelato e il --vigore l'opzione non è specificata, il coltello restituirà un
messaggio di errore simile al seguente:
Caricamento redis...
ERRORE: la versione 0.1.6 di redis del libro di cucina è bloccata. Usa --force per sovrascrivere.
Usa il libro di cucina del coltello online utilizzando i servizi di onworks.net