> 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/variaveis-de-ambiente-do-runtime.md).

# Variáveis de ambiente do runtime

Referência das configurações que o runtime precisa para subir, com nome e descrição. O guia com contexto está em [Como configurar o runtime](/construir/configurar-e-hospedar/como-configurar-o-runtime.md).

## Origem

Variáveis de ambiente com prefixo `SKAIL_`, ou seção `skail` do `appsettings.json` e `appsettings.{DOTNET_ENVIRONMENT}.json` com a chave em minúsculo sem o prefixo (`SKAIL_WORKLOAD` → `skail:workload`). Variável de ambiente sobrescreve arquivo.

## Variáveis

| Variável          | Descrição                                                                                                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SKAIL_WORKLOAD`  | `nome:versao` da aplicação (`faturamento:v1.0.0`). Monta o endereço `nome:versao/Metodo` de cada function e command; precisa bater com o workload publicado e com o caminho do trigger |
| `SKAIL_NAMESPACE` | Namespace do environment, `tenant/environment`. Enviado no header `skail-namespace`                                                                                                    |
| `SKAIL_KEY`       | Chave do environment. Enviada no header `skail-key`. Segredo                                                                                                                           |
| `SKAIL_SIDECAR`   | Endereço do skail com quem o runtime conversa. Valor fornecido para o environment, como a chave e o namespace                                                                          |

As quatro são obrigatórias.

## Não lidas pelo runtime

`SKAIL_BASE_URL` aparece nos exemplos como a URL base da API HTTP usada por quem dispara trigger e fire. É configuração do sistema chamador, não do runtime.

## Exemplo

{% tabs %}
{% tab title="Variáveis de ambiente" %}

```bash
SKAIL_WORKLOAD=faturamento:v1.0.0
SKAIL_NAMESPACE=<tenant/environment>
SKAIL_KEY=<chave>
SKAIL_SIDECAR=<endereço do skail>
```

{% endtab %}

{% tab title="appsettings.json" %}

```json
{
  "skail": {
    "workload": "faturamento:v1.0.0",
    "namespace": "<tenant/environment>",
    "key": "<chave>",
    "sidecar": "<endereço do skail>"
  }
}
```

{% endtab %}
{% endtabs %}

## Veja também

[Como configurar o runtime](/construir/configurar-e-hospedar/como-configurar-o-runtime.md), [Como hospedar](/construir/configurar-e-hospedar/como-hospedar-worker-service-asp.net-core-container-kubernetes-azure.md), [Ambientes e promoção](/operar/readme.md).