...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
title | Importante |
---|
...
...
Figura 2.1 - Estimativa de custo do serviço
Informações | ||
---|---|---|
| ||
Como a infraestrutura que utilizamos é de terceiros, ocultamos os preços informados nas imagens dessa página pois ocasionalmente pode haver variação de preços pelos serviços fornecidos por essas empresas. |
Publicações
A aba Aplicações permite realizar o deploy do seu projeto em servidores na nuvem de forma rápida e descomplicada. Durante a criação da publicação é possível configurar a infraestrutura dos servidores, como quantidade de instâncias, plataformas, variáveis de ambiente e outros dados.
Figura 3.1 - Aba de publicações
...
- Ícones de status: os ícones que representa o serviço, enquanto a sua cor representa o status:
- Verde: Pronto;
- Amarelo: Em processo
- Vermelho: Parado;
- Publicação: endereço URL da publicação;
- Data de Atualização: data e hora da última atualização;
- Plataforma do projeto;
- Versão: informa o tipo de projeto e a versão atual
- ícone monitor: sistema Java web (low code);
- ícone Smartphone: sistema Java mobile ou web / mobile (low code);
- outro ícone: sistema em outra plataforma;
- Status: informa o status atual do projeto: pronto, parado, criando, iniciando, parando, destruindo ou atualizando;
- Menu Opções: menu de opções.
...
Opções da Aplicação
O menu de opções possui diversas funcionalidades que estão listadas abaixo, algumas são específicas para o serviço de publicação.
Figura 3.2 - Menu opções da Aplicação
- Iniciar: inicia um serviço parado;
- Parar: para um serviço em execução.
- Reiniciar Aplicação: reinicia a aplicação;
- Reiniciar Instâncias: reinicia todas as instâncias;
- Terminal: abre o terminal linux da primeira instância da publicação;
- Logs: exibe os logs gerados pelo servidor da aplicação, ver mais em Logs da Aplicação;
- Monitoramento: exibe a janela com os gráficos de monitoramento da Publicação;
- Segurança: concede permissão de acesso a esse serviço para outros usuários Cronapp ou para todos os usuários que fazem parte de um contrato Cronapp, ver mais em Segurança;
- Agendamento: permite agendar ações, ver mais em Agendamento de Serviços;
- Reconstruir: cria um novo ambiente com o mesmo nome, ID e configuração;
- Remover: exclui o serviço, ver mais em Excluir;
- Editar: editar a publicação criada.
...
Log da Aplicação
Essa funcionalidade irá abrir uma janela para exibir os logs gerados pelo servidor da publicação.
Na janela de logs existem duas abas: Geral e Arquivos de Log.
Aba Geral
Em Geral (Figura 3.3) serão exibidas todas as ações ocorridas no servidor da aplicação, mostrando informações, avisos e erros. Ao clicar no botão Editar (item 1 da Figura 3.4) será aberta uma janela exibindo a mensagem completa.
Figura 3.3 - A aba geral exibe todas as ações ocorridas no servidor da aplicação
- Ícones de status: os ícones que representa o serviço, enquanto a sua cor representa o status:
- Verde: informação;
- Vermelho: aviso;
- Coluna Mensagem: ação ocorrida;
- Coluna Data de criação: data e hora da ação;
- Coluna Severidade: tipo da mensagem, podendo ser informação, aviso, erro;
- Editar: abre janela que exibe a mensagem completa.
Aba Arquivos de Log
A segunda aba só estará disponível em publicações ativas e exibirá os logs gerados pela instância da publicação. Caso a publicação possua mais de uma instância, é possível filtrar os logs usando a caixa de seleção instâncias (item 1, Figura 3.4).
Figura 3.4 - A aba Arquivos de Log exibe os logs gerados pela instância selecionada
- Instâncias: caixa de seleção com as instâncias da publicação, selecione uma para exibir os logs referentes a ela;
- Terminal: coluna que exibe o log completo através do terminal;
- Baixar: coluna que gera o download de um arquivo com extensão .log;
- Coluna Arquivo: título do log;
- Coluna Data de criação: data e hora em que foi gerado o log.
...
Monitoramento da Aplicação e Instâncias
Essa funcionalidade abrirá uma janela para exibir dados sobre o uso dos recursos em formato de gráfico.
Figura 3.5 - Janela de monitoramento de uma Aplicação
...
- Data de início: define o período de início do gráfico;
- Intervalo: determina o tempo para cada intervalo da linha do gráfico.
...
Gráficos da publicação
As métricas a seguir são visualizadas ao acessar o botão de opção Monitoramento de uma publicação, com isso é possível analisar o Balanceamento de carga da Aplicação.
Se a publicação estiver configurada para uma única instância, só estará disponível o gráfico CPUUtilization, porém se o número mínimo e máximo de instâncias estiverem diferentes, ou seja em modo auto escalável, outros gráficos serão exibidos:
...
Percentual de utilização da CPU.
...
HTTPCode_Target_5XX_Count,
HTTPCode_Target_2XX_Count
...
...
Gráficos das instâncias
As métricas a seguir são visualizadas ao acessar o botão opção Monitoramento de uma instância, com isso é possível analisar o uso de recurso de cada instância separadamente.
...
Percentual de utilização da CPU na instância.
...
Nova Publicação
Ao clicar no botão Nova Publicação da aba Aplicações (Figura 3.1) será aberta a janela exibida abaixo, após sua configuração, clique no botão Nova Publicação para iniciar a criação do Servidor.
Informações | ||
---|---|---|
| ||
Iniciar, atualizar ou parar uma aplicação costumar levar entre 8 e 15 minutos, tempo necessário para subir ou derrubar um servidor. |
Figura 3.6 - Configuração da publicação
- URL da Aplicação: nome do domínio ou subdomínio da aplicação.
- Domínio: os itens da caixa de seleção gerados a partir da aba Domínio.
- DNS: Nome Canônico (CNAME) único da publicação gerado pelo servidor de publicação.
- Tipo de instância: tamanho de cada instância da publicação.
É recomendável escolher uma instância com capacidade suficiente para executar seu sistema sob carga, mas que não fique ocioso na maior parte do tempo. - Mínimo e máximo de instâncias: caso seu sistema necessite de alta disponibilidade e escalabilidade, recomenda-se adicionar mais de uma instância, evitando que o sistema fique inativo ao falhar uma das instâncias.
Quando os campos mínimo e máximo são configurados com valores distintos, o servidor é iniciado com o número mínimo de instâncias e aumenta automaticamente a medida que o número de requisições cresce, retornando ao número mínimo assim que as requisições diminuem.
O valor exibido no "Custo Estimado" sempre considera o uso do serviço com número máximo de instâncias em 100% do tempo durante todo o mês, porém o valor cobrado será menor caso o sistema não utilize o número máximo de instâncias durante todo o período. - Plataforma: plataforma na qual seu sistema foi desenvolvido:
Projetos low code usará sempre a plataforma Tomcat + Java, enquanto projetos High code permite usar Tomcat + Java, NodeJS ou Python.
As plataformas exibidas nessa caixa de seleção refletirão a compatibilidade do projeto aberto no Cronapp no momento da configuração. - Certificado SSL (HTTPS): lista os certificados gerados na aba Certificados SSL (HTTPS).
Caso seu sistema não necessite de certificados de segurança, escolha a opção 'Sem Certificado'. - Hora de Início Automático*: define a hora que o servidor da publicação será iniciado diariamente.
- Hora de Término Automático*: define a hora que o servidor da publicação será interrompido diariamente.
- Variáveis de Ambiente: cadastra as variáveis de ambiente no servidor da publicação.
Informações | ||
---|---|---|
| ||
Recomendável o uso das horas de início e término durante o período de implantação do sistema, evitando gastos durante período de inatividade. O agendamento pode ser alterado posteriormente na opção de Agendamento da publicação. |
...
Editar Publicação
Ao acessar as opções de edição de uma publicação será aberta uma janela Configuração com três abas (Figura 3.7): Geral, Versões e Instâncias.
Aba geral
Figura 3.7 - aba Geral da janela de edição da publicação
Na aba Geral serão exibidas todos os campos informados na Figura 3.6 mais o campo informados abaixo:
- Id do Recurso: Id da publicação;
- Criado por: nome do usuário associado a conta Cronapp que criou a publicação;
- Contrato: contrato associado a conta Cronapp que criou a publicação;
- Data de Criação;
- Data de Atualização;
- Versão: atualiza a publicação para uma das versões geradas e listadas na aba Versões.
...
Aba Versões
A aba Versões, na janela de edição da publicação, lista as versões de publicações do sistema e permite gerar uma nova versão.
Para gerar uma versão da Aplicação é necessário estar com o projeto aberto no Cronapp e acessar a aba Versões da janela de configurações de uma publicação (Figura 3.2).
Clique no botão Nova Versão para abrir a janela destacada na Figura 3.8, informe o rótulo da versão e sua plataforma, confirme clicando no botão Nova Versão. Após o carregamento da versão atual do sistema, o Cronapp exibirá um pop-up perguntando se deseja atualizar o sistema para a versão recém-criada, caso negue, será possível atualizar posteriormente selecionando a opção na caixa de seleção Versão da aba Geral e clicando em Atualizar (Figura 3.7).
Figura 3.8 - aba Versões da janela de edição da publicação
...
Aba Instâncias
A última aba, Instâncias, exibe todas as instâncias ativas no sistema naquele momento, exibindo seu identificador e IP público (Figura 3.9). Acesse o monitoramento e o terminal Linux da instância nos botões de opção lateral.
Figura 3.9 - aba Instâncias da janela de edição da publicação
Gerando war
O WAR (Web application ARchive) é um arquivo que compacta todos os arquivos que constituem uma aplicação Java web. Ao gerar nova publicação ou criar uma versão (Figura 3.8), o Cronapp solicita confirmação para gerar o war da aplicação (Figura 3.10), caso confirme, uma janela de configuração do war será aberta.
Figura 3.10 - Configurando a geração do arquivo .war durante a Publicação ou ao gerar Versão
...
- Perfil: perfis dos bancos de dados usados no desenvolvimento do projeto: Desenvolvimento, Produção ou outro criado no context.xml.
- Tipo de Geração: define as ações que serão tomadas com o banco de dados
- Manter como configurado: mantem as mesmas configurações aplicadas no momento da geração da persistência no Diagrama de Classe;
- Criar ou Atualizar Tabelas: use essa opção para gerar as tabelas do banco de dados pela primeira vez ou caso tenha adicionado novas classes e não tenha feito alterações nas que já existem. Essa opção não apaga os dados do banco de dados;
- Apagar e Recriar Tabelas: apaga todas as tabelas, incluindo seus dados, do banco de dados e recria tudo novamente com as novas alterações feitas;
- Utilizar Tabelas Existentes: não realiza alterações no banco de dados;
- Auto Popular Dados: ao criar as tabelas do banco de dados os dados contidos no arquivo populate.json serão inseridos automaticamente;
- Dados de Conexão Embutidos: ao desmarcar, os dados de conexão contidos no context.xml não serão incluídos no war. A conexão com o banco de dados deverá ser configurada posteriormente no servidor da aplicação.
Caso o Perfil selecionado esteja utilizando um banco de dados local (H2) e a opção Dados de conexão Embutidos esteja marcado, uma mensagem de alerta será exibida.
Figura 3.11 - Mensagem de confirmação de uso de banco de dados local
...
Domínio
A aba Domínio é responsável por gerar serviço web de Domain Name System (DNS) altamente disponível e dimensionável.
Figura 4.1 - Aba Domínio
Após a criação da zona de hospedagem, seu domínio será exibido na lista (Figura 4.1) com as seguintes colunas:
- Ícones de status: os ícones que representa o serviço, enquanto a sua cor representa o status:
- Verde: Disponível;
- Vermelho: Indisponível;
- Domínio: URL da aplicação;
- Data de Criação: data e hora de criação do registro;
- Status: informa o status atual do domínio: Disponível ou Indisponível;
- Opções: botões de opções.
Opções do Domínio
Os botões de opção do Domínio estão destacados no item 1 da Figura 4.2.
Figura 4.2 - Botões opção do Domínio
- Monitoramento: exibe a tela com os gráficos de monitoramento da Zona de Hospedagem;
- Segurança: concede permissão de acesso a esse serviço para outros usuários Cronapp ou para todos os usuários que fazem parte de um contrato Cronapp, ver mais em Segurança;
- Remover: exclui o serviço, ver mais em Excluir;
- Editar: edita o domínio criado.
...
Nova Zona de Hospedagem
Ao clicar no botão "Nova Zona de hospedagem" (Figura 4.1) será aberta a janela de configuração abaixo.
Figura 4.3 - Configuração do domínio
- Domínio: domínio que será usado na publicação.
O domínio pode conter apenas os caracteres a-z, 0-9 e – (hífen); porém o hífen não pode ser usado no início ou no fim do rótulo. - Publicado fora dos Serviços de Cloud: Caso o DNS esteja publicado fora da nossa plataforma, marque essa opção.
...
Editar Zona de Hospedagem
As configurações do domínio só serão exibidas ao acessar o botão opção Editar de uma zona de hospedagem criada. Após selecionar a opção, uma janela de configuração será exibida contendo duas abas: Geral e Conjunto de Registros.
Aba Geral
Na aba Geral serão exibidos quatro campos não editáveis e a caixa de seleção para realizar a publicação fora da plataforma Cronapp.
Figura 4.4 - Aba Geral das configurações do domínio
- Id do Recurso: Id da zona de hospedagem;
- Domínio: URL informado;
- Data de Criação;
- Status do recurso;
- publicado fora dos Serviços de Cloud: selecione caso deseje realizar a publicação fora da plataforma Cronapp.
Aba Conjunto de Registros
Na aba Conjunto de Registros é possível especificar um roteamento DNS configurando os tipos de registros para o domínio e seus subdomínios.
Clique no botão Novo Conjunto de Registro para especificar o subdomínio, tipo e valor.
Figura 4.5 - Adicionando novo tipo de registro na aba Conjunto de Registros
- Nome: domínio ou subdomínio que terá o tráfego roteado;
- Tipo: tipo de registro do roteamento DNS (veja mais no tópico abaixo);
- Valor: configuração específica para o tipo de registro selecionado;
- TTL: Quantidade de tempo de vida (Time To Live), em segundos, que os resolvedores recursivos de DNS armazenaram informações em cache sobre esse registro.
...
Tipos de Registros
Os tipos de registros especificam o roteamento DNS que será feito para um domínio ou subdomínio.
A
Endereço IPv4 em notação decimal com pontos.
Bloco de código | ||
---|---|---|
| ||
192.0.2.1 |
AAAA
Endereço IPv6 em formato hexadecimal separado por dois-pontos.
Bloco de código | ||
---|---|---|
| ||
2001:0db8:85a3:0:0:8a2e::7334 |
CAA
Permite especificar quais autoridades de certificação (CAs) têm permissão para emitir certificados para um domínio ou um subdomínio.
Bloco de código | ||
---|---|---|
| ||
caa.exemplo.com |
CNAME
O Canonical NAME especifica um apelido (alias) para o hostname (A). É uma forma de redirecionamento.
Bloco de código | ||
---|---|---|
| ||
hostname.exemplo.com |
MX
O MX (Mail eXchanger) define os servidores SMTP e a sua prioridade.
sintaxe: <prioridade> <domínio>
- Prioridade: Ao cadastrar dois servidores de e-mail e especificar os valores de 10 e 20 respectivamente, o e-mail sempre vai para o servidor com uma prioridade 10, a não ser que ele esteja indisponível. Se os dois servidores tiverem a mesma prioridade, o e-mail será roteado para os dois servidores de forma praticamente igual. É possível informar valores entre 0 e 65535.
Domínio: Nome do domínio do servidor de e-mail.
Bloco de código | ||
---|---|---|
| ||
10 mail.exemplo.com |
NAPTR
O Name Authority Pointer (NAPTR – Ponteiro de autoridade de nome) é um tipo de registro usado por aplicações Dynamic Delegation Discovery System (DDDS – Sistema de descoberta de delegação dinâmica) para converter um valor em outro ou substituir um valor por outro. Um exemplo de uso é a conversão de números de telefônicos em SIP URIs.
sintaxe: <pedido> <preferência> <sinalizadores> <serviço> <regexp> <substituição>
- Pedido: Número que define a sequência que a aplicação DDDS avaliará os registros. Valores válidos: 0 - 65535.
- Preferência: Define a preferência para registros com a mesma ordem. Valores válidos: 0 - 65535.
- Sinalizadores: Configuração específicas para as aplicações DDDS. Os valores atualmente definidos na RFC 3404 são letras maiúsculas e minúsculas "A", "P", "S"e "U"e a string vazia "".
- Serviço: Configuração específica para as aplicações DDDS, saiba mais em URI DDDS application, S-NAPTR DDDS application e U-NAPTR DDDS application.
- Regexp: Expressão regular para que a aplicação DDDS possa converter um valor de entrada em um valor de saída.
- Substituição: O Fully Qualified Domain Name (FQDN - Nome de Domínio Totalmente Qualificado) do próximo nome de domínio para o qual você deseja que a aplicação DDDS envie uma consulta de DNS.
Bloco de código | ||
---|---|---|
| ||
100 50 "u" "E2U+sip" "!^(\\+557132960083)$!sip:\\1@exemplo.com!" . |
NS
O Name Server (NS - Servidor de Nome) específica o servidor DNS para o domínio ou subdomínio. Pelo menos, dois registros NS devem ser definidos para cada domínio. Geralmente, um principal e outro secundário.
Bloco de código | ||
---|---|---|
| ||
ns-1.exemplo.com |
PTR
O registro PTR (PoinTeR) tem o mesmo formato que um nome de domínio.
Bloco de código | ||
---|---|---|
| ||
hostname.exemplo.com |
SOA
Start Of Authority (SOA - Início de Autoridade) indica o responsável por respostas autoritárias a um domínio, ou seja, o responsável pelo domínio.
sintaxe: <ns> <email> <número de série> <atualização> <tempo de repetição> <tempo de expiração> <ttl>
- NS: Servidor de Nome.
- e-mail: e-mail do administrador. O simbolo "@" (arroba) deve ser substituído por um "." (ponto);
- Número de série: número de série que você pode incrementar opcionalmente sempre que atualizar um registro na zona hospedada.
- Atualização: tempo (em segundos) que os servidores DNS secundários aguardam antes de consultar o registro SOA do servidor DNS principal para verificar as alterações.
- Tempo de repetição: intervalo (em segundos) que um servidor secundário aguarda antes de repetir uma transferência de zona com falha. Normalmente, o tempo de repetição é menor do que o tempo de atualização.
- Tempo de expiração: tempo (em segundos) que um servidor secundário continuará tentando concluir uma transferência de zona.
- TTL: O Time To Live (TTL - Tempo Mínimo de Vida) define o tempo que um resultado NXDOMAIN (domínio não existe) deve ser armazenado em cache pelo resolvedor de DNS.
Bloco de código | ||
---|---|---|
| ||
ns-1.exemplo.com. nome.exemplo.com. 1 7200 900 120960 86400 |
SPF
O Sender Policy Framework é uma tentativa de controle de falsos e-mails. Permite verificar a identidade do remetente de mensagens de e-mail.
Observação: Atualmente não é mais recomendável o uso do tipo de registro SPF, ao invés disso, use o TXT.
Bloco de código | ||
---|---|---|
| ||
"v=spf1 ip4:192.168.0.1/16 -all" |
SRV
O SeRVice (SRV - Serviço) permite definir a localização de serviços disponíveis em um domínio, inclusive seus protocolos e portas.
sintaxe: <prioridade> <peso> <porta> <nome do domínio>
Bloco de código | ||
---|---|---|
| ||
10 5 80 hostname.exemplo.com |
TXT
O TeXT permite incluir um texto curto, com uma ou mais strings, em um hostname.
Bloco de código | ||
---|---|---|
| ||
"Essa cadeia de caracteres possui \"aspas\"."
ou
"v=spf1 ip4:192.168.0.1/16 -all" |
...
Certificados SSL
O serviço Certificado SSL (HTTPS) gera uma camada de segurança na comunicação HTTP utilizando os protocolos SSL/TLS entre o cliente e o servidor da sua aplicação.
Figura 5.1 - aba Certificados SSL (HTTPS)
Os certificados gerados serão listados na aba Certificados SSL (HTTPS) (Figura 5.1), suas colunas representam:
- Ícones de status: os ícones que representa o serviço, enquanto a sua cor representa o status:
- Verde: Emitido;
- Vermelho: Validação Pendente;
- Domínio: domínio coberto pelo certificado;
- Data de Emissão: data em que foi gerado o certificado;
- Data de Expiração: data em que acaba a validade do certificado;
- Tipo: emissor do certificado;
- Status: informa o status atual do certificado;
- Opções: botões opções do Certificado SSL.
Opções do Certificado SSL (HTTPS)
Os botões opções podem ser visto na Figura 5.1 e são listados abaixo.
- Segurança: concede permissão de acesso a esse serviço para outros usuários Cronapp ou para todos os usuários que fazem parte de um contrato Cronapp, ver mais em Segurança;
- Remover: exclui o serviço, ver mais em Excluir;
- Editar: edita o certificado SSL criado.
Novo Certificado SSL
Atualmente o Cronapp permite que você gere seu certificado pela Amazon ou Let's Encrypt. Ao clicar em Novo Certificado SSL (Figura 5.1) uma janela sera aberta para que você possa selecionar o domínio (configurado previamente na aba Domínio) e o emissor do certificado na caixa de seleção "Tipo" (Figura 5.2).
Informações | ||
---|---|---|
| ||
Fique atento ao prazo de expiração dos certificados SSL: O Let's Encrypt é necessário renovar a cada três meses, enquanto o da Amazon é anual. |
Figura 5.2 - Criação de novo Certificado SSL
Se seu projeto estiver publicado em nossa plataforma, a validação da publicação é feita de forma automática, caso contrário, você deverá ter marcado o checkbox Publicado fora dos Serviços de Cloud no momento que criou o domínio e ao clicar em Novo Certificado SSL (Figura 5.2) uma janela aparecerá informando o Nome, tipo de registro e valor do challenge certificate para cadastrar no seu servidor DNS (Figura 5.3).
Antes de iniciar o challenge certificate, o Cronapp faz um pequeno teste para identificar se o registro TXT já foi atualizado em seu Servidor DNS, evitando falha no challenge certificate. Essa verificação de atualização no servidor DNS dura alguns minutos, caso o desafio do certificado falhe, será necessário criar outro challenge certificate.
Figura 5.3 - Dados gerados para testar a autenticidade do domínio
...
Editar Certificado SSL
Ao acessar o botão opção de um certificado você terá acesso aos campos informados na Figura 5.4.
Figura 5.4 - Edição de Certificado SSL
Edição de Certificado SSL:
- Id do Recurso: Id do certificado SSL;
- Domínio: domínio informado no momento da criação do Certificado SSL;
- Tipo: entidade certificadora informada no momento da criação (Let's Encrypt ou Amazon);
- Data de Criação;
- Data de Emissão;
- Data de Expiração;
- Status: informa o status atual do certificado: Emitido, Validação Pendente e Expirado.
Os dados a seguir devem ser inseridos nas configurações de DNS do seu domínio, indicando o endereço onde está hospedado o seu sistema.
- Nome;
- Tipo: tipo de registro;
- Valor:
...
Banco de dados
...
...
...
...
...
...
...
...
...
...
...
...