GitLabをNotionに接続する

WorkersはNotionのインフラストラクチャ上で同期を実行します。

以下の準備をしてください：

• Notionにある既存のGitLab同期データベース。Notion AIがアクセスできることを確認してください。

• 含めるGitLabプロジェクトの完全なリスト。プロジェクトのURL、数値ID、またはmy-team/my-projectのようなパスを指定できます。GitLabでプロジェクトを表示する方法をご覧ください。

• read_api権限を持ち、選択したすべてのプロジェクトにアクセスできるGitLabの個人用またはプロジェクトアクセストークン。

• Workersへのアクセス権、およびNotion AIがワークスペース内でWorkerを作成・デプロイするために必要なツール。

• Notionアカウントにコピーするこのスキルページ：GitLab Guide: Worker Sync。このスキルはGitLab.com用です。セルフマネージド型のGitLabインスタンスを使用している場合は、設定前にNotion AIに伝えてください。ガイドのAPIアドレスと認証情報の設定は、お使いのインスタンスに合わせて調整および検証する必要があります。

既存の同期データベースがあるワークスペースで、Notion AIとのチャットを開きます。

以下のプロンプトをコピーします。@Existing GitLab sync databaseの部分を、@と入力してメンションメニューから実際のデータベースを選択することで置き換えてください。課題とマージリクエストが別々の同期データベースにある場合は、両方をメンションしてください。

プロンプト内で実際のデータベースのメンションを選択してください。データベース名を入力するだけでは、Notion AIは調査するためのリンクを取得できません。

現在のNotionビューのフィルターで非表示になっているプロジェクトを含め、プロジェクトの全リストを確認してください。1つのプロジェクトに限定されたトークンでは、他のプロジェクトへのアクセスも必要な同期には不十分です。

Notion AIの指示に従い、安全な認証情報入力フォームを通じてGitLabトークンを提供してください。これにはread_apiと、選択したプロジェクトへのアクセス権が必要です。

トークンをチャット、Notionページ、またはデータベースのプロパティに貼り付けないでください。Workerは仲介された認証情報を使用するため、そのコードで生のトークンを読み取る必要はありません。

このセットアップでは、新しいWorker認証情報を使用します。既存のGitLabコネクションでは、自動的に提供されません。

Notion AIがスキルやWorkerツールにアクセスできない場合は、まずそのアクセス権限を解決してください。/リンクドガイドには、Notion CLIを使用できるチームメンバー向けのセットアップ手順も記載されています。

このスキルは、5つの同期されたデータベースとダッシュボードを含むプライベートなGitLab Syncページを作成します：

GitLabダッシュボードは、これらのレコードをチャートや作業キューにまとめます。これには、未解決の課題、未解決のマージリクエスト、失敗したパイプライン、最近のリリース、プロジェクトのアクティビティが含まれます。

5つの同期データベースにレコードが格納されます。ダッシュボードには、それらのレコードのビューが表示されます。以前の課題またはマージリクエストのデータベースでは、このスキルの/デフォルト設定よりも扱えるデータ型が少なかった可能性があります。

切り替える前に、以下の違いを確認してください：

• ユーザーとラベル： 作成者、担当者、およびラベルは、このガイドでは/テキストとして保存されます。これらはNotionのユーザーやマルチセレクトプロパティではありません。

• プロジェクトのリレーション: イシュー、マージリクエスト、パイプライン、およびリリースは、選択したプロジェクトレコードにリンクさせる必要があります。

• レコードの識別: 異なるプロジェクトのレコードは、同じプロジェクトローカルのイシュー番号やマージリクエスト番号を使用している場合でも、個別に区別される必要があります。

• 追加コンテンツ: このガイドでは、イシューのコメント、マージリクエストのディスカッション、リポジトリファイル、またはジョブログは同期されません。既存のワークフローに必要な追加フィールドがある場合は、Notion AIに評価を依頼してください。

5つの同期すべてが正常であり、初期インポートが完了したことをNotion AIが確認するまでお待ちください。

1. 選択した各プロジェクトをGitLabと比較してください。オープンおよびクローズされたイシュー、マージされたリクエスト、パイプライン、リリースのサンプルを確認してください。

2. プロジェクトのリレーションとダッシュボードビューに期待通りのレコードが表示されていることを確認してください。

3. 更新が成功した後、GitLabでの最近の変更が置き換え先に反映されていることを確認してください。

4. 古いデータベースのカスタムプロパティとNotion固有の値をNotion AIで確認してください。必要なものは、安定したGitLabレコードIDを使用して転送してください。

5. 置き換え先を使用するように、リンク、リンクドデータベースビュー、リレーション、およびオートメーションを更新してください。新しいページの共有権限を確認してください。

6. チームが置き換え先を使用し始めたら、Notion AIに依頼して、古いデータベースを参照用に残したまま、古い同期を停止してください。

Workerを使用するために古いデータベースを削除する必要はありません。チームの情報とワークフローがすべて移行されたことを確認するまで、そのまま保持してください。

このスキルは、データ型ごとに1つずつ、計5つの1時間ごとの同期を設定します。セットアップ中にプロジェクトが最初に同期されるため、他のデータベースはレコードを適切なプロジェクトに関連付けることができます。

更新が成功するたびに、設定されたプロジェクトのすべての結果ページが読み取られ、対応するNotionデータベースが更新されます。Notionを閉じてもWorkerは実行され続けます。

更新はGitLabからNotionへ反映されます。同期された値を変更する場合はGitLabで行ってください。Notionでの変更はGitLabに書き戻されません。

1時間ごとのスケジュールですが、すべての更新が一定時間内に完了することを保証するものではありません。プロジェクトの履歴が膨大な場合やGitLabのリクエスト制限により、完了が遅れることがあります。

このスキルは、プライベートの GitLab Sync ページから始まります。インポートされたレコードを閲覧すべき人のみに共有してください。

Notionの権限が同期されたデータへのアクセスを制御します。GitLabプロジェクトの Visibility プロパティやイシューの Confidential プロパティは、Notionにおいてそのソースの権限を強制するものではありません。ページを共有する前に、トークンによって含まれるデータを確認してください。

完全なプロジェクトリストとトークンアクセスを確認してください。パスが変更されている場合は、Notion AIにプロジェクトのURLまたは数値IDを伝えてください。アクセスエラーを回避するためだけに、リストを短縮して更新を実行しないでください。

Notion AIに、プロジェクトの選択状況、すべての状態のイシューとマージリクエストを確認しているか、および結果のすべてのページを確認しているかを依頼してください。Notionビューのフィルターも確認してください。

ダッシュボードを再構築する前に、Notion AIにソースデータベース、最新の同期結果、およびプロジェクトのリレーションを確認するよう依頼してください。初期インポートの実行中は、ダッシュボードが空になることがあります。

他のものを作成する前に、Notion AIに既存のWorker、データベースURL、およびページ構造を調査するよう依頼してください。このスキルでは、GitLab Syncの下に5つの実際の同期済みデータベースと1つのダッシュボードが必要です。Notion AIに重複を特定させてから削除してください。

Notion AIに、Workerの最新の実行状況、トークンの有効期限、トークンの権限、および選択したすべてのプロジェクトへのアクセス権を確認するよう依頼してください。セルフマネージドインスタンスの場合は、設定されたGitLabホストも確認してください。リクエスト制限により、更新が遅延する場合があります。

• 他のツールからNotionにデータを同期する

• Asanaを接続する