From 6a9e5be461259f5a467564d96a92dd6d05802f54 Mon Sep 17 00:00:00 2001 From: Felipe Date: Thu, 26 Mar 2020 11:52:25 +0000 Subject: [PATCH] Adding content/pt/docs/reference/cheatsheet (#19631) * Adding content/pt/docs/reference/cheatsheet * Adding content/pt/docs/reference/cheatsheet * Adding content/pt/docs/reference/cheatsheet * Adding content/pt/docs/reference/index * Adding content/pt/docs/reference/index reference * Adjusting cheatsheet translations * Adjusting cheatsheet translations * removing reference index * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Diego W. Antunes * adjusting auto complete Co-Authored-By: Diego W. Antunes * Fixing typo Co-Authored-By: Diego W. Antunes * Change aplicativos to aplicaoes Co-Authored-By: Diego W. Antunes * Adjusting text Co-Authored-By: Diego W. Antunes * fix namespace Co-Authored-By: Diego W. Antunes * fix translation Co-Authored-By: Diego W. Antunes * Adding missing command * apply commit Review suggestion Co-Authored-By: Diego W. Antunes * apply commit Review suggestion Co-Authored-By: Diego W. Antunes * Apply Review suggestion Co-Authored-By: Diego W. Antunes * Apply Review suggestion Co-Authored-By: Diego W. Antunes * Apply Review suggestion Co-Authored-By: Diego W. Antunes * Apply Review suggestion Co-Authored-By: Diego W. Antunes * Apply Review suggestion Co-Authored-By: Diego W. Antunes * Addressing PR comments * Add PR suggestion Co-Authored-By: Jhon Mike * Add PR suggestion Co-Authored-By: Jhon Mike * Add PR suggestion Co-Authored-By: Jhon Mike * Add Title in CamelCase Co-Authored-By: Jhon Mike * Add Title in CamelCase Co-Authored-By: Jhon Mike * Adjusting translation Co-Authored-By: Jhon Mike * Adjust translation Co-Authored-By: Jhon Mike * Adjust translation Co-Authored-By: Jhon Mike * Adjust translation deployment Co-Authored-By: Jhon Mike * Adjust translation deployment Co-Authored-By: Jhon Mike * Clean up Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up translation Co-Authored-By: Jhon Mike * Clean up Co-Authored-By: Diego W. Antunes * clean up Co-Authored-By: Diego W. Antunes * Adjust translation * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Diego W. Antunes * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Diego W. Antunes * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Diego W. Antunes * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * Update content/pt/docs/reference/kubectl/cheatsheet.md Co-Authored-By: Jhon Mike * removing unused line Co-authored-by: Diego W. Antunes Co-authored-by: Jhon Mike --- content/pt/docs/reference/kubectl/_index.md | 5 + .../pt/docs/reference/kubectl/cheatsheet.md | 390 ++++++++++++++++++ 2 files changed, 395 insertions(+) create mode 100644 content/pt/docs/reference/kubectl/_index.md create mode 100644 content/pt/docs/reference/kubectl/cheatsheet.md diff --git a/content/pt/docs/reference/kubectl/_index.md b/content/pt/docs/reference/kubectl/_index.md new file mode 100644 index 0000000000..7b6c2d720b --- /dev/null +++ b/content/pt/docs/reference/kubectl/_index.md @@ -0,0 +1,5 @@ +--- +title: "kubectl CLI" +weight: 60 +--- + diff --git a/content/pt/docs/reference/kubectl/cheatsheet.md b/content/pt/docs/reference/kubectl/cheatsheet.md new file mode 100644 index 0000000000..9cdf34dc37 --- /dev/null +++ b/content/pt/docs/reference/kubectl/cheatsheet.md @@ -0,0 +1,390 @@ +--- +title: kubectl Cheat Sheet +reviewers: +- erictune +- krousey +- clove +content_template: templates/concept +card: + name: reference + weight: 30 +--- + +{{% capture overview %}} + +Veja também: [Visão geral do Kubectl](/docs/reference/kubectl/overview/) e [JsonPath Guide](/docs/reference/kubectl/jsonpath). + +Esta página é uma visão geral do comando `kubectl`. + +{{% /capture %}} + +{{% capture body %}} + +# kubectl - Cheat Sheet + +## Kubectl Autocomplete + +### BASH + +```bash +source <(kubectl completion bash) # configuração de autocomplete no bash do shell atual, o pacote bash-completion precisa ter sido instalado primeiro. +echo "source <(kubectl completion bash)" >> ~/.bashrc # para adicionar o autocomplete permanentemente no seu shell bash. +``` + +Você também pode usar uma abreviação para o atalho para `kubectl` que também funciona com o auto completar: + +```bash +alias k=kubectl +complete -F __start_kubectl k +``` + +### ZSH + +```bash +source <(kubectl completion zsh) # configuração para usar autocomplete no terminal zsh no shell atual +echo "if [ $commands[kubectl] ]; then source <(kubectl completion zsh); fi" >> ~/.zshrc # adicionar auto completar permanentemente para o seu shell zsh +``` + +## Contexto e Configuração do Kubectl + +Defina com qual cluster Kubernetes o `kubectl` se comunica e modifique os detalhes da configuração. +Veja a documentação [Autenticando entre clusters com o kubeconfig](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/) para +informações detalhadas do arquivo de configuração. + +```bash +kubectl config view # Mostrar configurações do kubeconfig mergeadas. + +# use vários arquivos kubeconfig ao mesmo tempo e visualize a configuração mergeada +KUBECONFIG=~/.kube/config:~/.kube/kubconfig2 + +kubectl config view + +# obtenha a senha para o usuário e2e +kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}' + +kubectl config view -o jsonpath='{.users[].name}' # exibir o primeiro usuário +kubectl config view -o jsonpath='{.users[*].name}' # obtenha uma lista de usuários +kubectl config get-contexts # exibir lista de contextos +kubectl config current-context # exibir o contexto atual +kubectl config use-context my-cluster-name # defina o contexto padrão como my-cluster-name + +# adicione um novo cluster ao seu kubeconfig que suporte autenticação básica +kubectl config set-credentials kubeuser/foo.kubernetes.com --username=kubeuser --password=kubepassword + +# salve o namespace permanentemente para todos os comandos subsequentes do kubectl nesse contexto. +kubectl config set-context --current --namespace=ggckad-s2 + +# defina um contexto utilizando um nome de usuário e o namespace. +kubectl config set-context gce --user=cluster-admin --namespace=foo \ + && kubectl config use-context gce + +kubectl config unset users.foo # excluir usuário foo +``` + +## Aplicar +`apply` gerencia aplicações através de arquivos que definem os recursos do Kubernetes. Ele cria e atualiza recursos em um cluster através da execução `kubectl apply`. +Esta é a maneira recomendada de gerenciar aplicações Kubernetes em ambiente de produção. Veja a [documentação do Kubectl](https://kubectl.docs.kubernetes.io). + +## Criando objetos + +Manifestos Kubernetes podem ser definidos em YAML ou JSON. A extensão de arquivo `.yaml`, +`.yml`, e `.json` pode ser usado. + +```bash +kubectl apply -f ./my-manifest.yaml # criar recurso(s) +kubectl apply -f ./my1.yaml -f ./my2.yaml # criar a partir de vários arquivos +kubectl apply -f ./dir # criar recurso(s) em todos os arquivos de manifesto no diretório +kubectl apply -f https://git.io/vPieo # criar recurso(s) a partir de URL +kubectl create deployment nginx --image=nginx # iniciar uma única instância do nginx +kubectl explain pods,svc # obtenha a documentação de manifesto do pod + +# Crie vários objetos YAML a partir de stdin +cat < pod.yaml + +kubectl attach my-pod -i # Anexar ao contêiner em execução +kubectl port-forward my-pod 5000:6000 # Ouça na porta 5000 na máquina local e encaminhe para a porta 6000 no my-pod +kubectl exec my-pod -- ls / # Executar comando no pod existente (1 contêiner) +kubectl exec my-pod -c my-container -- ls / # Executar comando no pod existente (pod com vários contêineres) +kubectl top pod POD_NAME --containers # Mostrar métricas para um determinado pod e seus contêineres +``` + +## Interagindo com Nós e Cluster + +```bash +kubectl cordon my-node # Marcar o nó my-node como não agendável +kubectl drain my-node # Drene o nó my-node na preparação para manutenção +kubectl uncordon my-node # Marcar nó my-node como agendável +kubectl top node my-node # Mostrar métricas para um determinado nó +kubectl cluster-info # Exibir endereços da master e serviços +kubectl cluster-info dump # Despejar o estado atual do cluster no stdout +kubectl cluster-info dump --output-directory=/path/to/cluster-state # Despejar o estado atual do cluster em /path/to/cluster-state + +# Se uma `taint` com essa chave e efeito já existir, seu valor será substituído conforme especificado. +kubectl taint nodes foo dedicated=special-user:NoSchedule +``` + +### Tipos de Recursos + +Listar todos os tipos de recursos suportados, juntamente com seus nomes abreviados, [Grupo de API](/docs/concepts/overview/kubernetes-api/#api-groups), se eles são por [namespaces](/docs/concepts/overview/working-with-objects/namespaces), e [objetos](/docs/concepts/overview/working-with-objects/kubernetes-objects): + +```bash +kubectl api-resources +``` + +Outras operações para explorar os recursos da API: + +```bash +kubectl api-resources --namespaced=true # Todos os recursos com namespace +kubectl api-resources --namespaced=false # Todos os recursos sem namespace +kubectl api-resources -o name # Todos os recursos com saída simples (apenas o nome do recurso) +kubectl api-resources -o wide # Todos os recursos com saída expandida (também conhecida como "ampla") +kubectl api-resources --verbs=list,get # Todos os recursos que suportam os verbos de API "list" e "get" +kubectl api-resources --api-group=extensions # Todos os recursos no grupo de API "extensions" +``` + +### Formatação de Saída + +Para enviar detalhes para a janela do terminal em um formato específico, adicione a flag `-o` (ou `--output`) para um comando `kubectl` suportado. + +Formato de saída | Descrição +--------------| ----------- +`-o=custom-columns=` | Imprimir uma tabela usando uma lista separada por vírgula de colunas personalizadas +`-o=custom-columns-file=` | Imprima uma tabela usando o modelo de colunas personalizadas no arquivo `` +`-o=json` | Saída de um objeto de API formatado em JSON +`-o=jsonpath=