# Configurar ambientes > Um ambiente é um conjunto de variáveis — URL base, tokens, headers — que você troca de uma vez. Defina um para local, staging e produção, e alterne entre eles sem tocar em nenhuma requisição. ## Criar um ambiente 1. Aperte ⌘⇧E para abrir **Manage Environments**, ou escolha pela pílula **● ENV** na ponta direita da barra de ferramentas. 2. Toque em **New environment**. Ele aparece na lista já em modo renomear; escreva um nome — `Staging`, `Production` — e aperte ↩. O ponto colorido é derivado do nome, então o mesmo nome sempre recebe a mesma cor. 3. Adicione variáveis à direita: uma **KEY**, um **VALUE**, e se a linha está **Enabled** e é **Secret**. `BASE_URL` e `API_KEY` costumam ser as duas primeiras. Você também pode começar pela paleta: ⌘K e *New Environment…*. Os ambientes pertencem ao workspace em que você está. O primeiro já vem com um chamado **Default**, que contém o `baseUrl` usado pelas requisições de exemplo. ## Usar variáveis em uma requisição Envolva o nome em chaves duplas em qualquer campo: URL, parâmetros de query, headers, body, campos de auth. O Mariner resolve o valor contra o ambiente ativo na hora de enviar.

POST barra de URL

```text {{BASE_URL}}/launch/v1/manifests?key={{API_KEY}} ``` Com **Staging** ativo, `{{BASE_URL}}` resolve para `https://staging.acme-labs.dev`. Troque para **Production** e as mesmas requisições apontam para o servidor real. Abaixo do campo de URL, uma linha de prévia mostra a URL exata que vai sair pela rede, com os segredos mascarados; o botão de copiar ao lado copia a real. No campo, a **cor de um token diz o estado dele** e a sintaxe `{{ }}` / `:` diz de que família ele é — então os dois jeitos de estar quebrado ficam iguais nas duas: - **Violeta** {{token}} — resolvido pela cascata de ambientes. - **Azul** :slug — uma variável de path desta requisição, preenchida. - **Âmbar** {{token}} · :slug — declarado, mas com valor vazio. Substitui por nada, o que apaga um segmento do caminho sem avisar. - **Vermelho** {{token}} · :slug — não está declarado em lugar nenhum. Vai literal pela rede. Passar o cursor por um token mostra seu valor e de qual camada ele vem.

VARIÁVEIS · {{baseUrl}} do ambiente, :code de Params — resolvidas logo abaixo do campo

## Trocar de ambiente Três jeitos, do mais rápido ao mais visual: - ⌘E abre o seletor de qualquer tela — setas até o ambiente, ↩. - ⌘K e digite o nome do ambiente: *Switch Environment › Production*. - Clique na pílula **● ENV** da barra de ferramentas. Escolher **No Environment** deixa em jogo apenas as variáveis locais da requisição. Ao trocar de workspace, o Mariner mantém ativo o ambiente de mesmo nome, se o novo workspace tiver um. ## Gerenciar variáveis Clique com o botão direito em uma variável no gerenciador para **Duplicate**, **Copy to Environment ▸**, **Move to Environment ▸** e **Delete**. Copiar ou mover para outro ambiente substitui lá a variável de mesma chave — útil para promover um valor de Staging para Production. Clique com o botão direito em um ambiente para **Rename**, **Duplicate** (com variáveis) e **Delete**.

O Mariner se recusa a enviar uma requisição que ainda contém um {{token}} ou um :slug sem resolver, e diz quais são. E não precisa enviar para descobrir: o chip {} abaixo do campo de URL leva a contagem de tokens, e fica âmbar com um ⚠ e o número de variáveis que não contribuem com nada. Abra ele e cada token quebrado tem um **Define** ao lado. Para um {{token}} isso abre o gerenciador de ambientes já na linha daquela variável — criando a linha quando a variável ainda não existe, no ambiente que a cascata apontou — com o cursor em VALUE. Para um :slug abre a seção Path Variables da aba Params. O painel de resposta oferece o mesmo conserto depois de um envio bloqueado.

--- Source: https://marinerhttp.dev/pt-br/docs/environments · Mariner docs