Cloud Source Repositories からのデプロイ

Cloud Repositories

関数のソースコードを GitHub や Bitbucket などのソースリポジトリからデプロイする場合は、Google Cloud Source Repositories を使って、リポジトリのブランチやタグから直接関数をデプロイできます。

Cloud Source Repositories の設定

Cloud Source Repositories のスタート手順に沿って、リポジトリをセットアップします。
ミラーリングされたリポジトリガイドに沿って、GitHub リポジトリまたは Bitbucket リポジトリを接続します。

Cloud Source Repositories と外部リポジトリの接続が確立されると、これらのリポジトリは同期されるので、いつもどおりに、選択したリポジトリに commit できます。

gcloud ツールを使用したデプロイ

ソースリポジトリを読み取るには、アカウント（gcloud functions deploy を実行しているアカウント）が、リポジトリに対する継承された権限または直接の権限を持っている必要があります。これは、サービスアカウントとしてデプロイする場合や他のプロジェクトからデプロイする場合には特に重要です。gcf-robot アカウントと Cloud Build アカウントは、ソースリポジトリからの読み取りに使用されることはありません。これらは、関数をデプロイする実際のユーザーアカウントです。

ソースリポジトリから関数をデプロイするには、--source コマンドライン引数を使用します。

gcloud functions deploy NAME \
  --source https://source.developers.google.com/projects/PROJECT_ID/repos/REPOSITORY_ID/moveable-aliases/master/paths/SOURCE \
  --runtime RUNTIME \
  TRIGGER... \
  [FLAGS...]

このコマンドは、gcloud functions deploy に次の引数を使用します。

引数	説明
`NAME`	デプロイする Cloud Functions の関数の登録名。`NAME` には文字、数字、アンダースコア、ハイフンのみを使用できます。`NAME` は、ソースコード内の関数の名前にすることも、カスタム文字列（`my-http-function` など）にすることもできます。カスタム文字列を使用する場合は、`--entry-point` フラグを使用してコードに含まれる関数を指定し、実行する関数を `deploy` コマンドに指示する必要があります。
`--source PATH`	デプロイするソースコードの場所。この場所は、ソースリポジトリ、Google Cloud Storage 内のパス、またはローカルファイルシステムのパスにできます。詳しくは、`gcloud` コマンドリファレンスをご覧ください。
`--runtime RUNTIME`	使用しているランタイムの名前。網羅的なリストについては、`gcloud` リファレンスをご覧ください。関数を初めてデプロイする場合、このフラグを含める必要がありますが、後続のデプロイでは省略できます。
`TRIGGER...`	HTTP 関数を使用する場合は、`--trigger-http` フラグを使用します。イベントドリブン関数を使用する場合は、フラグ `--trigger-resource MY_RESOURCE` と `--trigger-event MY_EVENT` を使用します。イベントドリブン関数に Pub/Sub トリガーが割り当てられている場合は、短縮形の `--trigger-topic MY_TOPIC` を使用できます。同様に、Cloud Storage トリガーが割り当てられた関数をデプロイする場合は、`--trigger-bucket MY_STORAGE_BUCKET` フラグを使用すると、指定されたバケット内のファイルが変更されるたびに関数の実行をトリガーできます。
`FLAGS...`	（省略可）デプロイ時に追加で指定できるフラグ（たとえば、`--stage-bucket`、`--entry-point` など）。詳細については、`gcloud functions deploy` ドキュメントをご覧ください。