メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.jitera.ai/llms.txt

Use this file to discover all available pages before exploring further.

GitLab連携により、セルフマネージドGitLabリポジトリをJiteraプロジェクトのコードソースとして接続できます。ユーザーはJitera UIからPersonal Access Token（PAT）で認証します — Helmチャートの設定は不要です。
GitLab連携はユーザー認証には使用されません。Jiteraはメール/パスワード（Devise）およびオプションでSAML SSOをログインに使用します。

​
前提条件

  • バージョン16.8以降のセルフマネージドGitLabインスタンス
  • 管理者レベルのアクセス権を持つGitLabアカウント
  • **api**スコープのPersonal Access Token
  • KubernetesクラスターからGitLabインスタンスへのアウトバウンドHTTPS（ポート443）アクセス
セルフホストデプロイメントでは、GitLab.comは現在サポートされていません。セルフマネージドGitLabインスタンスのみ接続可能です。

​
Personal Access Tokenの作成

以下の手順は例として提供されています。最新の手順についてはGitLab Personal Access Tokenドキュメントを参照してください。
  1. 管理者ユーザーとしてGitLabインスタンスにログイン
  2. ユーザー設定 > アクセストークンに移動
  3. 以下の設定で新しいトークンを作成：
フィールド値
トークン名わかりやすい名前（例：Jitera Integration）
有効期限セキュリティポリシーに従って設定
スコープapi
  1. パーソナルアクセストークンを作成をクリック
  2. 生成されたトークンをコピー — 再表示されません
トークンは、接続したいリポジトリへの管理者アクセス権を持つアカウントのものである必要があります。apiスコープはフルAPIアクセスを付与し、リポジトリ操作に必要です。

​
JiteraでのGitLab接続

GitLab連携にHelmチャートの設定は不要です。接続はすべてJitera UIから設定します — 接続手順は コードソース を参照してください。プロンプトが表示されたらGitLabを選択し、セルフマネージドのホストURLと上記で作成したPersonal Access Tokenを入力します。

​
トラブルシューティング

​
認可の失敗

症状：GitLab接続の認可時にエラーが発生する 解決策：
  1. Personal Access Tokenが有効で期限切れでないことを確認
  2. トークンにapiスコープがあることを確認
  3. トークンがターゲットリポジトリへのアクセス権を持つアカウントのものであることを確認
  4. GitLabインスタンスのホスト名が正しく、到達可能であることを確認

​
リポジトリが表示されない

症状：認可後に期待されるリポジトリが表示されない 解決策：
  1. トークンの所有者がリポジトリにアクセスできることを確認
  2. GitLabでリポジトリの可視性設定を確認
  3. グループリポジトリの場合、トークンの所有者がグループに対して少なくともMaintainerアクセス権を持っていることを確認

​
SSL証明書エラー

症状：セルフマネージドGitLabへの接続時にSSL/TLSエラー 解決策：
  1. GitLabインスタンスが有効なSSL証明書を使用していることを確認
  2. カスタムCA証明書の場合、CAを信頼済みストアに追加します。Podへの追加CA証明書のマウント方法については、お使いのKubernetesディストリビューションのドキュメントを参照してください。

​
接続タイムアウト

症状：GitLabへの接続がタイムアウトする 解決策：
  1. KubernetesクラスターからGitLabインスタンスへのアウトバウンドHTTPS（ポート443）が許可されていることを確認
  2. ネットワークポリシーとファイアウォールルールを確認
  3. クラスター内からGitLabホスト名が正しく名前解決されることを確認： 
    kubectl exec -it deploy/jitera-automation-rails -n jitera -- nslookup gitlab.yourcompany.com

​
ネットワーク要件

KubernetesクラスターからGitLabインスタンスへのアウトバウンドHTTPS（ポート443）アクセスを確保してください。セルフマネージドGitLabを含む許可リストの全体は ネットワークとファイアウォール → サードパーティ連携 を参照してください。

​
関連ドキュメント

GitHub連携

GitHub連携の設定

インテグレーション概要

利用可能なすべてのインテグレーション

要件

デプロイ要件