Provisionamento e ciclo de vida
Como um ambiente dedicado é montado depois do pagamento, o que acontece quando um passo falha e como funcionam recriação, remoção, suspensão e exclusão.
O provisionamento começa sozinho assim que a assinatura Dedicada é confirmada. O Authio monta o ambiente um passo de cada vez no provedor de hospedagem e registra cada passo na linha do tempo do ambiente, que o console desenha como o ambiente se montando. Costuma levar poucos minutos.
O resultado de cada passo é salvo antes de o próximo rodar, então um provisionamento que para por qualquer motivo continua do passo em que estava, aproveitando o que já foi criado.
Status do ambiente
| Status | O que significa |
|---|---|
| Solicitado | A assinatura foi confirmada e o ambiente aguarda o primeiro passo. |
| Provisionando | O ambiente está sendo montado, um passo de cada vez. |
| Pronto | Todos os passos rodaram e a API responde à verificação de saúde. Só um ambiente pronto pode ser alterado pelo dono. |
| Falhou | Um passo continuou falhando e o provisionamento parou. |
| Suspenso | A assinatura não cobre mais o ambiente. Os serviços ficam parados e os dados ficam guardados até a data de exclusão. |
| Removendo | O ambiente está sendo apagado no provedor de hospedagem. |
| Excluído | O ambiente e os dados dele não existem mais. |
Os passos do provisionamento
| Passo | O que acontece |
|---|---|
| 1. Criar o projeto | Um projeto exclusivo é criado no provedor de hospedagem para guardar todos os serviços do ambiente. |
| 2. Criar o banco de dados | O serviço PostgreSQL é criado com o teto de memória dele e o volume onde guarda os dados. |
| 3. Criar o cache | O serviço Redis é criado com o teto de memória, o volume e uma senha sem a qual ele recusa conexões. |
| 4. Criar a API | O serviço da API é criado a partir da imagem da edição dedicada, com a verificação de saúde e o teto de memória. |
| 5. Criar o console | O serviço do console é criado do mesmo jeito. |
| 6. Atribuir os endereços | A API e o console recebem endereços públicos no domínio do provedor de hospedagem. |
| 7. Subdomínios da plataforma | Onde a plataforma tem um domínio para ambientes, a API e o console também recebem auth.<nome>.<domínio da plataforma> e console.<nome>.<domínio da plataforma>, com os registros DNS de que precisam. Caso contrário, o passo é pulado. |
| 8. Configurar as variáveis | A configuração com que os dois serviços começam é gravada: strings de conexão, chaves, endereços e o remetente de e-mail padrão. |
| 9. Fazer o deploy | A API e o console passam pelo deploy com essa configuração. |
| 10. Esperar até responder | O Authio espera os dois deploys terminarem com sucesso e a API responder à verificação de saúde, chamada de fora, do jeito que os seus usuários vão chegar até ela. |
| 11. Enviar o e-mail de boas-vindas | O dono da conta é avisado de que o ambiente está pronto, com os endereços do console e da API e o usuário para entrar. |
Acompanhando a montagem
Abra Ambiente enquanto ele está sendo montado. O painel mostra cada bloco se encaixando quando o passo dele termina, com o tempo que levou, e se atualiza sozinho a cada poucos segundos. Um passo que depende do provedor de hospedagem — os deploys, a verificação de saúde — aparece como aguardando até o provedor responder.
Quando um passo falha
Uma falha no provedor de hospedagem costuma ser um limite de requisições ou uma indisponibilidade momentânea, então um passo que falhou é tentado de novo sozinho, de onde parou. Nada do que já foi criado é apagado e montado outra vez.
| Tentativa | Quando roda |
|---|---|
| 1 | Quando chega a vez do passo |
| 2 | 30 segundos depois da primeira falha |
| 3 | 90 segundos depois da segunda |
| 4 | 4,5 minutos depois da terceira |
| 5 | 13,5 minutos depois da quarta |
Esperar até responder também falha quando um deploy termina como falho, caído ou removido, ou quando a API não fica saudável em 30 minutos.
Se a quinta tentativa também falhar, o ambiente fica Falhou e o provisionamento para. O console mostra o passo em que ele parou e o erro, e um operador da plataforma o retoma a partir desse passo; quando o passo era a verificação de saúde, a retomada faz o deploy dos serviços de novo antes. A página acompanha o andamento sozinha.
Você não precisa esperar por isso: um proprietário ou administrador da conta pode recriar o ambiente do zero ou removê-lo, mesmo travado ou com falha.
Recriar e remover
As duas ações ficam em Configuração → Zona de perigo e pedem que você digite o nome do ambiente antes de rodar. Nenhuma das duas pode ser desfeita.
| Ação | O que acontece |
|---|---|
| Recriar do zero | Remove o ambiente e depois provisiona um novo a partir do primeiro passo. O novo começa vazio, com novas credenciais de primeiro acesso, e fica pronto em poucos minutos. |
| Remover ambiente | Apaga o projeto do ambiente no provedor de hospedagem, com o banco de dados, e remove os registros DNS que a plataforma criou para ele. Nada é criado no lugar. |
As duas apagam tudo o que o ambiente guarda:
- O banco de dados, com todos os realms, clients, usuários e o histórico deles.
- As variáveis que você alterou, como o seu próprio servidor de e-mail.
- O seu domínio próprio, que precisa ser adicionado de novo num ambiente novo. Os registros no seu provedor de DNS continuam lá até você apagá-los.
Nenhuma das duas muda a assinatura: cancele-a à parte se não precisar mais do ambiente. Enquanto a assinatura estiver ativa, um ambiente removido pode ser criado de novo com Criar ambiente, no topo da página.
A remoção também funciona num ambiente travado ou montado pela metade: o que já não existe no provedor de hospedagem conta como removido. Se o provedor não terminar, o ambiente fica Removendo com a resposta do provedor; escolha Remover de novo ou deixe que seja tentado de novo sozinho. O dono da conta recebe um e-mail quando o ambiente é excluído.
Suspensão e exclusão
Quando a assinatura deixa de cobrir o plano Dedicado — foi cancelada, pausada ou não paga, ou a conta mudou para outro plano —, o ambiente é suspenso:
O ambiente é suspenso
Os serviços dele são parados e os dados ficam guardados. O dono da conta recebe um e-mail com a data em que o ambiente será excluído: 30 dias depois da suspensão.
Um lembrete é enviado
Sete dias antes da data de exclusão, o dono recebe um lembrete por e-mail.
O ambiente é excluído
Nessa data, o ambiente e tudo o que há nele são excluídos de vez, e o dono recebe um último e-mail.
Voltando antes da data de exclusão
Assinar o plano Dedicado de novo antes da data de exclusão traz o ambiente de volta: os serviços são iniciados de novo e ele volta como você deixou, com os mesmos endereços, dados e configurações. Um ambiente suspenso no meio do provisionamento continua do passo em que estava.
Depois da data de exclusão, assinar de novo cria um ambiente novo e vazio. Renovação e troca de plano estão em Planos e cobrança.