Descobrindo Kyma

Definindo e configurando Kubectl para Kyma

Objective

After completing this lesson, you will be able to instalar e configurar kubectl para Kyma

Configurando Kubectl para Kyma

Cenário de utilização

Você criou com êxito uma instância de tempo de execução Kyma. Agora, você quer interagir com ele e aprender como usar a interface de linha de comando kubectl (CLI) para gerenciar seus recursos. Mas primeiro, você precisa saber como configurar o kubectl CLI para se conectar ao seu tempo de execução Kyma, especialmente porque o tempo de execução Kyma requer um plugin especial de kubectl para o processo de autenticação.

Fluxo de tarefas

Neste exercício, você realizará as seguintes etapas:

  1. Instale o kubectl CLI.
  2. Instale o plug-in kubelogin.
  3. Configure a CLI kubectl para se conectar à sua instância de tempo de execução Kyma.
  4. Interaja com sua instância de tempo de execução Kyma usando kubectl.

Tarefa 1: Instalar o Kubectl CLI

Pré-requisitos

Você criou com êxito uma instância de tempo de execução Kyma na subconta SAP BTP.

Etapas

  1. Instale o Kubectl CLI.

    1. Siga a documentação oficial para instalar o kubectl CLI.

    2. Para verificar se o kubectl CLI está instalado corretamente, execute o seguinte comando no seu terminal ou linha de comando:

      Code Snippet
      1
      kubectl version --client

      Se a instalação tiver sido bem-sucedida, você verá as versões client e Kustomize como uma saída.

  2. Instale o plug-in Kubelogin.

    O tempo de execução do Kyma requer um plug-in especial chamado kubelogin para que o CLI do kubectl se conecte à sua instância de tempo de execução do Kyma.

    1. Siga a documentação oficial para instalar o plugin kubelogin.

    2. Para verificar se o plug-in kubelogin está instalado corretamente, execute o seguinte comando em seu terminal ou linha de comando:

      Code Snippet
      1
      kubectl version --client

      Se a instalação tiver sido bem-sucedida, você verá as versões de plug-in cliente e kubelogin como uma saída.

Tarefa 2: Conecte-se à sua instância de tempo de execução Kyma.

Como já mencionado, o kubectl depende do arquivo kubeconfig, que normalmente está localizado no diretório ~/.kube (macOS/Linux) ou %USERPROFILE%\.kube (Windows).

Etapas

  1. Vá para sua página de síntese da subconta do SAP BTP.

  2. Selecione o link para o KubeconfigURL para baixar o arquivo kubeconfig.yaml para sua instância de tempo de execução Kyma.

    KubeconfigURL
  3. No terminal, exporte a localização do seu arquivo kubeconfig como uma variável de ambiente.

    Para MacOS/Linux:

    Code Snippet
    1
    export KUBECONFIG={KUBECONFIG_FILE_PATH}

    Para Windows:

    Code Snippet
    1
    $ENV:KUBECONFIG="{KUBECONFIG_FILE_PATH}"

    Nota

    O arquivo kubeconfig contém credenciais para acessar sua instância de tempo de execução Kyma. Portanto, é importante mantê-la segura.

  4. Para verificar se o arquivo kubeconfig está configurado corretamente, execute o seguinte comando em seu terminal ou linha de comando:

    Code Snippet
    1
    kubectl cluster-info

    Se tiver êxito, você vê a seguinte saída:

    Saída de terminal mostrando o resultado do comando kubectl cluster-info. Ele exibe o plano de controle do Kubernetes e o CoreDNS em execução em URLs específicos, com uma sugestão para usar o dump kubectl cluster-info para depuração.

Tarefa 3: Acessar recursos em seu tempo de execução Kyma

Agora é hora de usar alguns comandos kubectl para interagir com sua instância de tempo de execução Kyma. Lembre-se de que tudo definido no Kubernetes pode ser acessado usando a API RESTful Kubernetes.

Cada comando kubectl deve especificar o namespace e o tipo de objeto. Se nenhum espaço de nomes for indicado, kubectl assume o espaço de nomes padrão. O tipo de objeto é o nome do tipo de recurso, como Pods ou Deployments. O nome do objeto é o nome do recurso, como my-pod ou my-deployment.

A sintaxe kubectl é a seguinte:

kubectl [command] [TYPE] [NAME] [flags]

