Function Compute:カスタムドメイン名による gRPC プロトコルのサポート

使用上の注意

呼び出し方法

• ドメイン名: サブドメイン *.<region_id>fcapp.run またはカスタムドメイン名を使用して gRPC 関数を呼び出すことができます。レガシードメイン名 fc.aliyuncs.com は gRPC 関数の呼び出しをサポートしていません。

  説明

  カスタムドメイン名を関数にバインドする場合、リクエストパスと関数のマッピング関係を設定する必要があります。リクエストパスを /* として設定することをお勧めします。これにより、すべての gRPC リクエストが対応する gRPC 関数に転送されます。 gRPC 関数は、クライアントによって定義された gRPC メソッドにリクエストをルーティングします。

• ポート: gRPC リクエストのポートは 8089 です。

トランスポートセキュリティ

• gRPC リクエストのセキュリティを確保するため、Function Compute のオンライン環境では、TLS プロトコルを使用するクライアントのみがサポートされています。そうでない場合、リクエストはエラー rpc error: code = Unavailable desc = connection closed before server preface received を返します。

• カスタムドメイン名は、カスタム HTTPS 証明書をサポートしています。 Function Compute ゲートウェイ層で TLS 検証が実行されるため、gRPC サーバーで TLS 証明書の検証を定義する必要はありません。

リクエストタイムアウト制御

gRPC リクエストの最大タイムアウト期間は、関数の [実行タイムアウト] を超えることはできません。 デフォルトの [実行タイムアウト] は 60 秒で、最大値は 86400 秒です。

リクエストの同時実行制御

gRPC リクエストは、Function Compute の同時実行制御の対象となります。 gRPC リクエストは、同時実行クォータを消費します。 gRPC プロトコルは HTTP/2 に基づいています。 Function Compute では、関数インスタンスの場合、この関数インスタンスに割り当てられた gRPC リクエストは同じ HTTP/2 接続を再利用します。したがって、この HTTP/2 接続での同時フローの数は、インスタンスの同時実行数と同じです。関数インスタンスの同時実行数を設定して、インスタンスごとの最大同時リクエスト数を制御できます。詳細については、「インスタンスの同時実行数を設定する」をご参照ください。

負荷分散

Function Compute は、gRPC リクエストを異なるインスタンスに分散し、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
   # access は、現在のアプリケーションに必要なキー情報を指定します。
   # キーの設定方法の詳細については、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/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. ローカルで次のコマンドを実行して、gRPC クライアントを実行するために必要な依存関係をインストールします。

   go mod vendor

6. カスタムドメイン名を関数にバインドします。詳細については、「カスタムドメイン名を設定する」をご参照ください。

7. ローカルで次のコマンドを実行して、gRPC クライアントを呼び出し、gRPC 呼び出しを開始し、関数をテストします。

   コマンドを実行する前に、${your-custom-domain} をカスタムドメイン名に置き換えます。

   go run ./greeter_client -addr ${your-custom-domain}:8089  

その他の例

FAQ

関数のエラー

クライアントが 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 の値は、true に設定して TLS 証明書の検証をスキップするか、false に設定して TLS 証明書の検証をスキップしないようにすることができます。