プロジェクト設定

設定ページを使用して、プロジェクトの設定オプションを管理します。

プロジェクトの設定を見る

プロジェクトの設定を表示するには、少なくともメンテナーのロールを持っている必要があります。

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. セクション内のすべての設定を表示するには、[展開] を選択します。
  4. オプション。検索ボックスを使用して設定を検索します。

プロジェクト名と説明の編集

プロジェクトの詳細を編集するには、プロジェクトの一般設定を使用します。

  1. 少なくともメンテナーのロールで GitLab にサインインしてください。
  2. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  3. 設定] > [全般]を選択します。
  4. プロジェクト名テキストボックスに、プロジェクト名を入力します。
  5. プロジェクトの説明テキストボックスに、プロジェクトの説明を入力します。
  6. プロジェクトアバターで、プロジェクトアバターを変更するには、「ファイルを選択」を選択します。

プロジェクトへのトピックの割り当て

トピックを使用してプロジェクトを分類し、類似した新規プロジェクトを検索します。

プロジェクトにトピックを割り当てるには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定>一般を選択します。
  3. トピック] テキストボックスに、プロジェクトのトピックを入力します。入力すると、人気のあるトピックが提案されます。
  4. 変更を保存を選択します。

インスタンス管理者の場合は、管理領域の [Pages] ページからすべてのプロジェクト トピックを管理できます。

note
割り当てられたトピックはプロジェクトにアクセスできるユーザーにのみ表示されますが、GitLabインスタンスに存在するトピックは誰でも見ることができます。トピックの名前に機密情報を含めないでください。

リポジトリ名の変更

プロジェクトのリポジトリ名は、その URL と GitLab がインストールされているファイルディスク上の場所を定義します。

前提条件:

リポジトリの名前を変更するには、プロジェクトのメンテナー、オーナー、または管理者でなければなりません。

note
リポジトリパスを変更した場合、ユーザーが古い URL にプッシュしたり、古い URL からプルしたりすると、イシューが発生する可能性があります。詳しくは、リポジトリ名変更時のリダイレクトをご覧ください。

リポジトリ名を変更するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. Change path(パスの変更)テキストボックスで、パスを編集します。
  5. パスの変更]を選択します。

プロジェクトの機能と権限の設定

プロジェクトの機能と権限を設定します:

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 可視性]、[プロジェクト機能]、[権限]を展開します。
  4. ユーザーがプロジェクトへのアクセスを要求できるようにするには、[ユーザーがアクセスを要求できる] チェックボックスをオンにします。
  5. プロジェクトの機能を有効または無効にするには、機能トグルを使用します。
  6. 変更を保存を選択します。

機能を無効にすると、以下の追加機能も無効になります:

  • イシュー機能を無効にすると、プロジェクトユーザーはイシュー機能を使用できなくなります:

    • イシュー・ボード
    • サービスデスク
    • プロジェクト・ユーザーはマージ・リクエストからマイルストーンにアクセスできます。
  • イシューと マージリクエストを無効にすると、プロジェクトユーザーは使用できなくなります:

    • ラベル
    • マイルストーン
  • リポジトリを無効にすると、プロジェクトユーザーはアクセスできなくなります:

    • マージリクエスト
    • CI/CD
    • コンテナレジストリ
    • Git ラージファイルストレージ
    • パッケージ
  • メトリクス・ダッシュボードにアクセスするには、プロジェクトの環境とデプロイを読む必要があります。メトリクス・ダッシュボードにアクセスできるユーザーは、環境とデプロイメントにもアクセスできます。

プロジェクトのマージリクエスト設定

プロジェクトのマージリクエスト設定を行います:

マージ時にソースブランチを削除するようにしました。

マージリクエストで、ソースブランチを削除するチェックボックスが常に選択されるように、デフォルトの動作を変更することができます。

このデフォルトを設定するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定 > マージリクエストを選択します。
  3. デフォルトで “ソースブランチを削除” オプションを有効にします。
  4. 変更を保存を選択します。

プロジェクトのエクスポート

プロジェクトとそのデータをエクスポートできます。

プロジェクトを別のネームスペースに転送します。

プロジェクトを別のネームスペースに移動すると、プロジェクトは別のグループに移動します。

前提条件:

  • 移籍先のグループのメンテナー以上のロールを持っている必要があります。
  • 移管するプロジェクトのオーナーでなければなりません。
  • グループは新規プロジェクトの作成を許可している必要があります。
  • プロジェクトにコンテナイメージが含まれていないこと。
  • npm パッケージを削除します。プロジェクトを別のルート名前空間に転送する場合、プロジェクトに npm パッケージが含まれていてはなりません。ユーザーやグループのパスを更新する場合、またはサブグループやプロジェクトを転送する場合は、最初に npm パッケージを削除する必要があります。npm パッケージを含むプロジェクトのルート名前空間を更新することはできません。命名規則に従って .npmrc ファイルを更新し、必要に応じて npm publish を実行してください。
  • プロジェクトにセキュリティポリシーが割り当てられている場合は、転送中に自動的に割り当てが解除されます。

プロジェクトを転送するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. プロジェクトを転送] で、プロジェクトを転送するネームスペースを選択します。
  5. プロジェクトの転送… を選択します。
  6. プロジェクト名を入力し、「確認」を選択します。

プロジェクトの新しいページにリダイレクトされ、GitLab がリダイレクトを適用します。リポジトリのリダイレクトについて詳しくは、リポジトリのパスが変更されたときに起こることをご覧ください。

note
管理者であれば、管理インターフェイスを使ってプロジェクトを任意のネームスペースに移動することもできます。

GitLab SaaS プロジェクトを異なるサブスクリプション階層に移動する方法