Etapas

  1. Listar objetos.

    Para listar objetos, você pode usar o comando get. O comando get lista um ou mais recursos.

    1. Para listar todos os pods em todos os espaços de nomes, use o seguinte comando:

      Code Snippet
      1
      kubectl get all --all-namespaces
    2. Para listar todos os pods em um espaço de nomes específico, você pode usar o seguinte comando:

      Code Snippet
      1
      kubectl get pods --namespace my-namespace

      Dica

      O código --namespace é opcional. Se você não indicar um espaço de nomes, é usado o espaço de nomes padrão. No entanto, você também pode indicar o espaço de nomes no arquivo kubeconfig ou criar diferentes contextos para diferentes espaços de nomes, que você pode alternar ou definir seu espaço de nomes personalizado como padrão. Leia mais sobre contextos na documentação oficial do Kubernetes.

    3. Experimente alguns outros exemplos do comando get, que lista recursos de um tipo especificado no espaço de nomes padrão:

      Code Snippet
      1
      kubectl get pods
      Code Snippet
      1
      kubectl get services
      Code Snippet
      1
      kubectl get replicasets
      Code Snippet
      1
      kubectl get deployments
      Code Snippet
      1
      kubectl get nodes
  2. Criar objetos.

    1. Crie um novo espaço de nomes:

      Code Snippet
      1
      kubectl create namespace my-namespace
    2. Crie um Pod em seu espaço de nomes recém-criado:

      Code Snippet
      12345678910
      cat <<EOF | kubectl -n my-namespace apply -f - apiVersion: v1 kind: Pod metadata: name: my-pod spec: containers: - name: my-container image: nginx:1.21.3 EOF
    3. O comando create também pode criar um objeto Kubernetes a partir de um arquivo YAML ou JSON. Por exemplo, você pode definir um Pod em um arquivo YAML e criá-lo usando este comando:

      Code Snippet
      1
      kubectl create -f my-pod.yaml

      O código -f é a abreviatura de --filename. Especifica o caminho para o arquivo YAML ou JSON que contém a definição de objeto.

    4. A terceira abordagem é criar objetos a partir de um URL. Por exemplo, você pode usar este comando:

      Code Snippet
      1
      kubectl create -f https://raw.githubusercontent.com/SAP-samples/kyma-runtime-learning-journey/main/unit_1/my-pod.yaml

      Nota

      Se você executar o comando create duas vezes com a mesma definição de objeto, isso gerará um erro. Para evitar isso, use o comando apply.

  3. Atualizar objetos.

    Para atualizar objetos, você pode usar o comando apply. O comando apply atualiza um objeto Kubernetes de um arquivo YAML ou JSON. Por exemplo, para atualizar um Pod, você pode usar o seguinte comando:

    Code Snippet
    1
    kubectl apply -f my-pod.yaml

    Durante uma operação de aplicação, o servidor API Kubernetes compara a definição de objeto no arquivo YAML ou JSON com o estado atual do objeto no cluster. Se existirem diferenças, o objeto é atualizado.

  4. Descrever objetos.

    Para descrever objetos, você pode usar o comando describe, que exibe informações detalhadas sobre um objeto Kubernetes.

    1. Por exemplo, para descrever um Pod, você pode usar o seguinte comando:

      Code Snippet
      1
      kubectl describe pod my-pod
    1. Você pode até exportar a saída do comando describe para um arquivo YAML ou JSON. Por exemplo, para exportar a saída do comando describe para um arquivo YAML, você pode usar o seguinte comando:

      Code Snippet
      1
      kubectl describe pod my-pod -o yaml > my-pod.yaml
  5. Identificar objetos.

    Para rotular objetos, você pode usar o comando label. O comando label adiciona ou atualiza rótulos em um objeto Kubernetes. Por exemplo, para adicionar uma etiqueta a um Pod, você pode usar o seguinte comando:

    Code Snippet
    1
    kubectl label pod my-pod my-label=my-value
  6. Excluir objetos.

    1. Para excluir objetos, você pode usar o comando delete. Por exemplo, para excluir um Pod, execute:

      Code Snippet
      1
      kubectl delete pod my-pod
    2. Para eliminar o espaço de nomes que você criou, execute:

      Code Snippet
      1
      kubectl delete namespace my-namespace
  7. Obter detalhes do cluster.

    1. Para recuperar informações de cluster, use o comando cluster-info. Ele exibe informações sobre o cluster.

      Code Snippet
      1
      kubectl cluster-info
    2. Para recuperar informações de utilização de recursos para nós e pods, use o comando top.

      Code Snippet
      1
      kubectl top nodes
      Code Snippet
      1
      kubectl top pods
  8. Para obter uma lista completa de todos os comandos disponíveis, você pode usar o comando help.

    Code Snippet
    1
    kubectl help

Resultado

Você instalou com êxito a CLI kubectl e a configurou para se conectar à sua instância de tempo de execução Kyma. Você pode usar os comandos kubectl básicos para interagir com ele.