Cloud Functions cambió de nombre a Cloud Run Functions. Para obtener más información, consulta la entrada de blog sobre Cloud Run Functions.

Crea una Cloud Function de 1a gen. con Google Cloud CLI

En esta página, se muestra cómo crear y, luego, implementar una función de Cloud Functions de primera generación con Google Cloud CLI.

Antes de comenzar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Functions and Cloud Build APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Functions and Cloud Build APIs.

Enable the APIs

Instala e inicializa gcloud CLI
Actualiza los componentes de gcloud:
```
gcloud components update
```

¿Necesitas un símbolo del sistema? Puedes usar Google Cloud Shell. Google Cloud Shell es un entorno de línea de comandos que ya incluye Google Cloud CLI, por lo que no es necesario que lo instales. Google Cloud CLI también viene preinstalado en las máquinas virtuales de Google Compute Engine.

Prepara tu entorno de desarrollo.

Node.js

Ir a la guía de configuración de Node.js

Python

Ir a la guía de configuración de Python

Go

Ir a la guía de configuración de Go

Java

Ir a la guía de configuración de Java

C#

Ir a la guía de configuración de .NET

Ruby

Ir a la guía de configuración de Ruby

PHP

Ir a cómo usar PHP en Google Cloud

Obtenga el código de muestra

Clona el repositorio de muestra en tu máquina local:
Node.js
```
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.
Python
```
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.
Go
```
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.
Java
```
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.
C#
```
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.
Ruby
```
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.
PHP
```
git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
```
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.

Ve al directorio que contiene el código de muestra de Cloud Functions, como sigue:

Node.js

cd nodejs-docs-samples/functions/helloworld/

Python

cd python-docs-samples/functions/helloworld/

Go

cd golang-samples/functions/helloworld/

Java

cd java-docs-samples/functions/helloworld/helloworld/

C#

cd dotnet-docs-samples/functions/helloworld/HelloWorld/

Ruby

cd ruby-docs-samples/functions/helloworld/get/

PHP

cd php-docs-samples/functions/helloworld_get/

Ve el código de muestra:

Node.js

const functions = require('@google-cloud/functions-framework');

// Register an HTTP function with the Functions Framework that will be executed
// when you make an HTTP request to the deployed function's endpoint.
functions.http('helloGET', (req, res) => {
  res.send('Hello World!');
});

Python

import functions_framework

@functions_framework.http
def hello_get(request):
    """HTTP Cloud Function.
    Args:
        request (flask.Request): The request object.
        <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>
    Returns:
        The response text, or any set of values that can be turned into a
        Response object using `make_response`
        <https://flask.palletsprojects.com/en/1.1.x/api/#flask.make_response>.
    Note:
        For more information on how Flask integrates with Cloud
        Functions, see the `Writing HTTP functions` page.
        <https://cloud.google.com/functions/docs/writing/http#http_frameworks>
    """
    return "Hello World!"

Go


// Package helloworld provides a set of Cloud Functions samples.
package helloworld

import (
	"fmt"
	"net/http"
)

// HelloGet is an HTTP Cloud Function.
func HelloGet(w http.ResponseWriter, r *http.Request) {
	fmt.Fprint(w, "Hello, World!")
}

Java


package functions;

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 HelloWorld implements HttpFunction {
  // Simple function to return "Hello World"
  @Override
  public void service(HttpRequest request, HttpResponse response)
      throws IOException {
    BufferedWriter writer = response.getWriter();
    writer.write("Hello World!");
  }
}

C#

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

namespace HelloWorld;

public class Function : IHttpFunction
{
    public async Task HandleAsync(HttpContext context)
    {
        await context.Response.WriteAsync("Hello World!", context.RequestAborted);
    }
}

Ruby

require "functions_framework"

FunctionsFramework.http "hello_get" do |_request|
  # The request parameter is a Rack::Request object.
  # See https://www.rubydoc.info/gems/rack/Rack/Request

  # Return the response body as a string.
  # You can also return a Rack::Response object, a Rack response array, or
  # a hash which will be JSON-encoded into a response.
  "Hello World!"
end

PHP


use Psr\Http\Message\ServerRequestInterface;

function helloGet(ServerRequestInterface $request): string
{
    return 'Hello, World!' . PHP_EOL;
}

Implementa una función

Para implementar la función con un activador HTTP, ejecuta el siguiente comando en el directorio que contiene la función:

Node.js

gcloud functions deploy helloGET \
--runtime nodejs20 --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 la función.

Python

gcloud functions deploy hello_get \
--runtime python312 --trigger-http

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

Go

gcloud functions deploy HelloGet \
--runtime go121 --trigger-http

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

Java

gcloud functions deploy java-helloworld \
--entry-point functions.HelloWorld \
--runtime java17 \
--memory 512MB --trigger-http

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

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet6 --trigger-http

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

Rita

gcloud functions deploy hello_get --runtime ruby32 --trigger-http

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

PHP

 gcloud functions deploy helloGet --runtime php82 --trigger-http

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

De forma opcional, puedes usar la marca --allow-unauthenticated para acceder a la función sin autenticación. Esto es útil para realizar pruebas, pero no se recomienda usar esta configuración en producción, a menos que crees una API pública o un sitio web. Además, es posible que no funcione en tu caso, según la configuración de tu política corporativa. Consulta Autentica para la invocación para obtener detalles sobre cómo invocar una función que requiere autenticación.

Prueba la función

Cuando la función termine de implementarse, toma nota de la propiedad httpsTrigger's url o búscala con el siguiente comando:

Node.js

gcloud functions describe helloGET

Python

gcloud functions describe hello_get

Go

gcloud functions describe HelloGet

Java

gcloud functions describe java-helloworld

C#

gcloud functions describe csharp-helloworld

Ruby

gcloud functions describe hello_get

PHP

gcloud functions describe helloGet

Se verá de la siguiente manera:

Node.js

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGET

Python

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

Go

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloGet

Java

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/java-helloworld

C#

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/csharp-helloworld

Ruby

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

PHP

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGet

Visita esta URL en tu navegador. Deberías ver un mensaje de Hello World!.

Borra la función

Si deseas borrar la función, ejecuta el siguiente comando:

Node.js

gcloud functions delete helloGET

Python

gcloud functions delete hello_get

Go

gcloud functions delete HelloGet

Java

gcloud functions delete java-helloworld

C#

gcloud functions delete csharp-helloworld

Ruby

gcloud functions delete hello_get

PHP

gcloud functions delete helloGet

¿Qué sigue?

Consulta la guía relevante Tu primera función para el entorno de ejecución que elijas, de modo que aprendas a configurar tu entorno de desarrollo, crear una nueva función desde cero, especificar dependencias, implementar tu función, probar tu función y ver los registros. Ten en cuenta que estas guías son solo para Cloud Functions (1st gen):