Function Compute:HTTP トリガーで gRPC を使用する

使用上の注意

課金方法

前提条件

• ローカルに Go 言語環境をインストールする必要があります。Function Compute は Go 1.x バージョンをサポートしています。最新バージョンを使用することをお勧めします。

• ローカルに Serverless Devs ツールをインストールして設定する必要があります。詳細については、「クイックスタート」をご参照ください。

手順

1. 次のコマンドを実行してプロジェクトを初期化します。

   sudo s init fc-custom-golang-grpc -d fc-custom-golang-grpc

2. 次のコマンドを実行して、プロジェクトディレクトリ fc-custom-golang-grpc に移動します。

   cd fc-custom-golang-grpc

3. 現在のプロジェクトディレクトリで、s.yaml ファイルを編集します。

   以下は例です。

   edition: 3.0.0
   name: hello-world-app
   # 現在のアプリケーションに必要なキー情報を設定します。
   # キー設定の詳細については、https://www.serverless-devs.com/serverless-devs/command/config を参照してください
   # キーが使用される順序の詳細については、https://www.serverless-devs.com/serverless-devs/tool#密钥使用顺序与规范 を参照してください
   access: default  # キーのエイリアス。必要に応じて変更してください。
   
   resources:
     helloworld: # ビジネス名またはモジュール名。
       component: fc3
       actions: # カスタム実行ロジック。アクションの詳細については、https://www.serverless-devs.com/serverless-devs/yaml#行为描述 を参照してください
         pre-deploy: # デプロイ前に実行します。
           - run: go mod tidy
             path: ./code
           - run: GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o target/main main.go
             path: ./code
       props:
         region: cn-shanghai  # アプリケーションがデプロイされるリージョン。必要に応じて変更してください。
         functionName: "fc-custom-golang-grpc"
         handler: index.handler
         role: ''
         description: 'hello world by serverless devs'
         timeout: 60
         diskSize: 512
         internetAccess: true
         layers:
           - acs:fc:cn-shanghai:official:layers/Go1/versions/1
         customRuntimeConfig:
           port: 8089
           command:
             - ./main
         runtime: custom.debian10
         cpu: 0.35
         instanceConcurrency: 2
         memorySize: 512
         environmentVariables:
           PATH: >-
             /opt/Go1/bin:/usr/local/bin/apache-maven/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/ruby/bin:/opt/bin:/code:/code/bin
           LD_LIBRARY_PATH: >-
             /code:/code/lib:/usr/local/lib:/opt/lib:/opt/php8.1/lib:/opt/php8.0/lib:/opt/php7.2/lib
         code: ./code/target

4. sudo s deploy -y を実行して関数をデプロイします。

   コマンドが実行されると、関数は Function Compute にデプロイされます。Function Compute は、関数のテストに使用できるパブリックにアクセス可能な URL を生成します。

5. HTTP トリガーを作成し、そのパブリック URL を取得します。詳細については、「トリガーの作成」をご参照ください。

   

6. 次のコマンドを実行して、gRPC クライアントの実行に必要な依存関係をインストールします。

   go mod vendor

7. 次のコマンドを実行して gRPC クライアントを呼び出します。これにより、gRPC 呼び出しが開始され、関数がテストされます。

   fc-custang-grpc-*****.cn-shanghai.fcapp.run は、ステップ 5 で取得したトリガーのパブリック URL です。

   go run ./greeter_client -addr  fc-custang-grpc-*****.cn-shanghai.fcapp.run:8089

よくある質問

関数のエラー

クライアントがエラー rpc error: code = Internal desc = server closed the stream without sending trailers を返した場合、Function Compute サーバーが gRPC リクエストを異常に早期終了したことを示します。このタイプのエラーは関数のエラーです。たとえば、関数がタイムアウトする、関数プロセスが異常終了する、またはメモリ不足 (OOM) エラーが発生するなどです。関数のログでエラーの原因を確認し、エラーのトラブルシューティングを行うことができます。詳細については、「呼び出しログの表示」をご参照ください。

TLS プロトコルクライアントを使用しない GRPC リクエスト

var opts []grpc.DialOption
    cred := credentials.NewTLS(&tls.Config{
        InsecureSkipVerify: false,
    })
    opts = append(opts, grpc.WithTransportCredentials(cred))
    conn, err := grpc.Dial(*addr, opts...)

InsecureSkipVerify の値は、TLS 証明書の検証をスキップする場合は true に、TLS 証明書の検証をスキップしない場合は false に設定できます。