Este é o cliente de faca de comando que pode ser executado no provedor de hospedagem gratuita OnWorks usando uma de nossas várias estações de trabalho online gratuitas, como Ubuntu Online, Fedora Online, emulador online do Windows ou emulador online do MAC OS
PROGRAMA:
NOME
Knife-client - A página man para o subcomando do cliente do Knife.
Cada solicitação feita pelo chef-cliente ao servidor Chef deve ser uma solicitação autenticada
usando a API do servidor Chef e uma chave privada. Quando o chef-cliente faz um pedido ao
Servidor Chef, o chef-cliente autentica cada solicitação usando uma chave privada localizada em
/etc/chef/client.pem.
No entanto, durante a primeira execução chef-client, essa chave privada não existe. Em vez disso, o
chef-cliente tentará usar a chave privada atribuída ao chef-validador, localizado em
/etc/chef/validation.pem. (Se, por qualquer motivo, o chef-validador não for capaz de fazer um
solicitação autenticada ao servidor Chef, a execução inicial do chef-cliente falhará.)
Durante a execução inicial do chef-cliente, o chef-cliente se registrará no servidor Chef
usando a chave privada atribuída ao validador do chef, após o qual o cliente do chef irá
obter um cliente.pem chave privada para todas as solicitações de autenticação futuras para o servidor Chef.
Depois que a execução inicial do chef-cliente foi concluída com êxito, o chef-validador não
mais necessário e pode ser excluído do nó. Use o exclusão_validação receita encontrada
no chef-cliente livro de receitas (https://github.com/opscode-cookbooks/chef-client) remover
o chef-validador.
A faca cliente subcomando é usado para gerenciar uma lista de clientes API e seu RSA associado
pares de chaves públicas. Isso permite que as solicitações de autenticação sejam feitas ao servidor Chef por qualquer
entidade que usa a API do servidor Chef, como o chef-cliente e a faca.
COMUM OPÇÕES
As seguintes opções podem ser usadas com qualquer um dos argumentos disponíveis para o faca cliente
subcomando:
--chef-zero-porta PORT
A porta na qual o chef-zero ouvirá.
-c CONFIG_FILE, --config Config_file.
O arquivo de configuração a ser usado.
-d, --disable-edition
Use para evitar que $ EDITOR seja aberto e para aceitar os dados como estão.
--padrão
Use para que a faca use o valor padrão em vez de pedir a um usuário para fornecer um.
-e EDITOR, --editor EDITOR
O $ EDITOR que é usado para todos os comandos interativos.
-E AMBIENTE, --ambiente MEIO AMBIENTE
O nome do ambiente. Quando esta opção é adicionada a um comando, o comando
será executado apenas no ambiente nomeado.
-F FORMATO, --formato FORMATO
O formato de saída: resumo (Padrão) texto, json, yaml e pp.
-h, --Socorro
Mostra ajuda para o comando.
-k CHAVE, --chave KEY
A chave privada que a faca usará para assinar as solicitações feitas pelo cliente API para o
Servidor do Chef.
- [sem-] cor
Use para ver a saída colorida.
--imprimir-depois
Use para mostrar dados após uma operação destrutiva.
-s Url, --servidor-url URL
O URL do servidor Chef.
-u DO UTILIZADOR, --do utilizador USUÁRIO
O nome de usuário usado por faca para assinar solicitações feitas pelo cliente API para o Chef
servidor. A autenticação falhará se o nome do usuário não corresponder à chave privada.
-V, --verbose
Defina para saídas mais detalhadas. Usar -VV para o máximo de verbosidade.
-dentro, --versão
A versão do chef-cliente.
- sim, --sim
Use para responder a todos os prompts de confirmação com "Sim". faca não vai pedir
confirmação.
-z, --modo local
Use para executar o chef-cliente no modo local. Isso permite que todos os comandos que funcionam
contra o servidor Chef para também trabalhar contra o chef-repo local.
BULK EXCLUIR
A massa excluir argumento é usado para excluir qualquer cliente API que corresponda a um padrão definido
por uma expressão regular. A expressão regular deve estar entre aspas e não
cercado por barras (/).
Sintaxe
Este argumento possui a seguinte sintaxe:
cliente $ knife deletar em massa REGEX
Opções
Este comando não possui opções específicas.
CRIAR
A crio argumento é usado para criar um novo cliente API. Este processo irá gerar um RSA
par de chaves para o cliente API nomeado. A chave pública será armazenada no servidor Chef e
a chave privada será exibida em STDOUT ou gravado em um arquivo nomeado.
· Para o chef-cliente, a chave privada deve ser copiada para o sistema como
/etc/chef/client.pem.
· Para faca, a chave privada é normalmente copiada para ~ / .chef / client_name.pem e referenciado
no arquivo de configuração knife.rb.
Sintaxe
Este argumento possui a seguinte sintaxe:
Cliente $ Knife criar CLIENT_NAME (opções)
Opções
Este argumento possui as seguintes opções:
-uma, --admin
Use para criar um cliente como um cliente administrativo. Isso é necessário para qualquer usuário acessar
Open Source Chef como administrador. Esta opção só funciona quando usada com o
servidor Chef de código aberto e não terá efeito quando usado com o Enterprise Chef.
-f ARQUIVO, --Arquivo ARQUIVO
Use para salvar uma chave privada com o nome de arquivo especificado.
--validador
Use para criar o cliente como o chef-validador. Valor padrão: verdadeiro.
Exemplos
Para criar um chef-cliente que pode acessar a API Chef Server como um
administrador --- às vezes referido como um "cliente chef de API" --- com o nome "exampleorg"
e salve sua chave privada em um arquivo, digite:
$ knife client create exampleorg -a -f "/etc/chef/client.pem"
Ao executar o crio argumento no Enterprise Chef, certifique-se de omitir o -a opção:
$ knife client create exampleorg -f "/etc/chef/client.pem"
EXCLUIR
A excluir argumento é usado para excluir um cliente API registrado.
Sintaxe
Este argumento possui a seguinte sintaxe:
cliente $ Knife deletar CLIENT_NAME
Opções
Este comando não possui opções específicas.
Exemplos
Para excluir um cliente com o nome "client_foo", digite:
$ Knife cliente deletar client_foo
Formato Y para confirmar uma exclusão.
EDITAR
A editar O argumento é usado para editar os detalhes de um cliente API registrado. Quando isso
argumento for executado, o knife abrirá $ EDITOR para permitir a edição do admin atributo. (Nenhum
dos outros atributos devem ser alterados usando este argumento.) Quando terminar, a faca irá
atualize o servidor Chef com essas mudanças.
Sintaxe
Este argumento possui a seguinte sintaxe:
Cliente $ Knife editar CLIENT_NAME
Opções
Este comando não possui opções específicas.
Exemplos
Para editar um cliente com o nome "exampleorg", digite:
cliente $ knife editar exampleorg
LISTA
A Lista O argumento é usado para visualizar uma lista de clientes API registrados.
Sintaxe
Este argumento possui a seguinte sintaxe:
lista de clientes $ Knife (opções)
Opções
Este argumento possui as seguintes opções:
-C, --com-uri
Use para mostrar os URIs correspondentes.
Exemplos
Para verificar a lista de clientes da API para o servidor Chef, digite:
lista de clientes $ Knife
para retornar algo semelhante a:
exemploorg
i-12345678
rs-123456
Para verificar se um cliente API pode se autenticar no servidor Chef corretamente, tente obter um
lista de clientes usando -u e -k opções para especificar seu nome e chave privada:
$ Knife lista de clientes -u ORGNAME -k .chef / ORGNAME.pem
REGISTRAR
A registrar-se novamente O argumento é usado para gerar novamente um par de chaves RSA para um cliente API. o
a chave pública será armazenada no servidor Chef e a chave privada será exibida no
STDOUT ou gravado em um arquivo nomeado.
OBSERVAÇÃO:
Executar este argumento invalidará o par de chaves RSA anterior, tornando-o inutilizável
durante a autenticação no servidor Chef.
Sintaxe
Este argumento possui a seguinte sintaxe:
Cliente $ knife registre novamente CLIENT_NAME (opções)
Opções
Este argumento possui as seguintes opções:
-f NOME DO ARQUIVO, --Arquivo NOME DO ARQUIVO
Use para salvar uma chave privada com o nome de arquivo especificado.
Exemplos
Para regenerar o par de chaves RSA para um cliente chamado "testclient" e salvá-lo em um arquivo chamado
"rsa_key", digite:
$ faca cliente regenerar testclient -f rsa_key
MOSTRA
A mostrar O argumento é usado para mostrar os detalhes de um cliente API.
Sintaxe
Este argumento possui a seguinte sintaxe:
Cliente $ Knife mostrar CLIENT_NAME (opções)
Opções
Este argumento possui as seguintes opções:
-a ATTR, --atributo ATTR
O atributo (ou atributos) a serem mostrados.
Exemplos
Para visualizar um cliente chamado "testclient", digite:
cliente $ knife show testclient
para retornar algo como:
admin: falso
chef_type: cliente
json_class: Chef :: ApiClient
nome: testclient
chave pública:
Para visualizar as informações no formato JSON, use o -F opção comum como parte do comando como
esta:
papel de $ knife show devops -F json
Outros formatos disponíveis incluem texto, yaml e pp.
Use o cliente da faca online usando os serviços onworks.net