프록시리스 gRPC 서비스 설정
이 가이드에서는 Mesh
및 GRPCRoute
리소스로 프록시리스 gRPC 서비스 메시를 설정하는 방법을 설명합니다.
시작하기 전에
Envoy 및 프록시리스 워크로드 설정 준비를 읽고 문서에 설명된 기본 요건을 완료해야 합니다.
Mesh
리소스 구성
프록시리스 gRPC 애플리케이션이 xds://hostname
에 연결되면 gRPC 클라이언트 라이브러리가 Cloud Service Mesh에 연결을 설정합니다. 클라이언트 라이브러리는 이 연결을 사용해서 호스트 이름에 대해 요청을 라우팅하는 데 필요한 라우팅 구성을 가져옵니다.
프록시리스 gRPC 애플리케이션이 이 메시와 연관된 구성을 요청하기 위해 사용하는 키인 Mesh
리소스 이름을 기록해 두어야 합니다.
Mesh
사양을 만들고 mesh.yaml이라는 파일에 저장합니다.name: grpc-mesh
mesh.yaml
사양을 사용해서Mesh
리소스를 만듭니다.gcloud network-services meshes import grpc-mesh \ --source=mesh.yaml \ --location=global
Mesh
리소스가 생성되었으면 Cloud Service Mesh가 구성을 제공할 준비가 되었지만 아직 정의된 서비스가 없으므로, 구성이 비어 있습니다. 다음 섹션에서는 서비스를 정의하고 이를 Mesh
리소스에 연결합니다.
gRPC 서버 구성
여기서는 데모용으로 관리형 인스턴스 그룹에서 자동 확장된 VM으로 백엔드 서비스를 만듭니다. VM은 포트 50051
에서 gRPC 프로토콜을 사용하여 hello world
구문을 제공합니다.
포트
50051
에 노출된helloworld
gRPC 서비스로 Compute Engine VM 인스턴스 템플릿을 만듭니다.gcloud compute instance-templates create grpc-td-vm-template \ --scopes=https://www.googleapis.com/auth/cloud-platform \ --tags=allow-health-checks \ --image-family=debian-10 \ --image-project=debian-cloud \ --metadata-from-file=startup-script=<(echo '#! /bin/bash set -e cd /root sudo apt-get update -y sudo apt-get install -y openjdk-11-jdk-headless curl -L https://github.com/grpc/grpc-java/archive/v1.38.0.tar.gz | tar -xz cd grpc-java-1.38.0/examples/example-hostname ../gradlew --no-daemon installDist sudo systemd-run ./build/install/hostname-server/bin/hostname-server')
템플릿을 기반으로 관리형 인스턴스 그룹을 만듭니다.
gcloud compute instance-groups managed create grpc-td-mig-us-east1 \ --zone=ZONE \ --size=2 \ --template=grpc-td-vm-template
gRPC 서비스의 이름이 지정된 포트를 만듭니다. 이름이 지정된 포트는 gRPC 서비스가 요청을 리슨하는 포트입니다. 다음 예시에서 이름이 지정된 포트는
50051
입니다.gcloud compute instance-groups set-named-ports grpc-td-mig-us-east1 \ --named-ports=grpc-helloworld-port:50051 \ --zone=ZONE
gRPC 상태 점검을 만듭니다. 서비스는 gRPC 상태 점검이 제대로 작동할 수 있도록 gRPC 상태 점검 프로토콜을 구현해야 합니다. 자세한 내용은 상태 점검을 참조하세요.
gcloud compute health-checks create grpc grpc-helloworld-health-check \ --use-serving-port
네트워크의 인스턴스에 대한 상태 점검 연결을 허용하는 방화벽 규칙을 만듭니다.
gcloud compute firewall-rules create grpc-vm-allow-health-checks \ --network=default \ --action=ALLOW \ --direction=INGRESS \ --source-ranges=35.191.0.0/16,130.211.0.0/22 \ --target-tags allow-health-checks \ --rules=tcp:50051
INTERNAL_SELF_MANAGED
의 부하 분산 스킴과 함께 전역 백엔드 서비스를 만들고 백엔드 서비스에 상태 확인을 추가합니다. 여기에서 지정된 포트는 관리형 인스턴스 그룹에서 VM 연결을 위해 사용됩니다.gcloud compute backend-services create grpc-helloworld-service \ --global \ --load-balancing-scheme=INTERNAL_SELF_MANAGED \ --protocol=GRPC \ --port-name=grpc-helloworld-port \ --health-checks grpc-helloworld-health-check
관리형 인스턴스 그룹을 백엔드 서비스에 추가합니다.
gcloud compute backend-services add-backend \ grpc-helloworld-service \ --instance-group=grpc-td-mig-us-east1 \ --instance-group-zone=ZONE \ --global
Mesh
리소스 및 서비스가 구성됩니다. 다음 섹션에서는 라우팅을 설정합니다.
GRPCRoute
로 라우팅 설정
이제 다음 안내를 따라 라우팅을 설정합니다.
GRPCRoute
사양을 만들고grpc_route.yaml
이라는 파일에 저장합니다.PROJECT_ID
또는PROJECT_NUMBER
를 사용할 수 있습니다.name: helloworld-grpc-route hostnames: - helloworld-gce meshes: - projects/PROJECT_NUMBER/locations/global/meshes/grpc-mesh rules: - action: destinations: - serviceName: projects/PROJECT_NUMBER/locations/global/backendServices/grpc-helloworld-service
grpc_route.yaml
사양을 사용해서GrpcRoute
리소스를 만듭니다.gcloud network-services grpc-routes import helloworld-grpc-route \ --source=grpc_route.yaml \ --location=global
Cloud Service Mesh는 관리형 인스턴스 그룹의 백엔드에서 GRPCRoute
리소스에 지정된 서비스의 트래픽을 부하 분산하도록 구성되었습니다.
gRPC 클라이언트 만들기
프록시리스 gRPC 애플리케이션을 인스턴스화하고 이를 Cloud Service Mesh에 연결하여 구성을 확인할 수 있습니다. 부트스트랩 파일에서 애플리케이션은 메시에 표시된 VPC 네트워크를 지정해야 합니다.
구성이 완료되면 xds:///helloworld-gce
서비스 URI를 사용해서 애플리케이션이 helloworld-gce
와 연관된 인스턴스 또는 엔드포인트에 요청을 전송할 수 있습니다.
다음 예시에서는 grpcurl 도구를 사용해서 gRPC 서비스를 테스트합니다.
클라이언트 VM 만들기
gcloud compute instances create grpc-client \ --zone=ZONE\ --scopes=https://www.googleapis.com/auth/cloud-platform \ --image-family=debian-10 \ --image-project=debian-cloud \ --metadata-from-file=startup-script=<(echo '#! /bin/bash set -e export GRPC_XDS_BOOTSTRAP=/run/td-grpc-bootstrap.json echo export GRPC_XDS_BOOTSTRAP=$GRPC_XDS_BOOTSTRAP | sudo tee /etc/profile.d/grpc-xds-bootstrap.sh curl -L https://storage.googleapis.com/traffic-director/td-grpc-bootstrap-0.16.0.tar.gz | tar -xz ./td-grpc-bootstrap-0.16.0/td-grpc-bootstrap --config-mesh-experimental grpc-mesh | tee $GRPC_XDS_BOOTSTRAP')
부트스트랩 파일 설정
클라이언트 애플리케이션에 부트스트랩 구성 파일이 있어야 합니다. 이전 섹션의 시작 스크립트는 GRPC_XDS_BOOTSTRAP
환경 변수를 설정하고 도우미 스크립트를 사용하여 부트스트랩 파일을 생성합니다.
VM 인스턴스에 대한 이러한 세부정보를 알고 있는 메타데이터 서버에서 생성된 부트스트랩 파일에 있는 TRAFFICDIRECTOR_GCP_PROJECT_NUMBER
및 영역의 값을 가져옵니다. --gcp-project-number
옵션을 사용하여 이러한 값을 도우미 스크립트에 수동으로 제공할 수 있습니다. --config-mesh-experimental
옵션을 사용하여 Mesh
리소스와 일치하는 메시 이름을 제공해야 합니다.
구성을 확인하려면 클라이언트 VM에 로그인하고 다음을 실행합니다.
SSH로 클라이언트 VM에 연결합니다.
gcloud compute ssh grpc-client
grpcurl
도구를 다운로드하고 설치합니다.curl -L https://github.com/fullstorydev/grpcurl/releases/download/v1.8.1/grpcurl_1.8.1_linux_x86_64.tar.gz | tar -xz
xds:///helloworld-gce
를 서비스 URI로,helloworld.Greeter/SayHello
를 호출할 서비스 이름과 메서드로 사용하여grpcurl
도구를 실행합니다.SayHello
메서드에 대한 매개변수는-d
옵션을 사용하여 전달합니다../grpcurl --plaintext \ -d '{"name": "world"}' \ xds:///helloworld-gce helloworld.Greeter/SayHello
다음과 비슷한 출력이 표시됩니다. 여기서 INSTANCE_HOSTNAME
은 VM 인스턴스의 이름입니다.
Greeting: Hello world, from INSTANCE_HOSTNAME
이 출력은 프록시리스 gRPC 클라이언트가 성공적으로 Cloud Service Mesh에 연결되었고 xds
이름 리졸버를 사용하여 helloworld-gce
서비스의 백엔드를 알아보았음을 확인합니다.
클라이언트는 IP 주소 정보를 확인하거나 DNS 변환을 수행할 필요 없이 서비스의 백엔드 중 하나에 요청을 보냈습니다.
다음 단계
Mesh
또는Gateway
리소스와 연결된 경로 리소스 나열에 관한 자세한 내용은Route
리소스 나열을 참조하세요. 이 기능은 미리보기 버전으로 제공됩니다.