Instalar os Pré-requisitos

Como os artefatos do Kubernetes necessários são implantados como gráficos Helm no Kubernetes para executar as pilhas, você precisa do kubectl, bem como do Helm, instalado. Além disso, você precisará da CLI (Interface de Linha de Comando) do Oracle Cloud Infrastructure, que é necessária para kubectl e será útil para outras tarefas.

Nesta etapa, você instalará estes componentes:
  1. A Interface de Linha de Comando do OCI.
  2. Se ainda não estiver presente, o kubectl versão 1.18 ou posterior.
  3. Helm 3.x.

Instalar a Interface de Linha de Comando do Oracle Cloud Infrastructure

Primeiro, você instalará a CLI (Command-line Interface) do Oracle Cloud Infrastructure.

  1. Para instalar a CLI do OCI no Linux ou no Mac OS X, execute o comando:
    bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

    Pressione Enter para aceitar os padrões de todas as opções.

  2. Reinicie o shell.
    exec -l $SHELL
  3. Reúna a Tenancy e os OCIDs do Usuário:
    1. Obtenha o OCID da tenancy na Console do Oracle Cloud clicando no ícone Usuário (canto superior direito) e, em seguida, em Tenancy. Copie o OCID da tenancy (campo Tenancy).
    2. Obtenha o OCID do Usuário na console clicando em Usuário e, em seguida, em Definições do Usuário. Em seguida, copie o OCID do usuário.
  4. Configurar a CLI do OCI.
    oci setup config
    Será solicitado para:
    • Local da configuração: pressione Enter.
    • user_ocid: digite o OCID do usuário.
    • tenancy_ocid: informe o OCID da sua tenancy.
    • region: informe sua região na lista fornecida.
    • Gerar um par de chaves RSA: pressione Enter para Sim (padrão).
    • Diretório de teclas: pressione Enter para obter o padrão.
    • Nome da chave: pressione Enter para o padrão.
    • Frase-senha: pressione Enter sem frase-senha.
    Você deverá ver uma saída como:
    Private key written to: /home/oracle/.oci/oci_api_key.pem
    Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
    Config written to ~/.oci/config
  5. Para usar a CLI, você precisa fazer upload da chave pública gerada para sua conta de usuário. Obtenha o conteúdo principal digitando:
    cat ~/.oci/oci_api_key_public.pem 

    Opcionalmente, você pode abrir o arquivo com seu editor preferido e copiar a saída impressa completa para a área de transferência.

  6. Na Console Web do OCI, adicione a chave gerada na etapa anterior:
    1. Em Usuário, clique em Definições do Usuário.
    2. Clique em Chaves de API.
    3. Clique em Adicionar Chave Pública.
    4. Clique em Colar Chave Pública.
    5. Cole a chave copiada acima.
    6. Clique em Adicionar.
    7. Verifique se a impressão digital gerada corresponde à saída da impressão digital da configuração.
  7. Teste sua CLI digitando:
    oci os ns get
    Esse comando deve gerar o namespace da sua tenancy (geralmente o nome da tenancy ou uma string randomizada); por exemplo:
    {
        "data": "your-tenancy-namespace"
    }
    

Instalar o kubectl

Em seguida, instale a ferramenta de linha de comando do Kubernetes, kubectl.

Observação:

Se você estiver usando o Docker Desktop no Mac OS X ou no Windows, o kubectl já deverá estar instalado e você poderá ignorar esta etapa.

A seguir, há um procedimento de alto nível para instalar o kubectl. Para obter instruções mais detalhadas específicas do seu sistema operacional, consulte "Install Tools" na documentação on-line do Kubernetes, listada no tópico "Antes de Começar".

  1. Para instalar o kubectl, execute este comando:
    PLATFORM=$(uname)
    curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
    chmod +x ./kubectl
    sudo mv ./kubectl /usr/local/bin/kubectl
    
    No Windows, use:
    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe
  2. Adicione o binário ao seu CAMINHO.
  3. Verifique se você está usando uma versão do kubectl que é 1.18 ou posterior informando:
    kubectl version --client

Instalar o Helm

Agora, você instalará a CLI do Helm.

Veja a seguir um procedimento de alto nível para instalar o Helm. Para obter instruções mais detalhadas específicas do seu sistema operacional, consulte "Instalando o Helm", listado no tópico "Antes de Começar".

Para instalar o helm no Mac OS X e Linux, digite:
curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Instalar o Terraform

Por fim, se ele ainda não estiver instalado, você precisará instalar o Terraform.

Observação:

Você encontrará links para a documentação de instalação referenciada neste tópico no tópico "Antes de Começar".
Se você estiver em uma máquina baseada em Linux ou no Mac OS X, recomendamos que instale o Terraform usando tfswitch, conforme descrito na documentação Install in tfswitch, pois permite fácil alternância entre as versões do Terraform. Se você instalou o tfswitch, selecione uma versão com:
tfswitch

Este manual foi testado com o Terraform versão 0.14.11

Caso contrário, se precisar de orientação para configurar o Terraform, visite a documentação de instalação do Terraform e selecione o caminho correspondente ao seu ambiente.