Configurar variables de entorno (1.ª gen.)

gcloud

Para definir una variable de entorno de tiempo de ejecución con la CLI de Google Cloud, usa la marca --set-env-vars en el momento de la implementación:

gcloud functions deploy --no-gen2 FUNCTION_NAME --set-env-vars FOO=bar FLAGS ...

También puedes definir varias variables de entorno de tiempo de ejecución mediante una lista separada por comas:

gcloud functions deploy --no-gen2 FUNCTION_NAME --set-env-vars FOO=bar,BAZ=boo FLAGS...

Si quieres almacenar tu configuración en un archivo (por ejemplo, en el control de código fuente), puedes usar un archivo YAML junto con la marca --env-vars-file:

gcloud functions deploy --no-gen2 FUNCTION_NAME --env-vars-file .env.yaml FLAGS...

donde el contenido del archivo .env.yaml es el siguiente:

 FOO: bar
 BAZ: boo

En los ejemplos anteriores, FLAGS... hace referencia a otras opciones que se transfieren durante el despliegue de la función. Para obtener una referencia completa del comando deploy, consulta gcloud functions deploy.

Interfaz de usuario de la consola de Google Cloud

Puedes definir variables de entorno de tiempo de ejecución durante la creación de la función en la consola Google Cloud :

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en Crear función.

3. Rellena los campos obligatorios de la función.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Tiempo de ejecución.

6. En la sección Variables de entorno de tiempo de ejecución, haz clic en Añadir variable y añade el nombre y el valor.

   Para obtener instrucciones sobre cómo añadir variables de entorno a una función, consulta el artículo Actualizar variables de entorno de tiempo de ejecución.

gcloud

Para actualizar una variable con Google Cloud CLI, usa la marca --update-env-vars en el momento de la implementación:

gcloud functions deploy FUNCTION_NAME --no-gen2 --update-env-vars FOO=bar

También puedes actualizar varias variables de entorno de tiempo de ejecución mediante una lista separada por comas:

gcloud functions deploy FUNCTION_NAME --no-gen2 --update-env-vars FOO=bar,BAZ=boo

Interfaz de usuario de la consola de Google Cloud

Para actualizar las variables de entorno de tiempo de ejecución mediante la consola Google Cloud , sigue estos pasos:

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en una función para ir a su página de detalles.

3. Haz clic en Editar.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Tiempo de ejecución.

6. Haz los cambios que quieras en la sección Variables de entorno de ejecución.

gcloud

Si quieres eliminar selectivamente variables de entorno de tiempo de ejecución, puedes usar la marca --remove-env-vars en el momento del despliegue:

gcloud functions deploy FUNCTION_NAME --no-gen2 --remove-env-vars FOO,BAZ

También puedes borrar todas las variables de entorno de tiempo de ejecución definidas anteriormente con la marca --clear-env-vars:

gcloud functions deploy FUNCTION_NAME --no-gen2 --clear-env-vars

Interfaz de usuario de la consola de Google Cloud

Para eliminar variables de entorno de ejecución mediante la consola Google Cloud , sigue estos pasos:

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en una función para ir a su página de detalles.

3. Haz clic en Editar.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Tiempo de ejecución.

6. En la sección Variables de entorno de tiempo de ejecución, haga clic en el icono de la papelera situado junto al par clave-valor que quiera eliminar.

Node.js

gcloud functions deploy envVar \
--runtime nodejs20 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID del entorno de ejecución de una versión compatible de Node.js para ejecutar tu función.

Python

gcloud functions deploy env_vars \
--runtime python312 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de Python compatible para ejecutar tu función.

Go

gcloud functions deploy EnvVar \
--runtime go121 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de Go compatible para ejecutar tu función.

Java

gcloud functions deploy java-envVar-function \
--entry-point functions.EnvVars \
--runtime java17 \
--memory 512MB \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de Java compatible para ejecutar tu función.

C#

gcloud functions deploy csharp-envVar-function \
--entry-point EnvironmentVariables.Function \
--runtime dotnet6 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de .NET compatible para ejecutar tu función.

Ruby

gcloud functions deploy env_vars --runtime ruby33 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de Ruby compatible para ejecutar tu función.

PHP

 gcloud functions deploy envVar --runtime php82 \
--set-env-vars FOO=bar \
--trigger-http

Usa la marca --runtime para especificar el ID de tiempo de ejecución de una versión de PHP compatible para ejecutar tu función.

Node.js

En Node.js, usa la propiedad process.env para acceder a las variables de entorno del tiempo de ejecución:

exports.envVar = (req, res) => {
  // Sends 'bar' as response
  res.send(process.env.FOO);
};

Python

En Python, usa os.environ para acceder a las variables de entorno de tiempo de ejecución:

import os


def env_vars(request):
    return os.environ.get("FOO", "Specified environment variable is not set.")

Go