GitLab SaaS PremiumまたはUltimateでライセンスされたネームスペースからGitLab Freeにプロジェクトを移行すると、以下の有料機能データは削除されます:

プロジェクトをアーカイブ

プロジェクトをアーカイブすると、リポジトリ、パッケージ、イシュー、マージリクエスト、その他すべての機能が読み取り専用になります。アーカイブされたプロジェクトは、プロジェクト一覧からも非表示になります。

プロジェクトをアーカイブするには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. Archive projectセクションで、Archive projectを選択します。
  5. 確認するには、OK を選択します。

プロジェクトのアーカイブ解除

プロジェクトのアーカイブを解除すると、読み取り専用の制限が解除され、プロジェクトリストで利用できるようになります。

前提条件:

  • プロジェクトのアーカイブを解除するには、管理者またはプロジェクトオーナーである必要があります。
  1. アーカイブされたプロジェクトを検索します。
    1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
    2. View all my projects を選択します。
    3. プロジェクトを見るを選択します。
    4. プロジェクトの並べ替え] ドロップダウン リストで、[アーカイブされたプロジェクトを表示] を選択します。
    5. Filter by nameフィールドにプロジェクト名を入力します。
    6. プロジェクトリンクを選択します。
  2. 左サイドバーで、設定 > 一般を選択します。
  3. 詳細設定]で[展開]を選択します。
  4. Unarchive project] セクションで、[Unarchive project] を選択します。
  5. 確認するには、OK を選択します。

プロジェクトの削除

  • GitLab 12.6で、プロジェクトのデフォルト削除動作が遅延削除に変更されました。
  • GitLab 13.2でプロジェクトのデフォルト削除の動作を即時削除に変更しました。
  • GitLab 16.0で、PremiumとUltimate階層のプロジェクトのデフォルト削除動作を遅延削除に変更しました。
  • GitLab.comのPremiumとUltimate階層、およびGitLab 16.0のセルフマネージドにおいて、デフォルトの削除動作を遅延削除に変更しました。

プロジェクトに削除マークを付けることができます。

前提条件

  • プロジェクトのオーナーロールを持っている必要があります。

プロジェクトを削除するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. Delete this projectセクションで、Delete projectを選択します。
  5. 確認ダイアログで、プロジェクト名を入力し、Yes, delete project を選択します。

このアクションにより、プロジェクトと関連リソース(イシューやマージリクエストなど)がすべて削除されます。

プロジェクトの遅延削除

グループ内のプロジェクト(個人のネームスペースではない)は、遅延時間の後に削除することができます。

自己管理インスタンスでは、グループ管理者は削除遅延期間を1~90日の間で定義できます。SaaSの場合、調整不可のデフォルトの保存期間は7日間です。

プロジェクトの即時削除

遅れて削除されるのを待ちたくない場合は、プロジェクトをすぐに削除することができます。そのためには、プロジェクトを削除する手順をもう一度実行してください。

プロジェクトを削除する最初のサイクルでは、プロジェクトは遅延削除キューに移され、保持期間が過ぎると 自動的に削除されます。この遅延削除時間中に 2 回目の削除サイクルを実行すると、プロジェクトは即座に削除されます。

前提条件:

削除マークが付いたプロジェクトをすぐに削除するには:

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. Delete this projectセクションで、Delete projectを選択します。
  5. 確認ダイアログで、プロジェクト名を入力し、Yes, delete project を選択します。

プロジェクトの復元

GitLab 12.6 で導入されました

削除マークのついたプロジェクトを復元するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 詳細設定] を展開します。
  4. Restore projectセクションで、Restore projectを選択します。

プロジェクトにコンプライアンス フレームワークを追加します。

コンプライアンスフレームワークを持つグループのプロジェクトにコンプライアンス フレームワークを追加できます。

LDAP グループによるプロジェクト アクセスの管理

LDAPを使用してグループメンバーシップを管理できます。

プロジェクトのアクセス管理に LDAP グループを使用することはできません。

前提条件:

  1. プロジェクトのメンバーシップを追跡するグループを作成します。
  2. そのグループのLDAP同期を設定します。
  3. LDAP グループを使用してプロジェクトへのアクセスを管理するには、LDAP 同期グループをプロジェクトのメンバとして追加します。

イシューでCVE識別子のリクエストを無効にします。

GitLab 13.4 で導入。GitLab.com の公開プロジェクトのみ。

環境によっては、ユーザーはイシューでCVE識別子のリクエストを提出することができます。

プロジェクトのイシューでCVE識別子のリクエストオプションを無効にするには、次のようにしてください:

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 可視性]、[プロジェクト機能]、[権限]を展開します。
  4. イシュー]で、[イシューサイドバー]トグルの[CVE IDリクエスト]をオフにします。
  5. 変更を保存を選択します。

プロジェクトのEメール通知を無効にします。

前提条件:

  • プロジェクトに関するメール通知を無効にするには、プロジェクトのオーナーである必要があります。
  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定] > [全般]を選択します。
  3. 可視性]、[プロジェクト機能]、[権限]を展開します。
  4. メール通知を無効にする]チェックボックスをオフにします。

トラブルシューティング

プロジェクト設定で作業していると、以下のようなイシューに遭遇したり、特定のタスクを完了するために別の方法が必要になることがあります。

コンソールからのプロジェクトの転送

UIやAPIからプロジェクトを転送してもうまくいかない場合は、Railsのコンソールセッションで転送を試みることができます。

p = Project.find_by_full_path('<project_path>')

# To set the owner of the project
current_user = p.creator

# Namespace where you want this to be moved
namespace = Namespace.find_by_full_path("<new_namespace>")

Projects::TransferService.new(p, current_user).execute(namespace)