> For the complete documentation index, see [llms.txt](https://docs.skail.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skail.dev/construir/portal/environments.md).

# Environments

Referência da área Environments do portal: criar, obter chave, namespace e URL base, e o que um environment isola.

## O que é

O estágio do ciclo de vida dentro de um projeto: `dev`, `hml`, `prod`. É a fronteira de isolamento: workloads publicados em um environment só recebem execuções destinadas a ele; execuções e eventos não cruzam environments; o Monitor é segmentado por environment.

## Identidade técnica

| Valor           | Formato                    | Vai para                                                           |
| --------------- | -------------------------- | ------------------------------------------------------------------ |
| Namespace       | `tenant/environment` (ids) | `SKAIL_NAMESPACE` no runtime; header `Skail-namespace` na API HTTP |
| Chave           | segredo gerado pelo portal | `SKAIL_KEY` no runtime; header `skail-key` na API HTTP             |
| URL base da API | `https://...`              | Usada por quem dispara trigger e fire.                             |

A chave só autoriza o environment a que pertence: chave de `dev` com namespace de `prod` é recusada (401/403). Revogar uma chave leva até um minuto para valer em todas as chamadas.

## Operações

| Operação                        | Onde                                                                                 | Observação                                                      |
| ------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| Criar environment               | Dentro do projeto, menu Environment, Novo Environment                                | Nome livre; use `dev`, `hml`, `prod`                            |
| Ver namespace, chave e URL base | Tela do environment                                                                  | Copie para a configuração da aplicação e do sistema que dispara |
| Rotacionar ou revogar a chave   | Ver [Chaves: criar, rotacionar, revogar](/operar/chaves-criar-rotacionar-revogar.md) | A revogação vale em até um minuto                               |

## O que muda por environment

Só as três credenciais acima e os recursos externos que a sua aplicação usa (banco, APIs). O build da aplicação é o mesmo; a promoção de `hml` para `prod` é trocar variáveis. Ver [Ambientes e promoção](/operar/readme.md).

## Veja também

[Projetos, environments, namespaces e workloads](/aprender/arquitetura/projetos-environments-namespaces-e-workloads.md), [Autenticação e headers](/construir/api-http/autenticacao-e-headers.md), [Segurança](/aprender/garantias/seguranca.md).