Bitbucket アカウントを接続して、リポジトリからサイトをデプロイできるようにします。

連携によるメリット

Bitbucketを連携すると、Bitbucket Cloudリポジトリの1つからサイトをデプロイできるようになります。ブランチにプッシュするだけでサイトが更新されます。

開始前の準備

デプロイ対象のリポジトリにアクセスできるBitbucket Cloudアカウントが必要です。

1. Bitbucketでのキーの作成

Bitbucketでは2種類の認証情報が提供されており、どちらも使用できます。

• リポジトリ、プロジェクト、またはワークスペース用のアクセストークン： 対象のリポジトリ、プロジェクト、またはワークスペース固有の設定にあるアクセストークン（Access tokens）から作成します。個人ではなく、そのリポジトリ、プロジェクト、またはワークスペースに紐付けられます。リポジトリへの読み取りアクセス権を付与してください。
• AtlassianアカウントのAPIトークン： プロフィールを選択し、アカウント設定（Account settings） → セキュリティ（Security） → APIトークンの作成と管理（Create and manage API tokens） → スコープを指定したAPIトークンの作成（Create API token with scopes）の順に選択します。名前を付け、有効期限を設定し、アプリとしてBitbucketを選択し、リポジトリへの読み取りアクセス権を選択します。Bitbucketにトークンが一度だけ表示されるので、その時にコピーしてください。

2. ここでの連携

ダッシュボードで連携（Integrations）を開き、アカウントの連携（Connect an account）を選択します。グループとしてコードホスティング（Code hosting）を、アカウントとしてBitbucketを選択し、APIトークン（API token）を入力します。アクセストークンではなくAtlassianアカウントでトークンを作成した場合は、アカウントユーザー名（Account username）も入力して、アカウントを連携（Connect account）を押します。

保存する前に、貼り付けられた内容のテストが行​​われます。動作しないキーが保存されることはなく、何が問題だったのかがメッセージで表示されます。動作するキーはデータベース内ではなく、当社のシークレット・セキュア・ストレージに暗号化されて保存され、二度と再表示されることはありません（お客様に対しても表示されません）。

ユーザー名はトークンの送信方法を決定するため、アカウントトークンの場合にのみ入力してください。ユーザー名を入力したアクセストークン、またはユーザー名のないアカウントトークンは拒否されます。

次のステップ

• このアカウント上のリポジトリから直接サイトをデプロイできます。サイトのリポジトリ接続でそのリポジトリを選択し、リポジトリとブランチを選択すると、プッシュによってデプロイされます。
• 他のすべてのブランチで独自のプレビューを取得できるため、本番サイトに反映される前に変更内容を確認できます。
• RenderやAzure Static Web AppsなどのGitベースの静的ホスティングは、この接続をサイトのコードのソースとして使用します。

接続できない場合

リポジトリが見つからない場合： アクセストークンは、それが作成されたリポジトリ、プロジェクト、またはワークスペースにのみアクセスできます。必要なすべてのリポジトリをカバーするレベルで作成してください。

一度動作した後に停止した場合： 両方の種類のトークンに有効期限が切れる場合があります。新しいトークンを作成して接続してください。

キーが拒否されたと表示される場合： ほとんどの場合、次の3つのいずれかが原因です。コピー時にスペースまたは改行が含まれていた、有効期限が切れたキーである、またはコピーした後にキーが無効化されたか再生成された場合です。新しいキーを作成し、もう一度貼り付けてください。

接続は成功するが、後続の処理で失敗する場合： キーの認証は成功していますが、処理に必要な権限が不足しています。上記の権限を持つ新しいキーを作成し、古い接続を切断してから新しいキーを接続してください。

接続解除

連携（Integrations）を開き、該当するアカウントを見つけて接続解除（Disconnect）を押します。これにより、保存されているキーが即座に削除されます。それを使用していたものは次回の処理時に停止し、それに依存していた画面は、静かに失敗するのではなく、その旨を表示します。

接続解除しても、すでに実行された内容（お客様のアカウントで変更されたレコード、デプロイ、設定など）は元に戻りません。キー自体が漏洩した可能性があると思われる場合は、ベンダー側でも無効化してください。接続解除によって削除されるのは当社のコピーであり、ベンダー側のコピーではありません。