From 8379e6bbcfcd9b96e29bd28bb7574b40fea4a894 Mon Sep 17 00:00:00 2001 From: Tiago Ribeiro Date: Tue, 17 Feb 2026 15:31:47 -0300 Subject: [PATCH] Add OCI and K3s cluster connection documentation --- azure-devops/CLUSTER-CONNECTION.md | 165 +++++++++++++++++++++++++++++ azure-devops/OCI-CONNECTION.md | 101 ++++++++++++++++++ 2 files changed, 266 insertions(+) create mode 100644 azure-devops/CLUSTER-CONNECTION.md create mode 100644 azure-devops/OCI-CONNECTION.md diff --git a/azure-devops/CLUSTER-CONNECTION.md b/azure-devops/CLUSTER-CONNECTION.md new file mode 100644 index 0000000..57472cd --- /dev/null +++ b/azure-devops/CLUSTER-CONNECTION.md @@ -0,0 +1,165 @@ +# K3s Cluster - Conexão e Configuração + +## Visão Geral + +Documentação de conexão aos clusters Kubernetes baseados em **K3s** (Lightweight Kubernetes). + +## Nós do Cluster + +| Hostname | Função | IP | Utilizador | Chave SSH | +|----------|--------|----|------------|-----------| +| **Zeus** | Control Plane | `45.39.210.92` | root | `lh-zeus` | +| **Posseidon** | Control Plane | `45.39.210.21` | root | `lh-zeus` | +| **Apolo** | Worker Node | `45.143.7.55` | root | `lh-zeus` | + +## Configuração SSH + +### Arquivo de Configuração SSH +**Localização:** `C:\Users\TiagoRibeiro\.ssh\config` + +``` +Host zeus + HostName 45.39.210.92 + User root + IdentityFile C:/Users/TiagoRibeiro/.ssh/lh-zeus + IdentitiesOnly yes + +Host posseidon + HostName 45.39.210.21 + User root + IdentityFile C:/Users/TiagoRibeiro/.ssh/lh-zeus + IdentitiesOnly yes + +Host apolo + HostName 45.143.7.55 + User root + IdentityFile C:/Users/TiagoRibeiro/.ssh/lh-zeus + IdentitiesOnly yes +``` + +### Chaves SSH +- **Chave Privada:** `C:\Users\TiagoRibeiro\.ssh\lh-zeus` +- **Chave Pública:** `C:\Users\TiagoRibeiro\.ssh\lh-zeus.pub` + +## Conexão aos Nós + +### Conectar via SSH +```bash +# Conectar a Zeus (Control Plane) +ssh zeus + +# Conectar a Posseidon +ssh posseidon + +# Conectar a Apolo +ssh apolo + +# Ou diretamente pelo IP +ssh root@45.39.210.92 +ssh root@45.39.210.21 +ssh root@45.143.7.55 +``` + +##ações K Oper3s + +### Verificar Status do Cluster +```bash +# No nó Zeus +kubectl get nodes +kubectl get pods -A +kubectl get services -A + +# Status do K3s +systemctl status k3s +``` + +### Contextos Kubernetes +```bash +# Listar contextos +kubectl config get-contexts + +# Trocar de contexto +kubectl config use-context + +# Ver contexto atual +kubectl config current-context +``` + +### Exemplos de Comandos +```bash +# Ver pods em todos os namespaces +kubectl get pods -A + +# Ver serviços +kubectl get svc -A + +# Ver nós +kubectl get nodes -o wide + +# Ver logs de um pod +kubectl logs -n + +# Ver eventos do cluster +kubectl get events -A --sort-by='.lastTimestamp' +``` + +## Stack Tecnológica + +- **Distro**: K3s (Rancher) +- **Ingress Controller**: Traefik (Built-in) +- **Storage**: Local Path Provisioner +- **OS**: AlmaLinux 9.x + +## Manutenção + +### Reiniciar K3s +```bash +# Reiniciar serviço K3s +systemctl restart k3s + +# Ver logs +journalctl -u k3s -f +``` + +### Backup K3s +```bash +# Backup dos recursos +kubectl get all -A -o yaml > k3s-backup.yaml + +# Backup do etcd (se configurado) +k3s etcd-snapshot save +``` + +## Acesso Remoto (kubeconfig) + +Para acesso remoto ao cluster, copie o kubeconfig de um dos nós: + +```bash +# No nó Zeus +cat /etc/rancher/k3s/k3s.yaml + +# Guardar localmente em ~/.kube/config +``` + +## Troubleshooting + +### Verificar conectividade entre nós +```bash +# Ping entre nós +ping 45.39.210.92 +ping 45.39.210.21 +ping 45.143.7.55 + +# Ver portas abertas +ss -tuln | grep 6443 # API Server +``` + +### Verificar tokens de nó +```bash +# No nó master +cat /var/lib/rancher/k3s/server/node-token +``` + +--- + +*Documento gerado em: 2026-02-17* diff --git a/azure-devops/OCI-CONNECTION.md b/azure-devops/OCI-CONNECTION.md new file mode 100644 index 0000000..0bcd2ce --- /dev/null +++ b/azure-devops/OCI-CONNECTION.md @@ -0,0 +1,101 @@ +# Oracle Cloud Infrastructure (OCI) - Conexão e Configuração + +## Visão Geral + +Documentação de conexão à Oracle Cloud Infrastructure utilizada para criar e gerenciar clusters Kubernetes. + +## Configuração SSH para OCI + +### Configuração do SSH +**Arquivo:** `C:\Users\TiagoRibeiro\.ssh\config` + +``` +# OCI Compute Instances - adicionar conforme necessário +Host oci-* + HostName + User opc + IdentityFile ~/.ssh/oci_key + IdentitiesOnly yes +``` + +## Repositório Terraform + +### tf_oci_clusters +- **URL Azure DevOps:** https://dev.azure.com/CN-Squad/Invista%20FIDC%20-%20Nexus/_git/tf_oci_clusters +- **Conteúdo:** Definições Terraform para infraestrutura OCI + +### Clonar Repositório +```bash +# Via HTTPS com PAT +git clone https://tiago.ribeiro:@dev.azure.com/CN-Squad/Invista%20FIDC%20-%20Nexus/_git/tf_oci_clusters + +# Via SSH (após configurar chave pública no Azure DevOps) +git clone git@ssh.dev.azure.com:v3/CN-Squad/Invista%20FIDC%20-%20Nexus/tf_oci_clusters +``` + +## Autenticação OCI + +### Configuração OCI CLI + +```bash +# Instalar OCI CLI +bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" + +# Configurar autenticação +oci session authenticate + +# Ou usar API Key +# 1. Criar chave privada +openssl genrsa -out ~/.oci/oci_api_key.pem 2048 + +# 2. Criar chave pública +openssl rsa -in ~/.oci/oci_api_key.pem -pubout -out ~/.oci/oci_api_key_public.pem + +# 3. Upload da chave pública no OCI Console +# User Settings → API Keys → Add Public Key +``` + +### Variáveis de Ambiente +```bash +export OCI_TENANCY= +export OCI_USER= +export OCI_FINGERPRINT= +export OCI_KEY_FILE=~/.oci/oci_api_key.pem +export OCI_REGION=us-ashburn-1 +``` + +## Comandos Úteis OCI + +### Listar Compute Instances +```bash +oci compute instance list --compartment-id +``` + +### Listar VCNs +```bash +oci network vcn list --compartment-id +``` + +### Listar Load Balancers +```bash +oci lb load-balancer list --compartment-id +``` + +## Recursos Gerenciados + +| Recurso | Descrição | +|---------|-----------| +| Compute Instances | VMs para K3s clusters | +| VCN | Virtual Cloud Network | +| Load Balancers | Balanceamento de carga | +| Object Storage | Armazenamento | +| OKE | Oracle Kubernetes Engine | + +## Links Úteis + +- **OCI Console:** https://console.oraclecloud.com +- **OCI Documentation:** https://docs.oracle.com/en-us/oci/ + +--- + +*Documento gerado em: 2026-02-17*