grpc go

GRPC-GO

La implementación GO de GRPC: un marco RPC general de alto rendimiento, código abierto y RPC que pone primero a Mobile y HTTP/2. Para obtener más información, consulte los documentos GO GRPC o salte directamente al inicio rápido.

Requisitos previos

• GO : Cualquiera de los dos últimos lanzamientos importantes .

Instalación

Simplemente agregue la siguiente importación a su código y luego go [build|run|test] obtendrá automáticamente las dependencias necesarias:

 import "google.golang.org/grpc"

Nota: Si está intentando acceder a grpc-go desde China , consulte las preguntas frecuentes a continuación.

Obtenga más información

• GO GRPC Docs, que incluyen un inicio rápido y una referencia de API entre otros recursos
• Documentos técnicos de bajo nivel de este repositorio
• Punto de referencia de rendimiento
• Ejemplos

Preguntas frecuentes

Errores de tiempo de espera de E/S

El dominio golang.org puede estar bloqueado de algunos países. go get generalmente produce un error como el siguiente cuando esto sucede:

$ go get -u google.golang.org/grpc
package google.golang.org/grpc: unrecognized import path "google.golang.org/grpc" (https fetch: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)

Para construir el código GO, hay varias opciones:

• Configure una VPN y acceda a Google.golang.org a través de eso.

• Con soporte del módulo GO: es posible usar la función replace de go mod para crear alias para paquetes golang.org. En el directorio de su proyecto:

  go mod edit -replace=google.golang.org/grpc=github.com/grpc/grpc-go@latest
  go mod tidy
  go mod vendor
  go build -mod=vendor

  Una vez más, esto deberá hacerse para todas las dependencias transitivas alojadas en golang.org también. Para más detalles, consulte el problema de Golang/Go #28652.

Error de compilación, indefinido: Grpc.SupportPackageIsversion

Actualice a la última versión de GRPC-GO usando go get google.golang.org/grpc .

Cómo encender el registro

El registrador predeterminado está controlado por variables de entorno. Enciende todo así:

$ export GRPC_GO_LOG_VERBOSITY_LEVEL=99
$ export GRPC_GO_LOG_SEVERITY_LEVEL=info

El RPC falló con Error "code = Unavailable desc = transport is closing"

Este error significa que la conexión que el RPC está utilizando se cerró, y hay muchas razones posibles, que incluyen:

1. Credenciales de transporte mal configuradas, la conexión falló en el apretón de manos
2. bytes interrumpidos, posiblemente por un proxy en el medio
3. apagado del servidor
4. Los parámetros KeepAlive causaron el apagado de la conexión, por ejemplo, si ha configurado su servidor para terminar las conexiones regularmente para activar las búsquedas DNS. Si este es el caso, es posible que desee aumentar su MaxConnectionAgeGrace, para permitir que finalizaran las llamadas RPC más largas.

Puede ser complicado depurar esto porque el error ocurre en el lado del cliente, pero la causa raíz de la conexión cerrada está en el lado del servidor. Encienda el registro tanto en el cliente como en el servidor , y vea si hay algún error de transporte.