Variáveis, links e rede

Variáveis de ambiente

Na aba Vars do serviço:

• Adicionar: escreva o nome, como DATABASE_URL, e o valor, e clique em +. O nome começa com letra ou _.
• Importar: cole um arquivo .env inteiro, no formato CHAVE=valor. Linhas que começam com # são ignoradas.
• Editar: mude o valor. Tudo salva sozinho, sem botão de salvar.
• Remover: clique na lixeira e confirme.

Valores com nomes como PASSWORD, SECRET, TOKEN ou API_KEY ficam escondidos. O ícone do olho mostra o valor, e o botão ao lado copia.

Nos bancos de dados, as Variáveis do Sistema, como usuário, senha e nome do banco, são geradas pela Kymus e ficam como somente leitura.

Mudou uma variável? Reimplante

A variável nova só vale depois de reimplantar. A barra do topo do canvas avisa quando há mudança pendente. Clique em Reimplantar.

Referência a outro serviço

Em vez de copiar a senha do banco para a aplicação, use uma referência. Ela aponta para a variável do outro serviço e é resolvida a cada deploy:

1. Clique em Inserir referência.
2. Escolha o Serviço de origem e a Variável exposta. Além das variáveis dele, há sempre HOST, PORT e URL.

O valor fica no formato ${{ servico.VARIAVEL }}. Se a senha do banco mudar, é só reimplantar a aplicação.

Links (conexões)

Na aba Links, em Adicionar Conexão, ligue o serviço a outro. A conexão cria sozinha as variáveis de acesso, como REDIS_HOST, REDIS_PORT e REDIS_PASSWORD para um Redis. Depois de conectar, reimplante o serviço.

A aba mostra também as Conexões Ativas e quem usa este serviço (Usado por).

O endereço público

Ao publicar, a aplicação ganha um endereço HTTPS como https://meu-app-x7k2.kymus.app. Ele fica na aba Config, em Domínio. Clique nele para abrir o serviço numa nova aba.

• A porta em que a aplicação escuta é detectada sozinha. Se a detecção errar, clique em Editar ao lado do endereço.
• Tornar privado: tira o endereço público. O serviço continua rodando, acessível só pela rede interna. Para voltar a ter endereço, clique em Gerar domínio.

Usar o seu domínio

Além do endereço grátis, o serviço pode responder num domínio seu, como app.minhaempresa.com.br ou o próprio minhaempresa.com.br. O endereço grátis continua funcionando, sem redirecionar para o novo.

Há dois caminhos, e a tela pergunta qual é o seu:

	Domínio que já está na Kymus	Domínio em outro provedor
Quando usar	O domínio foi adicionado ao painel e os nameservers apontam para a Kymus	O DNS do domínio fica em outro lugar e você não quer mudar os nameservers
O que você faz	Escolhe o domínio numa lista	Cria um registro CNAME no DNS do seu domínio
Domínio principal (minhaempresa.com.br)	Sim	Não, só subdomínio (app.minhaempresa.com.br)
Tempo até funcionar	Menos de um minuto	Alguns minutos depois de criar o registro

Antes de começar

• O serviço precisa ter o endereço público. Se ele estiver privado, clique antes em Gerar domínio.
• Cada serviço usa um domínio próprio.

Domínio que já está na Kymus

O domínio precisa estar adicionado ao painel e apontado para a Kymus pelos nameservers. Veja Adicionar um domínio.

1. Abra o serviço e vá em Config → Domínio.
2. Clique em Usar meu domínio. Em Onde fica o DNS do seu domínio?, escolha Na Kymus.
3. Em Subdomínio, escreva o nome, como app. Deixe em branco para usar o domínio principal.
4. Em Domínio, escolha o seu domínio. O painel mostra o endereço final antes de ligar.
5. Clique em Ligar domínio.

O painel cria sozinho o registro no DNS e emite o certificado. Enquanto isso, aparece Emitindo certificado…, o que costuma levar menos de um minuto. Quando aparece Ativo, o endereço vira link, e o card do serviço no projeto passa a mostrá-lo no lugar do grátis.

Domínio em outro provedor

Use este caminho quando o DNS do domínio fica em outra empresa. Os nameservers continuam onde estão; você só cria um registro.

1. Abra o serviço e vá em Config → Domínio.

2. Clique em Usar meu domínio. Em Onde fica o DNS do seu domínio?, escolha Em outro provedor.

3. Em Endereço, escreva o subdomínio completo, como app.minhaempresa.com.br.

4. Clique em Ligar domínio. O painel mostra o registro a criar:

   Tipo	Nome	Destino
   CNAME	o endereço que você escreveu	o destino mostrado na tela

5. No painel de DNS do seu provedor, crie esse registro. Se houver a opção de proxy, deixe desligada nesse registro.

Depois disso não é preciso fazer mais nada. A tela acompanha sozinha e mostra em que etapa está:

O que aparece	O que significa
Aguardando o registro	O registro ainda não foi visto. Depois de criado, pode levar alguns minutos
Emitindo certificado…	O registro foi encontrado e o certificado está sendo emitido. Costuma levar de 1 a 5 minutos
Finalizando…	O certificado está pronto e o servidor está começando a responder
Ativo	O endereço vira link e já pode ser usado

O endereço ainda não abre enquanto o certificado não sai

Entre criar o registro e aparecer Ativo, o endereço novo ainda não abre em HTTPS. O endereço grátis segue funcionando normalmente nesse intervalo. Se o endereço já recebe visitas hoje em outro lugar, faça a troca num horário de pouco movimento.

O domínio principal não entra por este caminho, porque ele não aceita registro CNAME. Para usar minhaempresa.com.br, adicione o domínio ao painel e aponte os nameservers.

Quando o endereço não é aceito

O endereço precisa estar livre. O painel recusa quando ele já é usado por:

• um site ou um Jump;
• outro serviço;
• um registro no DNS que aponta para outro lugar (no caminho do domínio que já está na Kymus). Escolha outro subdomínio, ou remova o registro na tela de DNS e tente de novo.

No caminho do outro provedor, o painel também recusa o domínio principal e os endereços de um domínio que já está na Kymus: para esses, use a lista do primeiro caminho.

O que acontece depois

Você faz	O que acontece com o seu domínio
Tornar privado	Sai do ar junto com o endereço grátis, e aparece Fora do ar. Volta sozinho quando você clicar em Gerar domínio
Editar a porta	Acompanha a porta nova, sem fazer nada
Remover	O registro criado pela Kymus no DNS é apagado. O endereço grátis continua
Excluir o serviço	O registro criado pela Kymus no DNS é apagado junto

No caminho do outro provedor, o registro CNAME é seu e fica no seu DNS: ao remover o domínio ou excluir o serviço, apague-o também por lá.

As páginas do serviço no seu domínio não ficam guardadas em cache: o que a aplicação responde é o que o visitante vê.

Rede interna

Os serviços do mesmo projeto conversam entre si pela rede interna, sem passar pela internet. Em Config, na seção Rede Interna, fica o endereço do serviço para os outros o chamarem, como http://meu-app-x7k2:3000. Ele não muda entre um deploy e outro.

Acessar um banco de fora

Por padrão, os bancos só aceitam conexões da rede interna. Para conectar de um programa no seu computador, ligue Acesso externo (TCP) em Config. O host e a porta aparecem em Conexão.

O banco fica exposto à internet

Use senhas fortes, conecte com TLS sempre que possível, e desligue o acesso externo quando não precisar mais dele.