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

連携によるメリット

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

開始する前に

デプロイ対象のリポジトリへのアクセス権を持つ Bitbucket Cloud アカウントが必要です。

1. Bitbucket でキーを作成する

Bitbucket は2種類の認証情報を提供しており、どちらもご利用いただけます。

• リポジトリ、プロジェクト、またはワークスペースのアクセストークン。該当するリポジトリ、プロジェクト、またはワークスペース自体の設定のアクセストークンから作成します。個人ではなく、そのリポジトリ、プロジェクト、またはワークスペースに紐付けられます。リポジトリへの読み取りアクセス権を付与してください。
• Atlassian アカウントの API トークン。プロフィールを選択し、アカウント設定 → セキュリティ → API トークンの作成と管理 → スコープ付き API トークンの作成の順に進みます。名前を入力し、有効期限を設定し、アプリとして Bitbucket を選択して、リポジトリへの読み取りアクセス権を選択します。Bitbucket はトークンを一度だけ表示しますので、その際にコピーしてください。

2. こちらで連携する

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

保存処理が行われる前に、貼り付けられた内容がテストされます。機能しないキーは保存されず、応答メッセージで問題の内容が示されます。機能するキーは機密情報保管庫 (シークレットボルト) に暗号化されて保持され (当社のデータベースには一切保存されません)、お客様に対してであっても二度と表示されません。

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

次のステップ

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

接続できない場合

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

動作していたものが停止した場合。 どちらの種類のトークンにも有効期限が存在します。新しいトークンを作成して連携してください。

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

接続はされるが、その後の処理で失敗する場合。 キーの認証には成功しているものの、アクションに必要な権限が不足しています。上記の必要な権限を持つ新しいキーを作成し、古い接続を解除してから新しいキーを連携してください。

連携の解除

連携を開き、該当のアカウントを見つけて連携を解除を押します。これにより、保存されていたキーは直ちに削除されます。そのキーを使用していたすべての処理は次回のアクション時に停止し、依存していた画面ではエラーがサイレントに失敗することなくその旨が表示されます。

連携を解除しても、すでに実行された処理が取り消されることはありません。お客様のアカウントで当社が変更したレコード、デプロイ、設定はそのまま残ります。キー自体が漏洩した恐れがある場合は、提供元のベンダー側でも失効手続きを行ってください。連携の解除によって削除されるのは当社のコピーであり、提供元のものではありません。