Add OCI and K3s cluster connection documentation
This commit is contained in:
Tiago Ribeiro
parent
fa2ff35cb2
commit
8379e6bbcf
2 changed files with 266 additions and 0 deletions
165
azure-devops/CLUSTER-CONNECTION.md
Normal file
165
azure-devops/CLUSTER-CONNECTION.md
Normal file
|
|
@ -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 <context-name>
|
||||||
|
|
||||||
|
# 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 <namespace> <pod-name>
|
||||||
|
|
||||||
|
# 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*
|
||||||
101
azure-devops/OCI-CONNECTION.md
Normal file
101
azure-devops/OCI-CONNECTION.md
Normal file
|
|
@ -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 <IP_PUBLICO>
|
||||||
|
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:<PAT>@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=<TENANCY_OCID>
|
||||||
|
export OCI_USER=<USER_OCID>
|
||||||
|
export OCI_FINGERPRINT=<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 <COMPARTMENT_OCID>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Listar VCNs
|
||||||
|
```bash
|
||||||
|
oci network vcn list --compartment-id <COMPARTMENT_OCID>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Listar Load Balancers
|
||||||
|
```bash
|
||||||
|
oci lb load-balancer list --compartment-id <COMPARTMENT_OCID>
|
||||||
|
```
|
||||||
|
|
||||||
|
## 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*
|
||||||
Loading…
Reference in a new issue