コンテンツにスキップ

プロバイダーのカスタマイズ

Terraformは、プロバイダーとして知られるモジュールを通じて、CloudflareなどのクラウドおよびグローバルネットワークプロバイダーAPIと通信します。これらのプロバイダーは、プロバイダーを含む.tfファイルがあるディレクトリでterraform initを実行すると自動的にインストールされます

通常、プロバイダーに必要なパラメーターは認証に必要なものだけです。しかし、ニーズに応じてプロバイダーをカスタマイズしたい場合もあります。次のセクションでは、Cloudflare Terraformプロバイダーに渡すことができるオプション設定について説明します。

デフォルトのCloudflareプロバイダー設定を調整する

Cloudflare Terraformプロバイダーは、.tf構成ファイルまたは環境変数(例:$CLOUDFLARE_RPS)で指定された構成パラメーターを使用してカスタマイズできます。環境変数を使用することは、CI/CDシステムからTerraformを実行する場合や、変更が一時的で構成履歴に保持する必要がない場合に適しているかもしれません。

APIリクエストの頻度を増加させる

api.cloudflare.comエンドポイントには、5分間に1,200回の呼び出し、または1秒あたり4リクエストのデフォルトレート制限があります(APIレート制限を参照)。Terraformは、定義された閾値を下回る必要があり、そうでない場合はCloudflare APIがHTTP 429 - Too Many Requestsのレスポンスを返します。この場合、Cloudflare Terraformプロバイダーは再試行する前にバックオフします。

エンタープライズ顧客は、アカウントチームに連絡することで制限の引き上げをリクエストできます。その後、Cloudflare Terraformプロバイダーを構成して、より速いレートでAPI呼び出しを行うことができます。たとえば、環境変数を設定することでAPIリクエストの頻度を増加させることができます:

Terminal window
# Terraformによって行われるAPI呼び出しのリクエスト毎秒(RPS)制限を削除します(デフォルト:4)。
export CLOUDFLARE_RPS=
# デフォルトのログライブラリロガーを使用してAPIクライアントからのログを印刷します(デフォルト:false)。
export CLOUDFLARE_API_CLIENT_LOGGING=true
# 失敗したAPI呼び出しの後の最大バックオフ期間(秒)(デフォルト:30)。
export CLOUDFLARE_MAX_BACKOFF=20