> 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/referencia/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](/opere/configurar-e-hospedar/configurar-o-runtime.md).

## Origem

Variáveis de ambiente com prefixo `SKAIL_`. Em C#, também a seção `skail` do `appsettings.json` e do `appsettings.{DOTNET_ENVIRONMENT}.json`, com a chave em minúsculo sem o prefixo (`SKAIL_WORKLOAD` → `skail:workload`); variável de ambiente sobrescreve arquivo. Em TypeScript, o host (`createSkailPlatform`) é configurado pelas variáveis `SKAIL_*`, e um valor passado no código para `createSkailPlatform` tem prioridade sobre a variável.

## 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. Em TypeScript, também precisa ser igual ao `--workload` do `skail build` |
| `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.

## Opcional

| Variável                   | Padrão | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SKAIL_MAX_PARALLEL_TASKS` | `1`    | Quantas execuções o processo processa ao mesmo tempo. Use um inteiro maior ou igual a 1. Com o padrão, cada processo processa uma execução por vez e as outras prontas para rodar aguardam em Na fila; execuções em delay, esperando evento ou esperando uma function filha não ocupam vaga. Os commands que a execução roda em paralelo com a espera por todos usam a vaga dela; cada function filha é outra execução e ocupa uma vaga enquanto roda. Em C#, um valor que não seja inteiro é ignorado e vale 1, e 0 ou negativo faz o processo subir sem processar nenhuma execução; no Time Travel Debug vale sempre 1. Em TypeScript, também pode ser passada como `maxConcurrentActivations` no `createSkailPlatform`, e um valor que não seja inteiro maior ou igual a 1 lança `RangeError` ao criar a plataforma |

## 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. É o endereço do environment, sem `/api/v1` no final; as duas rotas começam com `/api/v1`. É 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>
SKAIL_MAX_PARALLEL_TASKS=8
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

## Veja também

[Como configurar o runtime](/opere/configurar-e-hospedar/configurar-o-runtime.md), [Como hospedar](/opere/configurar-e-hospedar/container-kubernetes-e-azure.md), [Ambientes e promoção](/opere/configurar-e-hospedar/ambientes-e-promocao.md).