En Go, usa os.Getenv() para acceder a las variables de entorno de tiempo de ejecución:

// Package tips contains tips for writing Cloud Functions in Go.
package tips

import (
	"fmt"
	"net/http"
	"os"
)

// EnvVar is an example of getting an environment variable in a Go function.
func EnvVar(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "FOO: %q", os.Getenv("FOO"))
}

Java

En Java, usa System.getenv para acceder a las variables de entorno de tiempo de ejecución:

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import java.io.BufferedWriter;
import java.io.IOException;

public class EnvVars implements HttpFunction {

  // Returns the environment variable "foo" set during function deployment.
  @Override
  public void service(HttpRequest request, HttpResponse response)
      throws IOException {
    BufferedWriter writer = response.getWriter();
    String foo = System.getenv("FOO");
    if (foo == null) {
      foo = "Specified environment variable is not set.";
    }
    writer.write(foo);
  }
}

C#

using Google.Cloud.Functions.Framework;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;

namespace EnvironmentVariables;

public class Function : IHttpFunction
{
    public async Task HandleAsync(HttpContext context)
    {
        string foo = Environment.GetEnvironmentVariable("FOO")
            ?? "Specified environment variable is not set.";
        await context.Response.WriteAsync(foo, context.RequestAborted);
    }
}

Ruby

require "functions_framework"

FunctionsFramework.http "env_vars" do |_request|
  ENV["FOO"] || "Specified environment variable is not set."
end

PHP

use Psr\Http\Message\ServerRequestInterface;

function envVar(ServerRequestInterface $request): string
{
    return getenv('FOO') . PHP_EOL;
}

gcloud

Para definir una variable con Google Cloud CLI, usa la marca --set-build-env-vars en el momento de la implementación:

gcloud beta functions deploy FUNCTION_NAME --no-gen2 --set-build-env-vars FOO=bar FLAGS...

También puedes definir varias variables de entorno de compilación mediante una lista separada por comas:

gcloud functions deploy FUNCTION_NAME --no-gen2 --set-build-env-vars FOO=bar,BAZ=boo FLAGS...

Si quieres almacenar tu configuración en un archivo (por ejemplo, en un sistema de control de versiones), puedes usar un archivo YAML junto con la marca --build-env-vars-file:

gcloud functions deploy FUNCTION_NAME --no-gen2 --build-env-vars-file FILE_NAME.yaml FLAGS...

donde el contenido del archivo *.yaml es el siguiente:

 FOO: bar
 BAZ: boo

En los ejemplos anteriores, FLAGS... hace referencia a otras opciones que se transfieren durante el despliegue de la función. Para consultar una referencia completa del comando deploy, consulta gcloud beta functions deploy.

Interfaz de usuario de la consola de Google Cloud

También puedes definir variables de entorno de compilación durante la creación de la función en la consola Google Cloud :

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en Crear función.

3. Rellena los campos obligatorios de la función.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Crear.

6. En la sección Variables de entorno de compilación, haz clic en Añadir variable y añade el nombre y el valor.

gcloud

Para definir una variable con Google Cloud CLI, usa la marca --update-build-env-vars en el momento de la implementación:

gcloud functions deploy FUNCTION_NAME --no-gen2 --update-build-env-vars FOO=bar

También puedes actualizar varias variables de entorno de compilación mediante una lista separada por comas:

gcloud functions deploy FUNCTION_NAME --no-gen2 --update-build-env-vars FOO=bar,BAZ=boo

Interfaz de usuario de la consola de Google Cloud

Para actualizar las variables de entorno de compilación mediante la consola Google Cloud , sigue estos pasos:

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en una función para ir a su página de detalles.

3. Haz clic en Editar.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Crear.

6. Haz los cambios que quieras en la sección Variables de entorno de desarrollo.

gcloud

Si quieres eliminar de forma selectiva las variables de entorno de compilación, puedes usar la marca --remove-build-env-vars en el momento del despliegue:

gcloud functions deploy FUNCTION_NAME --no-gen2 --remove-build-env-vars FOO,BAZ

También puedes borrar todas las variables de entorno de compilación definidas anteriormente con la marca --clear-build-env-vars:

gcloud functions deploy FUNCTION_NAME --no-gen2 --clear-build-env-vars

Interfaz de usuario de la consola de Google Cloud

Para eliminar variables de entorno de compilación mediante la consola Google Cloud , sigue estos pasos:

1. Abre la página Información general de Functions en la Google Cloud consola:

   Ve a la página Información general de Cloud Run Functions.

2. Haz clic en una función para ir a su página de detalles.

3. Haz clic en Editar.

4. Abre la sección Configuración de tiempo de ejecución, compilación y conexiones.

5. Selecciona la pestaña Crear.

6. En la sección Variables de entorno de compilación, haga clic en el icono de la papelera situado junto al par clave-valor que quiera eliminar.