couteau-livre de cuisine - En ligne dans le Cloud

PROGRAMME:

Nom

Knife-cookbook - La page de manuel de la sous-commande Knife Cookbook.

Un livre de recettes est l'unité fondamentale de la configuration et de la distribution des politiques. Chaque livre de cuisine
définit un scénario, tel que tout le nécessaire pour installer et configurer MySQL, puis il
contient tous les composants requis pour prendre en charge ce scénario, notamment :

· Valeurs d'attribut définies sur les nœuds

· Des définitions qui permettent la création de collections de ressources réutilisables

· Distributions de fichiers

· Bibliothèques qui étendent le chef-client et/ou fournissent des aides au code Ruby

· Des recettes qui spécifient les ressources à gérer et l'ordre dans lequel ces ressources
sera appliqué

· Ressources et fournisseurs personnalisés

· Modèles

· Versions

· Métadonnées sur les recettes (y compris les dépendances), les contraintes de version, prises en charge
plates-formes, et ainsi de suite

La couteau livre de cuisine la sous-commande est utilisée pour interagir avec les livres de recettes qui se trouvent sur le
Chef serveur ou le chef-repo local.

COMMUNE OPTIONS

Les options suivantes peuvent être utilisées avec n'importe lequel des arguments disponibles pour le couteau
livre de cuisine sous-commande :

--chef-zéro-port PORT
Le port sur lequel chef-zéro écoutera.

-c CONFIG_FILE, --config CONFIG_FILE
Le fichier de configuration à utiliser.

-ré, --disable-édition
À utiliser pour empêcher l'ouverture de $EDITOR et accepter les données telles quelles.

--par défaut
Utilisez pour que le couteau utilise la valeur par défaut au lieu de demander à un utilisateur d'en fournir une.

-e ÉDITEUR, --éditeur EDITEUR
Le $EDITOR qui est utilisé pour toutes les commandes interactives.

-E ENVIRONNEMENT, --environnement ENVIRONNEMENT
Le nom de l'environnement. Lorsque cette option est ajoutée à une commande, la commande
s'exécutera uniquement sur l'environnement nommé.

-F FORMAT, --format Format
Le format de sortie : résumé (Par défaut), texte, json, yamlet pp.

-h, --Aidez-moi
Affiche l'aide pour la commande.

-k CLÉ, --clé clé - KEY
La clé privée que le couteau utilisera pour signer les demandes faites par le client API au
Chef de serveur.

