couteau-client - En ligne dans le Cloud

PROGRAMME:

Nom

Knife-client - La page de manuel de la sous-commande client Knife.

Chaque requête faite par le chef-client au serveur Chef doit être une requête authentifiée
en utilisant l'API du serveur Chef et une clé privée. Lorsque le chef-client fait une demande au
Serveur Chef, le chef-client authentifie chaque requête à l'aide d'une clé privée située dans
/etc/chef/client.pem.

Cependant, lors de la première exécution chef-client, cette clé privée n'existe pas. Au lieu de cela, le
chef-client tentera d'utiliser la clé privée attribuée au chef-validateur, située dans
/etc/chef/validation.pem. (Si, pour une raison quelconque, le chef-validateur n'est pas en mesure de faire une
demande authentifiée au serveur Chef, l'exécution initiale du client chef échouera.)

Lors de l'exécution initiale du chef-client, le chef-client s'enregistrera auprès du serveur Chef
à l'aide de la clé privée attribuée au chef-validateur, après quoi le chef-client
obtenir un client.pem clé privée pour toutes les futures demandes d'authentification au serveur Chef.

Une fois l'exécution initiale du chef-client terminée avec succès, le chef-validateur n'est plus
n'est plus nécessaire et peut être supprimé du nœud. Utilisez le supprimer_validation recette trouvée
dans le chef-client livre de recettes (https://github.com/opscode-cookbooks/chef-client) retirer
le chef-validateur.

Le couteau client la sous-commande est utilisée pour gérer une liste de clients API et leur RSA associé
paires de clés publiques. Cela permet aux demandes d'authentification d'être adressées au serveur Chef par n'importe quel
entité qui utilise l'API du serveur Chef, comme le chef-client et le couteau.

COMMUNE OPTIONS

Les options suivantes peuvent être utilisées avec n'importe lequel des arguments disponibles pour le couteau client
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 : Sommaire (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

Le masse delete l'argument est utilisé pour supprimer tout client API qui correspond à 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é de barres obliques (/).

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau client supprimer en bloc REGEX

Options

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

CREATE

Le créer des L'argument est utilisé pour créer un nouveau client API. Ce processus générera un RSA
paire de clés pour le client API nommé. La clé publique sera stockée sur le serveur Chef et
la clé privée sera affichée sur SORTIE STD ou écrit dans un fichier nommé.

· Pour le chef-client, la clé privée doit être copiée dans le système comme
/etc/chef/client.pem.

· Pour le couteau, la clé privée est généralement copiée dans ~/.chef/nom_client.pem et référencé
dans le fichier de configuration knife.rb.

Syntaxe

Cet argument a la syntaxe suivante :

$ Knife client crée CLIENT_NAME (options)

Options

Cet argument a les options suivantes :

-une, --administrateur
Utilisez pour créer un client en tant que client administrateur. Ceci est requis pour que tout utilisateur puisse accéder
Open Source Chef en tant qu'administrateur. Cette option ne fonctionne que lorsqu'elle est utilisée avec le
serveur Chef open source et n'aura aucun effet lorsqu'il est utilisé avec Enterprise Chef.

-f DÉPOSER, --déposer DOSSIER
Utilisez pour enregistrer une clé privée dans le nom de fichier spécifié.

--validateur
Utilisez pour créer le client en tant que chef-validateur. Valeur par défaut: oui.

Exemples

Pour créer un chef-client qui peut accéder à l'API du serveur Chef en tant que
administrateur --- parfois appelé "API chef-client" --- avec le nom "exampleorg"
et enregistrez sa clé privée dans un fichier, saisissez :

$ knife client create exampleorg -a -f "/etc/chef/client.pem"

Lors de l'exécution du créer des argument sur Enterprise Chef, veillez à omettre le -a option:

$ knife client create exampleorg -f "/etc/chef/client.pem"

EFFACER

Le delete L'argument est utilisé pour supprimer un client API enregistré.

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau client supprimer CLIENT_NAME

Options

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

Exemples

Pour supprimer un client portant le nom "client_foo", saisissez :

$ couteau client supprimer client_foo

Type Y pour confirmer une suppression.

EDIT

Le éditer L'argument est utilisé pour modifier les détails d'un client API enregistré. Quand ce
l'argument est exécuté, le couteau ouvrira $EDITOR pour permettre l'édition du admin attribut. (Rien
des autres attributs doivent être modifiés à l'aide de cet argument.) Une fois terminé, le couteau
mettre à jour le serveur Chef avec ces modifications.

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau client modifier CLIENT_NAME

Options

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

Exemples

Pour modifier un client portant le nom "exampleorg", saisissez :

$ couteau client modifier exampleorg

LISTE

Le liste L'argument est utilisé pour afficher une liste des clients API enregistrés.

Syntaxe

Cet argument a la syntaxe suivante :

$ liste de clients couteau (options)

Options

Cet argument a les options suivantes :

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

Exemples

Pour vérifier la liste des clients API pour le serveur Chef, saisissez :

$ liste de clients couteau

pour retourner quelque chose de similaire à :

exempleorg
i-12345678
rs-123456

Pour vérifier qu'un client API peut s'authentifier correctement auprès du serveur Chef, essayez d'obtenir un
liste de clients utilisant -u et -k options pour spécifier son nom et sa clé privée :

$ couteau liste de clients -u ORGNAME -k .chef/ORGNAME.pem

RÉINSCRIPTION

Le réenregistrer L'argument est utilisé pour régénérer une paire de clés RSA pour un client API. Les
la clé publique sera stockée sur le serveur Chef et la clé privée sera affichée sur
SORTIE STD ou écrit dans un fichier nommé.

NOTE:
L'exécution de cet argument invalidera la paire de clés RSA précédente, la rendant inutilisable
lors de l'authentification auprès du serveur Chef.

Syntaxe

Cet argument a la syntaxe suivante :

$ couteau client réenregistrer CLIENT_NAME (options)

Options

Cet argument a les options suivantes :

-f NOM DE FICHIER, --déposer NOM DE FICHIER
Utilisez pour enregistrer une clé privée dans le nom de fichier spécifié.

Exemples

Pour régénérer la paire de clés RSA pour un client nommé "testclient" et l'enregistrer dans un fichier nommé
"clé_rsa", saisissez :

$ couteau client régénérer testclient -f rsa_key

SPECTACLES

Le montrer L'argument est utilisé pour afficher les détails d'un client API.

Syntaxe

Cet argument a la syntaxe suivante :

$ Knife client show CLIENT_NAME (options)

Options

Cet argument a les options suivantes :

-a ATTR, --attribut ATTR
L'attribut (ou les attributs) à afficher.

Exemples

Pour afficher un client nommé "testclient", saisissez :

$ couteau client montrer testclient

pour retourner quelque chose comme :

administrateur : faux
chef_type : client
json_class : Chef::ApiClient
nom : client de test
Clé publique:

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.

Utilisez Knife-client en ligne à l'aide des services onworks.net