Adicionar 'Rancher do Portal Modelo'

Rancher-do-Portal-Modelo.md

@@ -0,0 +1,62 @@
+# Uso de Rancher/Kubernetes do Portal Modelo
+
+O Portal Modelo 3 tem mais de 1000 instalações na infraestrutura da SEITI/COTIN. Elas estão hospedadas em um kubernetes e é possível acessá-las via rancher.
+
+## Linha de Comando
+
+Ao usar linha de comando, use a seguinte regra para montar o "endereço" da Câmara/Assembleia:
+
+- Se câmara, use o nome completo do município, sem espaços ou acentos, seguido de traço e sigla da UF: São João Batista, Maranhão -> saojoaobatista-ma
+- Se assembleia, use "al" seguido de traço e sigla da UF: al-pi
+
+### Preparação
+
+- Instalar o rancher-cli. O mais fácil é através do [homebrew](https://brew.sh/) (sim, mesmo em linux): `brew install rancher-cli` (no windows, use Windows Linux Subsystem, WLS)
+- Instalar o kubectl. Também dá pra ser pelo homebrew: `brew install kubectl`
+- Crie uma chave de API na interface do [Rancher/Nau](https://nau.interlegis.leg.br/dashboard/account).
+- Faça login no rancher-cli, usando o token Bearer gerado acima: `rancher login https://nau.interlegis.leg.br -t token-cs5cw:exemploaasadasdasdasdasdasdasfamg`
+- Execute o seguinte comando para testar: `rancher kubectl get app -o yaml -n saojoaobatista-ma | grep -iA10 "notes"`
+
+
+### Obtenção de Senha de Admin:
+
+`rancher kubectl get app -o yaml -n saojoaobatista-ma | grep -iA10 "notes"`
+
+### Listagem dos Pods
+
+A instalação consiste em dois pods, um do Plone em si e outro do ZEO (um servidor para distribuir a carga). Normalmente o Plone que é interessante.
+
+`rancher kubectl get pods -n timoteo-mg`
+
+### Log do container
+
+`rancher kubectl logs -f <pod-name> -n <namespace>`
+
+
+- Se tiver crashado, pode acessar o log anterior:
+
+`rancher kubectl logs <pod-name> -n <namespace> --previous`
+
+### Shell dentro do container
+
+Primeiro descubra o pod do plone, depois:
+
+`rancher kubectl exec -n sinop-mt -it sinop-mt-portalmodelo-plone-6f6c74c44-t7j5v -- /bin/bash`
+
+
+Exemplo de diretório interessante dentro do container:
+`/data/log`
+
+Aqui tem o log normal e o log de acesso do plone.
+
+
+## Acesso direto pela interface web do Rancher
+
+Passos pelo rancher (`nau.interlegis.leg.br`):
+- A partir da tela inicial do rancher, clique no cluster `portalmodelo` e depois em `apps` (no menu à esquerda) e `installed apps`.
+- Utilize o campo de filtro (acima, à direita) para achar o município desejado.
+- Clique nos "3 pontinhos" e em `View YAML`.
+- Procure por "notes:"
+
+
+>>> Detalhe: bem lento, raramente usamos.