--[sans couleur
Utilisez pour afficher la sortie en couleur.

--imprimer-après
Utilisez pour afficher les données après une opération destructrice.

-s URL, --URL-serveur URL
L'URL du serveur Chef.

-u UTILISATEUR, --utilisateur UTILISATEUR
Le nom d'utilisateur utilisé par le couteau pour signer les demandes faites par le client API au chef
serveur. L'authentification échouera si le nom d'utilisateur ne correspond pas à la clé privée.

-V, --verbeux
Définir pour des sorties plus détaillées. Utilisation -VV pour une verbosité maximale.

-dans, --version
La version du chef-client.

-oui, --Oui
Utilisez pour répondre à toutes les invites de confirmation par « Oui ». le couteau ne demandera pas
confirmation.

-z, --mode local
Utilisez pour exécuter le chef-client en mode local. Cela permet à toutes les commandes qui fonctionnent
contre le serveur Chef pour travailler également contre le chef-repo local.

BULK EFFACER

La masse effacer L'argument est utilisé pour supprimer les fichiers de livre de recettes qui correspondent à un modèle défini par
une expression régulière. L'expression régulière doit être entre guillemets et ne pas être entourée
par des barres obliques (/).

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau livre de cuisine supprimer en bloc REGEX (options)

Options

Cet argument a les options suivantes :

-p, --purge
À utiliser pour supprimer entièrement un livre de recettes (ou une version de livre de recettes) du serveur Chef. Cette
l'action doit être utilisée avec précaution car une seule copie d'un seul fichier est stockée
sur le serveur Chef. Par conséquent, la purge d'un livre de recettes désactivera tout autre
livre de recettes qui fait référence à un ou plusieurs fichiers d'un livre de recettes qui a été purgé.

Exemples

Utilisez une expression régulière pour définir le modèle utilisé pour supprimer en bloc les livres de recettes :

$ couteau livre de cuisine suppression en bloc "^[0-9]{3}$" -p

CREATE

La engendrent l'argument est utilisé pour créer un nouveau répertoire de livre de recettes sur la machine locale,
comprenant les répertoires et fichiers suivants :

· livre de cuisine/attributs

· livre de cuisine/CHANGELOG.md

· livre de cuisine/définitions

· livre de recettes/fichiers/par défaut

· livre de cuisine/bibliothèques

· livre de recettes/metadata.rb

· livre de cuisine/fournisseurs

· livre de recettes/README.md (ou .rdoc)

· livre de cuisine/recettes/default.rb

· livre de recettes/ressources

· livre de cuisine/modèles/par défaut

Une fois le livre de recettes créé, il peut être téléchargé sur le serveur Chef à l'aide du couteau
télécharger argument.

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau livre de cuisine créer COOKBOOK_NAME (options)

Options

Cet argument a les options suivantes :

-C COPYRIGHT_HOLDER, --droits d'auteur COPYRIGHT_HOLDER
Le nom du titulaire du droit d'auteur. Cette option placera un avis de droit d'auteur qui
contient le nom du détenteur des droits d'auteur dans chacun des fichiers pré-créés. Si ce
option n'est pas spécifiée, un nom de copyright de "your_company_name" sera utilisé
au lieu; il peut être facilement modifié plus tard.

-I LICENCE, --Licence LICENCE
Le type de licence sous laquelle un livre de cuisine est distribué : apachev2, gplv2, gplv3,
, et de ou aucun (défaut). Cette option placera l'avis de licence approprié dans
les fichiers pré-créés : Apache v2.0 (Pour apachev2), GPL v2 (Pour gplv2), GPL v3 (Pour
gplv3), MIT (Pour , et de ), ou Licence 'Propriétaire - Tous Droits Reservé (Pour aucun). Être
connaître les licences pour les fichiers à l'intérieur d'un livre de cuisine et assurez-vous de suivre tout
restrictions qu'ils décrivent.

-m EMAIL, --e-mail E-MAIL
L'adresse e-mail de la personne qui gère le livre de recettes. Cette option va
placez une adresse e-mail dans chacun des fichiers pré-créés. Si cette option n'est pas
spécifié, un nom d'e-mail de "votre_e-mail" sera utilisé à la place ; ça peut être facilement
modifié plus tard.

-o CHEMIN, --cookbook-chemin PATH
Le répertoire dans lequel les livres de cuisine sont créés. Cela peut être un chemin séparé par des deux-points.

-r FORMAT, --readme-format Format
Le format de document du fichier readme : md (démarrage) et rdoc (Documentation Ruby).

Exemples

Pour créer un livre de recettes nommé "my_cookbook" avec copyright, e-mail, licence et format readme
options spécifiées, entrez :

$ couteau livre de cuisine create my_cookbook -C "Mon nom" -m "[email protected]" -I apachev2 -r md

pour retourner quelque chose comme :

** Création du livre de recettes my_cookbook
** Création du fichier README pour le livre de recettes : my_cookbook
** Création de métadonnées pour le livre de recettes : my_cookbook

EFFACER

La effacer l'argument est utilisé pour supprimer un livre de cuisine ou une version de livre de cuisine spécifié sur le Chef
serveur (et non localement).

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau livre de cuisine supprimer COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Options

Cet argument a les options suivantes :

-une, --tout
Utilisez pour supprimer tous les livres de cuisine (et les versions de livres de cuisine).

LIVRE DE CUISINE_VERSION
La version d'un livre de recettes à supprimer. Si un livre de cuisine n'a qu'une seule version, cette
l'option n'a pas besoin d'être spécifiée. Si un livre de cuisine a plus d'une version et
cette option n'est pas spécifiée, le couteau demandera une version.

-p, --purge
À utiliser pour supprimer entièrement un livre de recettes (ou une version de livre de recettes) du serveur Chef. Cette
l'action doit être utilisée avec précaution car une seule copie d'un seul fichier est stockée
sur le serveur Chef. Par conséquent, la purge d'un livre de recettes désactivera tout autre
livre de recettes qui fait référence à un ou plusieurs fichiers d'un livre de recettes qui a été purgé.

Exemples

$ couteau livre de cuisine supprimer cookbook_name version

Par exemple :

$ couteau livre de cuisine supprimer smartmon 0.8

Type Y pour confirmer une suppression.

TÉLÉCHARGER

La download L'argument est utilisé pour télécharger un livre de recettes du serveur Chef vers le
directeur de travail.

Syntaxe

Cet argument a la syntaxe suivante :

$ téléchargement du livre de cuisine couteau COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Options

Cet argument a les options suivantes :

-d TÉLÉCHARGEMENT_RÉPERTOIRE, --rép TÉLÉCHARGEMENT_RÉPERTOIRE
Le répertoire dans lequel se trouvent les livres de cuisine.

-F, --Obliger
Utilisez pour écraser un répertoire existant.

-N, --dernier
Utilisez pour télécharger la version la plus récente d'un livre de cuisine.

Exemples

Pour télécharger un livre de recettes nommé "smartmon", saisissez :

$ couteau livre de cuisine télécharger smartmon

LISTE

La liste est utilisé pour afficher une liste de livres de cuisine actuellement disponibles sur le
Chef de serveur. La liste ne contiendra que la version la plus récente pour chaque livre de cuisine par
défaut.

Syntaxe

Cet argument a la syntaxe suivante :

$ liste de livres de cuisine couteau (options)

Options

Cet argument a les options suivantes :

-une, --tout
Utilisez pour renvoyer toutes les versions disponibles pour chaque livre de cuisine.

-w, --avec-uri
Utilisez pour afficher les URI correspondants.

Exemples

Pour afficher une liste de livres de cuisine :

$ liste de livres de cuisine couteau

METADATA

La métadonnées L'argument est utilisé pour générer les métadonnées d'un ou plusieurs livres de cuisine.

Syntaxe

Cet argument a la syntaxe suivante :

$ métadonnées du livre de cuisine du couteau (options)

Options

Cet argument a les options suivantes :

-une, --tout
À utiliser pour générer des métadonnées pour tous les livres de cuisine.

-o CHEMIN:CHEMIN, --cookbook-chemin CHEMIN:CHEMIN
Le répertoire dans lequel les livres de cuisine sont créés. Cela peut être un chemin séparé par des deux-points.

Exemples

$ métadonnées du livre de cuisine du couteau -a

METADATA De DOSSIER

La métadonnées de filet L'argument est utilisé pour charger les métadonnées d'un livre de recettes à partir d'un fichier.

Syntaxe

Cet argument a la syntaxe suivante :

Métadonnées du livre de cuisine $ Knife à partir du fichier FILE

Options

Cette commande n'a pas d'options spécifiques.

Exemples

$ métadonnées du livre de recettes du couteau du fichier /chemin/vers/fichier

SPECTACLES

La montrer l'argument est utilisé pour afficher des informations sur un livre de cuisine, des parties d'un livre de cuisine
(attributs, définitions, fichiers, bibliothèques, fournisseurs, recettes, ressources et modèles),
ou un fichier associé à un livre de recettes (y compris des attributs tels que la somme de contrôle ou
spécificité).

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau livre de cuisine show COOKBOOK_NAME [COOKBOOK_VERSION] [PART...] [FILE_NAME] (options)

Options

Cet argument a les options suivantes :

LIVRE DE CUISINE_VERSION
La version d'un livre de cuisine à afficher. Si un livre de cuisine n'a qu'une seule version, cette
l'option n'a pas besoin d'être spécifiée. Si un livre de cuisine a plus d'une version et
cette option n'est pas spécifiée, une liste de versions de livres de recettes sera renvoyée.

-f nom de domaine complet, --nom de domaine FQDN
Le FQDN de l'hôte.

NOM DE FICHIER
Le nom d'un fichier associé à un livre de recettes.

-p PLATE-FORME, --Plate-forme PLATEFORME
La plate-forme pour laquelle un livre de cuisine est conçu.

PARTIE La partie du livre de cuisine à afficher : attributs, définitions, fichiers, bibliothèques,
fournisseurs, recettes, NUMÉRIQUES ou modèles. Plusieurs parties peuvent être spécifiées.

-V PLATEFORME_VERSION, --plateforme-version PLATEFORME_VERSION
La version de la plateforme.

-w, --avec-uri
Utilisez pour afficher les URI correspondants.

Exemples

Pour obtenir la liste des versions disponibles d'un livre de recettes nommé « démarrage », entrez :

$ couteau livre de cuisine émission de démarrage

pour retourner quelque chose comme :

mise en route 0.3.0 0.2.0

Pour afficher une liste de données sur un livre de cuisine en utilisant le nom du livre de cuisine et la version,
entrer:

$ couteau livre de cuisine show mise en route 0.3.0

pour retourner quelque chose comme :

attributs:
checksum: fa0fc4abf3f6787aeb5c3c5c35de667c
nom : default.rb
chemin : attributs/default.rb
spécificité : par défaut
URL : https://somelongurlhere.com
chef_type : version_livre de cuisine
cookbook_name : mise en route
définitions : []
des dossiers: []
gelé ? : faux
json_class:Chef::CookbookVersion
bibliothèques : []

Pour afficher uniquement les données sur les "modèles", saisissez :

$ Knife cookbook show de démarrage 0.3.0 modèles

pour retourner quelque chose comme :

checksum: a29d6f254577b830091f140c3a78b1fe
nom : chef-démarrage.txt.erb
chemin : templates/default/chef-getting-started.txt.erb
spécificité : par défaut
URL : https://someurlhere.com

Pour afficher les informations au format JSON, utilisez le -F option commune dans le cadre de la commande comme
ce:

$ couteau rôle show devops -F json

Les autres formats disponibles incluent texte, yamlet pp.

TEST

La tester L'argument est utilisé pour tester un livre de recettes pour les erreurs de syntaxe. Cet argument utilise Ruby
vérification de la syntaxe pour vérifier chaque fichier d'un livre de recettes qui se termine par .rb et Embedded Ruby
(ERB). Cet argument respectera les fichiers .chefignore lors de la détermination des livres de cuisine à
tester les erreurs de syntaxe.

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau livre de cuisine test COOKBOOK_NAME (options)

Options

Cet argument a les options suivantes :

-une, --tout
Utilisez pour tester tous les livres de cuisine.

-o CHEMIN:CHEMIN, --cookbook-chemin CHEMIN:CHEMIN
Le répertoire dans lequel les livres de cuisine sont créés. Cela peut être un chemin séparé par des deux-points.

Exemples

$ couteau livre de cuisine test cookbook_name

TÉLÉCHARGER

La télécharger est utilisé pour télécharger un ou plusieurs livres de cuisine (et tous les fichiers qui sont
associés à ces livres de recettes) d'un référentiel local vers le serveur Chef. Seuls les fichiers
qui n'existent pas déjà sur le serveur Chef seront téléchargés.

REMARQUE:
Utilisez un fichier .chefignore pour empêcher le téléchargement de fichiers et de types de fichiers spécifiques, tels que
les fichiers temporaires ou les fichiers placés dans des dossiers par les systèmes de contrôle de version. Le .chefignore
doit être situé à la racine du référentiel de livres de recettes et doit utiliser des règles similaires
au globbing de nom de fichier (tel que défini par le Ruby Fichier.fnmatch syntaxe).

REMARQUE:
Les répertoires vides ne sont pas téléchargés sur le serveur Chef. Pour télécharger un répertoire vide,
créer un fichier "dot" --- par exemple .garder---dans ce répertoire pour s'assurer que le répertoire
lui-même n'est pas vide.

Syntaxe

Cet argument a la syntaxe suivante :

$ télécharger le livre de cuisine du couteau [COOKBOOK_NAME...] (options)

Options

Cet argument a les options suivantes :

-une, --tout
Utilisez pour télécharger tous les livres de cuisine.

--concurrence
Le nombre de connexions simultanées autorisées. Défaut: 10.

-ré, --include-dépendances
Utilisez pour s'assurer que lorsqu'un livre de cuisine a une dépendance sur un (ou plusieurs) livres de cuisine,
ces livres de cuisine seront également téléchargés.

-E ENVIRONNEMENT, --environnement ENVIRONNEMENT
Utilisez pour définir la dépendance de la version de l'environnement à la version du livre de recettes en cours
téléchargé.

--Obliger
Utilisez pour mettre à jour un livre de recettes même si le --Geler le drapeau a été placé.

--Geler
Utilisez pour exiger que les modifications apportées à un livre de cuisine soient incluses en tant que nouvelle version. Seulement le --Obliger
L'option peut remplacer ce paramètre.

-o CHEMIN:CHEMIN, --cookbook-chemin CHEMIN:CHEMIN
Le répertoire dans lequel les livres de cuisine sont créés. Cela peut être un chemin séparé par des deux-points.

Exemples

$ couteau livre de cuisine télécharger cookbook_name

Pour télécharger un livre de recettes, puis empêcher d'autres utilisateurs d'y apporter des modifications,
entrer:

$ couteau livre de cuisine télécharger redis --freeze

pour retourner quelque chose comme :

Téléchargement de la redis...
Téléchargement terminé

Si un livre de cuisine est congelé et que le --Obliger option n'est pas spécifiée, le couteau renverra un
message d'erreur semblable au suivant :

Téléchargement de la redis...
ERREUR : la version 0.1.6 du livre de recettes redis est gelée. Utilisez --force pour remplacer.

Utilisez le livre de cuisine en ligne en utilisant les services onworks.net