base on Uma maneira fácil de garantir seu próprio cluster Kubernetes gratuitamente e para sempre # Criando um Cluster Kubernetes na OCI utilizando OpenTofu [#MêsDoKubernetes](https://github.com/linuxtips/MesDoKubernetes) Crie uma conta gratuita na Oracle Cloud, e provisione um cluster Kubernetes utilizando o Terraform de forma simples e rápida. Acesse este [link e crie a sua conta](https://signup.cloud.oracle.com/) ### Pontos Importantes Antes de Começar - Devido limitações da conta gratuita, você provavelmente precisará realizar o [upgrade para uma conta](https://cloud.oracle.com/invoices-and-orders/upgrade-and-payment) `Pay As You Go` para conseguir criar o cluster utilizando as instâncias gratuitas `VM.Standard.A1.Flex`. Você não será cobrado pelo uso de recursos gratuitos mesmo após o upgrade. - Crie um alerta na sua conta para não ser cobrado por acidente [Budget](https://cloud.oracle.com/usage/budgets). - Não altere o shape da instância utilizada no cluster, pois a única instância gratuita compatível com o OKE é a `VM.Standard.A1.Flex`. ## Instalando o OpenTofu - GNU/Linux ```sh curl --proto '=https' --tlsv1.2 -fsSL https://get.opentofu.org/install-opentofu.sh -o install-opentofu.sh chmod +x install-opentofu.sh ./install-opentofu.sh --install-method deb rm install-opentofu.sh ``` - Windows ```powershell Invoke-WebRequest -outfile "install-opentofu.ps1" -uri "https://get.opentofu.org/install-opentofu.ps1" & .\install-opentofu.ps1 -installMethod standalone Remove-Item install-opentofu.ps1 ``` ## Instalando o OCI CLI - GNU/Linux 1. Execute o comando de instalação: ```sh bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" ``` 2. Quando solicitado para atualizar a variável PATH, digite `yes` e ele atualizará automaticamente o arquivo .bashrc ou .bash_profile. Se você utiliza um shell diferente, precisará informar o caminho para o OCI CLI (por exemplo, ~/zshrc). 3. Reinicie sua sessão no terminal. 4. Verifique a instalação. ```sh oci -v ``` - Windows 1. Faça download do instalador MSI da CLI do OCI para Windows no GitHub [Releases](https://github.com/oracle/oci-cli/releases) 2. Execute o instalador e siga as instruções. ## Instalando Kubectl - Kubernetes 1.28.2 - GNU/Linux Kubectl é quem faz a comunicação com a API Kubernetes usando CLI. Devemos usar a mesma versão que está explicita no arquivo de variáveis. Veja [variables.tf](variables.tf) 1. Baixando o binário kubectl ``` curl -LO https://dl.k8s.io/release/v1.28.2/bin/linux/amd64/kubectl ``` 2. Instalando o binário ``` sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl ``` 3. Adicione kubectl completion bash ``` echo ' source <(kubectl completion bash)' >> ~/.bashrc ``` 4. Valide a versão ``` kubectl version --client ``` - *Note: O comando acima irá gerar um aviso:* "WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short." **Você pode ignorar este aviso. Você está apenas verificando a versão do kubectl que instalou.** - Windows 1. Baixe o binário kubectl ``` curl.exe -LO "https://dl.k8s.io/release/v1.28.2/bin/windows/amd64/kubectl.exe" ``` 2. **Anexe a pasta binária kubectl à sua variável de ambiente PATH.** 3. Valide a versão ``` kubectl version --client --output=yaml ``` **🔗 [Guia de instalação para todos os ambientes](https://kubernetes.io/docs/tasks/tools/)** ## Autenticando na OCI 1. Antes de começar, clone o repositório. ```sh git clone https://github.com/Rapha-Borges/oke-free.git ``` 2. Crie uma `API key` - Entre no seu perfil, acesse a aba [API Keys](https://cloud.oracle.com/identity/domains/my-profile/api-keys) e clique em `Add API Key`. 3. Selecione `Generate API key pair`, faça o download da chave privada. Em seguida, clique em `Add`. 4. Após o download, mova a chave para o diretório do `OCI CLI` e renomeie para `oci_api_key.pem`. - GNU/Linux ``` mkdir -p ~/.oci && mv ~/Downloads/<nome_do_arquivo>.pem ~/.oci/oci_api_key.pem ``` - Windows ``` move C:\Users\<user>\Downloads\<nome_do_arquivo>.pem C:\Users\<user>\.oci\oci_api_key.pem ``` 5. Corrija as permissões da chave privada: ``` oci setup repair-file-permissions --file <caminho_da_chave_privada> ``` 6. Copie o texto que apareceu na página de criação da `API KEY` para o arquivo de configuração do `OCI CLI`. Não se esqueça de substituir o valor do compo `key_file` pelo caminho da chave privada. - GNU/Linux ``` vim ~/.oci/config ``` ``` [DEFAULT] user=ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fingerprint=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tenancy=ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx region=xxxxxxxx key_file=~/.oci/oci_api_key.pem ``` - Windows ``` notepad C:\Users\<user>\.oci\config ``` ``` [DEFAULT] user=ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fingerprint=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tenancy=ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx region=xxxxxxxx key_file=C:\Users\<user>\.oci\oci_api_key.pem ``` 7. Crie a pasta `./ssh` e gere a chave `ssh` (No Windows, utilize o [Git Bash](https://git-scm.com/downloads) para executar o comando abaixo). ```bash ssh-keygen -t rsa -b 4096 -f ./ssh/id_rsa ``` 8. Crie o arquivo com as variáveis de ambiente, substituindo os valores das variáveis pelos valores da sua conta (o conteúdo usado no arquivo ~/.oci/config acima). - GNU/Linux ``` vim ./env.sh ``` ``` export TF_VAR_tenancy_ocid=<your tenancy ocid> export TF_VAR_user_ocid=<your user ocid> export TF_VAR_fingerprint=<your fingerprint> export TF_VAR_private_key_path=~/.oci/oci_api_key.pem export TF_VAR_ssh_public_key=$(cat ssh/id_rsa.pub) # Optional if you want to use a different profile name change the value below export TF_VAR_oci_profile="DEFAULT" ``` Agora rode o script para exportar as variáveis: ``` source ./env.sh ``` - Windows No Windows, você pode criar um arquivo `env.bat` com o conteúdo abaixo e executar o arquivo para exportar as variáveis. ``` set TF_VAR_tenancy_ocid=<your tenancy ocid> set TF_VAR_user_ocid=<your user ocid> set TF_VAR_fingerprint=<your fingerprint> set TF_VAR_private_key_path=C:\Users\<user>\.oci\oci_api_key.pem set TF_VAR_ssh_public_key=C:\Users\<user>\.oci\ssh\id_rsa.pub # Optional if you want to use a different profile name change the value below set TF_VAR_oci_profile="DEFAULT" ``` Agora execute o arquivo para exportar as variáveis: ``` env.bat ``` ## Criando o cluster 1. Instale os módulos ```sh tofu init ``` 2. Crie o cluster. ```sh tofu apply ``` - OBS: Opicionalmente, você pode utilizar o comando `tofu plan` para visualizar as alterações que serão realizadas antes de executar o `tofu apply`. Com os seguintes comandos: ``` tofu plan -out=oci.tfplan tofu apply -auto-approve "oci.tfplan" ``` 3. Edite o arquivo `~/.kube/config` para adicionar a autenticação com a `API KEY` conforme exemplo abaixo. ```sh - name: user-xxxxxxxxxx user: exec: apiVersion: client.authentication.k8s.io/v1beta1 command: oci args: - ce - cluster - generate-token - --cluster-id - xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx - --region - xxxxxxxxxxx - --auth # ADICIONE ESSA LINHA - api_key # ADICIONE ESSA LINHA - --profile # ADICIONE ESSA LINHA - DEFAULT # ADICIONE ESSA LINHA ``` 4. Acesse o cluster. ```sh kubectl get nodes ``` ### Script para criação do cluster #### Atenção: O script está em fase de testes e funciona apenas no Linux. Caso queira automatizar o processo de criação do cluster, basta executar o script main.sh que está na raiz do projeto. O script irá gerar a chave SSH, adicionar a chave pública na TF_VAR, inicializar o Terraform e criar o cluster. ```sh ./main.sh ``` ## Load Balancer O cluster que criamos já conta com um Network Load Balancer configurado para expor uma aplicação na porta 80. Basta configurar um serviço do tipo `NodePort` com a porta `80` e a nodePort `30080`. Exemplos de como configurar o serviço podem ser encontrados no diretório `manifests`. O endereço do Load Balancer é informado na final da execução, no formato `public_ip = "xxx.xxx.xxx.xxx"` e pode ser consultado a qualquer momento com o comando: ```sh tofu output public_ip ``` ## Deletando o cluster 1. Para deletar o cluster bastar executar o comando: ```sh tofu destroy ``` ## Problemas conhecidos - ### Se você tentar criar um cluster com uma conta gratuita e receber o erro abaixo ``` Error: "Out of capacity" ou "Out of host capacity" ``` As contas gratuitas tem um número limitado de instâncias disponíveis, possivelmente a região que você está tentando criar o cluster não tem mais instâncias disponíveis. Você pode esperar até que novas instâncias fiquem disponíveis ou tentar criar o cluster em outra região. Além disso, o upgrade para uma conta `Pay As You Go` pode resolver o problema, pois as contas `Pay As You Go` tem um número maior de instâncias disponíveis. Você não será cobrado pelo uso de recursos gratuitos mesmo após o upgrade. - ### Erro `401-NotAuthenticated` ou o comando `kubectl` não funciona. Isso ocorre porque o token de autenticação expirou Gere um novo token de autenticação e exporte para a variável de ambiente `OCI_CLI_AUTH`. ```sh oci session authenticate --region us-ashburn-1 ``` - Linux ```sh export OCI_CLI_AUTH=security_token ``` - Windows ```sh set OCI_CLI_AUTH=security_token ``` - ### Erros devido a falha na execução do `tofu destroy`, impossibilitando a exclusão do cluster e todos os recursos. Ou erros como o `Error Code: CompartmentAlreadyExists` que não são resolvidos com o `tofu destroy` Para resolver esse problema, basta deletar os recursos manualmente no console da OCI. Seguindo a ordem abaixo: - [Kubernetes Cluster](https://cloud.oracle.com/containers/clusters) - [Virtual Cloud Networks](https://cloud.oracle.com/networking/vcns) - [Compartments](https://cloud.oracle.com/identity/compartments) Obs: Caso não apareça o Cluster ou a VPN para deletar, certifique que selecionou o Compartment certo `k8s`. # Referências - [OpenTofu Documentation](https://opentofu.org/docs/) - [Terrafom Essentials](https://www.linuxtips.io/course/terraform-essentials) - [Free Oracle Cloud Kubernetes cluster with Terraform](https://arnoldgalovics.com/oracle-cloud-kubernetes-terraform/) ## Criado por [@Raphael Borges](https://r11s.com.br/)", Assign "at most 3 tags" to the expected json: {"id":"7317","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"