Ir al contenido
↑↓ moverse↵ abriresc cerrar

Ambientes

Ambientes

Qué es un ambiente, cómo crear, renombrar, colorear y eliminar uno, y cómo elegir el ambiente activo.

4 min de lectura

Un ambiente guarda lo que cambia entre los lugares donde corre tu API, como local y producción. Lo necesitas en cuanto ejecutas un workflow o envías un request contra una API real.

Cada ambiente es un archivo pequeño. El mismo request, {{baseUrl}}/customers, va a un lugar distinto en cada uno:

environments/local.yaml
name: local
color: green
servers:
baseUrl: http://localhost:8080

{{baseUrl}}/customers se convierte en http://localhost:8080/customers.

Parte Qué es
URLs base La dirección de cada API en este ambiente, por ejemplo https://api.tienda.test.
Credenciales Los valores que piden los contratos: un token, un usuario y contraseña, una API key.
Variables Valores que reutilizas como {{nombre}}, por ejemplo un ID de cliente.
Secretos Variables para claves y tokens. Sus valores nunca van a los archivos del workspace.
Color de la etiqueta Un color para distinguir los ambientes de un vistazo.

Los ambientes son de la colección abierta. Cada colección tiene su propia lista y siempre tiene al menos un ambiente.

Un ambiente abierto, con sus URLs base, credenciales, variables y secretos

Lugar Qué encuentras
Barra lateral La sección Ambientes, al final, con el nombre de la colección abierta. El activo tiene su punto relleno
Barra de ejecución de un workflow El selector Ambiente, junto a API real y Simulación
Barra inferior El nombre del ambiente activo, a la derecha. Haz clic en él para abrir el ambiente

El ambiente activo es el que Luvin usa en cada ejecución, en cada request y en Try it out de un contrato.

  1. En la barra lateral, en Ambientes, haz clic en un ambiente.
  2. Queda activo y se abre en una pestaña con el título Ambiente «nombre».

Para cambiar sin salir de un workflow, usa el selector Ambiente de la barra de ejecución. Su última opción, Configurar ambiente…, abre el ambiente activo. Luvin recuerda en este equipo el ambiente activo de cada colección.

  1. En la barra lateral, haz clic en + (Nuevo ambiente) en Ambientes. Dentro de un ambiente abierto también puedes hacer clic en + Nuevo.
  2. Se agrega un ambiente llamado Nuevo ambiente, que queda activo.
  3. Escribe su nombre y pulsa Enter.

El ambiente nuevo es una copia del activo: las mismas URLs base y variables. De los secretos copia solo los nombres. Las credenciales no se copian. Solo cambias lo que difiere.

  1. Abre el ambiente.
  2. Haz doble clic en su nombre, en la fila de ambientes de arriba, o haz clic en Renombrar.
  3. Escribe el nombre nuevo y pulsa Enter. Pulsa Esc para cancelar.
  1. Abre el ambiente.
  2. Junto a Color de la etiqueta, haz clic en un color: gris, verde, azul, morado, amarillo, naranja o rojo. La primera opción quita el color.

El color se ve en la barra lateral, en el selector Ambiente y en la barra inferior. Una elección común: local en verde, integración en amarillo, producción en rojo.

  1. Pasa el mouse sobre el ambiente y abre su menú ⋯.
  2. Elige Eliminar ambiente….
  3. Confirma con Eliminar.

Al eliminar un ambiente también se borran de este equipo sus credenciales y sus secretos.