プロジェクトを管理する

GitLabでのほとんどの作業は、プロジェクト内で行われます。ファイルとコードはプロジェクトに保存され、ほとんどの機能はプロジェクトのスコーピング内にあります。

プロジェクトの概要

プロジェクトを選択すると、プロジェクトの概要ページにプロジェクトの次の内容が表示されます。

• リポジトリ内のファイル
• プロジェクト情報（プロジェクトの説明）
• トピック
• バッジ
• プロジェクト内のお気に入り、フォーク、コミット、ブランチ、タグ、リリース、環境の数
  • コミット数は、プロジェクトのデフォルトブランチから計算され、すべてのブランチからではありません。
• プロジェクトのストレージサイズ
• オプションのファイルと設定
• READMEまたはインデックスファイル
  • Wikiページ
  • ライセンス
  • 変更履歴
  • コントリビュートのガイドライン
  • Kubernetesクラスター
  • CI/CD設定
  • インテグレーション
  • GitLab Pages
• 作成日

パブリックプロジェクト、およびプロジェクトのコードを表示する権限を持つ内部プロジェクトとプライベートプロジェクトのメンバーの場合、プロジェクトの概要ページには以下が表示されます。

• READMEまたはインデックスファイル
• プロジェクトのリポジトリ内のディレクトリのリスト

プロジェクトのコードを表示する権限を持たないユーザーの場合、概要ページには以下が表示されます。

• Wikiのホームページ。
• プロジェクト内のイシューのリスト。

https://gitlab.example.com/projects/<id>で、名前の代わりにIDを使用してプロジェクトにアクセスできます。たとえば、パーソナルネームスペースalexにID 123456のプロジェクトmy-projectがある場合、https://gitlab.example.com/alex/my-projectまたはhttps://gitlab.example.com/projects/123456でプロジェクトにアクセスできます。

プロジェクトIDを見つける

プロジェクトでGitLab APIを使用して操作する場合、プロジェクトIDが必要になることがあります。

プロジェクトIDを見つけるには、次の手順を実行します。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. プロジェクトの概要ページの右上隅で、アクション（ ）を選択します。
3. プロジェクトIDをコピーを選択します。

プロジェクトを表示

プロジェクトリストを使用して表示します:

• インスタンス上のすべてのプロジェクト
• あなたが作業している、またはオーナーであるプロジェクト
• 非アクティブなプロジェクト。アーカイブされたプロジェクトや削除保留中のプロジェクトを含みます。

インスタンス上のすべてのプロジェクトを探索

あなたのGitLabインスタンス上のすべてのプロジェクトを表示します。アクティブ、非アクティブ、トレンドのプロジェクトでリストをフィルタリングします:

• アクティブなプロジェクトとは、最近のアクティビティまたは継続的な開発が行われているプロジェクトです。
• 非アクティブなプロジェクトとは、アーカイブされているか、削除予定のプロジェクトです。
• トレンドプロジェクトとは、過去30日間に受け取ったコメント数に基づいて人気があると考えられる公開プロジェクトです。

認証されていない場合、リストにはパブリックプロジェクトのみが表示されます。

あなたのGitLabインスタンス上のプロジェクトを表示するには:

1. 上部のバーで、検索または移動先を選択します。
2. 検索を選択します。
3. オプション。表示するプロジェクトをフィルタリングするには、タブを選択します。

あなたが作業するプロジェクトを表示

あなたが操作したプロジェクトを表示するには:

1. 上部のバーで、検索または移動先を選択します。
2. すべてのプロジェクトを表示を選択します。
3. オプション。オプション。表示されるプロジェクトをフィルタリングするタブを選択します:
   • コントリビュート済み: あなたが次の操作を行ったプロジェクト:
     • イシュー、マージリクエスト、またはエピックを作成したプロジェクト
     • イシュー、マージリクエスト、またはエピックにコメントしたプロジェクト
     • イシュー、マージリクエスト、またはエピックを完了したプロジェクト
     • コミットをプッシュしたプロジェクト
     • マージリクエストを承認したプロジェクト
     • マージリクエストをマージしたプロジェクト
   • Star付き: あなたがStar付きのプロジェクト
   • 個人: あなたのパーソナルネームスペースで作成されたプロジェクト
   • メンバー: あなたがメンバーであるプロジェクト
   • 非アクティブ: アーカイブされたプロジェクトとプロジェクト削除保留中

Star付きのプロジェクトおよび個人のプロジェクトは、個人プロフィールからも表示できます:

1. 右上のアバターを選択し、次にユーザー名を選択します。
2. 左サイドバーで、Star付きのプロジェクトまたはパーソナルプロジェクトを選択します。

非アクティブなプロジェクトを表示

プロジェクトは、削除保留中であるか、アーカイブされている場合に非アクティブになります。

すべての非アクティブなプロジェクトを表示するには:

1. 次のいずれかを選択します。
   • あなたのプロジェクトをフィルタリングするには、すべてのプロジェクトを表示。
   • 検索: アクセスできるすべてのプロジェクトをフィルタリングします。
2. 無効タブを選択します。

リスト内の各非アクティブなプロジェクトは、プロジェクトがアーカイブされているか削除保留中であることを示すバッジを表示します。

プロジェクトが削除保留中の場合、リストには以下も表示されます:

• プロジェクトが最終削除される予定の時刻
• 復元アクション。プロジェクトを復元すると:
  • The 削除保留中ラベルは削除されます。プロジェクトは削除予定から外されます。
  • プロジェクトは非アクティブタブから削除されます。

自分が所有するプロジェクトのみを表示する

自分がオーナーであるプロジェクトのみを表示するには:

1. 上部のバーで、検索または移動先を選択します。
2. 次のいずれかを選択します。
   • すべてのプロジェクトを表示: プロジェクトをフィルタリングします。
   • 検索: アクセスできるすべてのプロジェクトをフィルタリングします。
3. プロジェクトリストの上にある検索または結果をフィルタリングを選択します。
4. ロールドロップダウンリストで、オーナーを選択します。

プロジェクトアクティビティを表示する

プロジェクトのアクティビティを表示するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

2. 管理 > アクティビティを選択します。

3. オプション。コントリビュートの種類でアクティビティをフィルタリングするには、次のタブを選択します。

   • すべて: プロジェクトメンバーによるすべてのコントリビュート
   • プッシュイベント: プロジェクト内のプッシュイベント
   • マージイベント: プロジェクトで承認されたマージリクエスト
   • イシューイベント: プロジェクトでオープンおよびクローズされたイシュー
   • コメント: プロジェクトメンバーが投稿したコメント
   • デザイン: プロジェクトで追加、更新、削除されたデザイン
   • チーム: プロジェクトに参加および離脱したメンバー

GitLabは、パフォーマンス上の理由から、3年以上前のプロジェクトアクティビティイベントをイベントテーブルから削除します。

言語でプロジェクトをフィルタリングする

使用されているプログラミング言語でプロジェクトをフィルタリングできます。これを行うには、次の手順を実行します:

1. 上部のバーで、検索または移動先を選択します。
2. 次のいずれかを選択します。
   • すべてのプロジェクトを表示: プロジェクトをフィルタリングします。
   • 検索: アクセスできるすべてのプロジェクトをフィルタリングします。
3. プロジェクトリストの上にある検索または結果をフィルタリングを選択します。
4. 言語ドロップダウンリストで、プロジェクトのフィルタリングに使用する言語を選択します。

選択した言語を使用するプロジェクトのリストが表示されます。

プロジェクトにStarを付ける

頻繁に使用するプロジェクトにスターを付けて、見つけやすくすることができます。

プロジェクトにStarを付けるには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. ページの右上隅にあるStarを選択します。

プロジェクトを離脱する

プロジェクトを離脱すると、次のようになります。

• プロジェクトメンバーではなくなり、コントリビュートできなくなります。
• 割り当てられていたすべてのイシューとマージリクエストの割り当てが解除されます。

前提条件:

• プロジェクトがグループネームスペースのグループの一部である場合にのみ、この方法でプロジェクトを離脱できます。
• プロジェクトの直接メンバーである必要があります。

プロジェクトを離脱するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. プロジェクトの概要ページの右上隅で、アクション（ ）を選択します。
3. プロジェクトを離脱を選択し、もう一度プロジェクトを離脱を選択します。

あなたの作業リストビューから直接プロジェクトを離れるには:

1. 上部のバーで、検索または移動先を選択します。
2. すべてのプロジェクトを表示を選択します。
3. メンバータブで、離れたいプロジェクトを見つけ、縦方向の省略記号（ ）を選択します。
4. プロジェクトを離脱を選択します。

この操作は、他のリストされたページでも使用できます。

プロジェクトを編集する

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

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. プロジェクト名テキストボックスに、プロジェクト名を入力します。プロジェクト名の制限を参照してください。
4. オプション。プロジェクトの説明テキストボックスに、プロジェクトの説明を入力します。説明は2,000文字に制限されています。CI/CDカタログに公開されているコンポーネントには、プロジェクトの説明が必要です。
5. 変更を保存を選択します。

リポジトリの名前を変更する

プロジェクトのリポジトリ名は、そのURLを定義します。

前提条件:

• 管理者であるか、プロジェクトのメンテナーまたはオーナーのロールを持っている必要があります。

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

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. パスを変更テキストボックスで、パスを編集します。
5. パスを変更を選択します。

プロジェクトアバターを追加する

プロジェクトを視覚的に識別できるように、プロジェクトアバターを追加します。アバターを追加しない場合、GitLabはプロジェクト名の最初の文字をデフォルトのプロジェクトアバターとして表示します。

プロジェクトアバターを追加するには、次のいずれかの方法を使用します。

• あなたのリポジトリにロゴを追加します。
• プロジェクト設定でアバターをアップロードします。

リポジトリにロゴを追加する

プロジェクト設定にアバターをアップロードしていない場合、GitLabはlogoという名前のファイルをリポジトリで検索し、デフォルトのプロジェクトアバターとして使用します。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。
• ファイルのサイズは200 KB以下である必要があります。理想的な画像サイズは192 x 192ピクセルです。
• ファイルの名前はlogoで、拡張子は.png、.jpg、または.gifである必要があります。たとえば、logo.gifなどです。

プロジェクトアバターとして使用するロゴファイルを追加するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. プロジェクトリポジトリのルートで、ロゴファイルをアップロードします。

プロジェクトの設定でアバターをアップロードする

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。
• ファイルのサイズは200 KB以下である必要があります。理想的な画像サイズは192 x 192ピクセルです。
• 画像は、次のいずれかのファイル形式である必要があります。
  • .bmp
  • .gif
  • .ico
  • .jpeg
  • .png
  • .tiff

プロジェクトの設定でアバターをアップロードするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. プロジェクトアバターセクションで、ファイルを選択を選択します。
4. アバターファイルを選択します。
5. 変更を保存を選択します。

プロジェクトを削除する

デフォルトでは、プロジェクトを初めて削除すると、削除保留状態になります。プロジェクトを直ちに削除するには、プロジェクトをもう一度削除します。

前提条件:

• プロジェクトのオーナーロールを持っている必要があります。
• オーナーは、プロジェクトの削除を許可されている必要があります。

プロジェクトを削除するには、次の手順に従います:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. プロジェクトを削除セクションで、削除を選択します。
5. 確認ダイアログで、プロジェクト名を入力し、はい、プロジェクトを削除しますを選択します。

このアクションにより、プロジェクトを削除対象としてマークするバックグラウンドジョブが追加されます。GitLab.comでは、プロジェクトは30日後に削除されます。GitLab Self-Managedでは、インスタンスの設定から保持期間を変更できます。

プロジェクト削除をスケジュールしたユーザーが、削除が行われる前にプロジェクトへのアクセスを失った場合（例えば、プロジェクトを離脱した、役割がダウングレードされた、またはプロジェクトからBANされたなど）、削除ジョブは代わりにプロジェクトを復元し、プロジェクトは削除予定から外されます。

プロジェクトが削除対象としてマークされると、スケジュールされたCI/CDパイプラインの実行は停止します。

Railsコンソールを使用してプロジェクトを削除することもできます。

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

設定された保持期間を待たずにプロジェクトを削除したい場合は、すぐにプロジェクトを削除できます。

前提条件:

• プロジェクトのオーナーロールを持っている必要があります。
• あなたはプロジェクトを削除対象としてスケジュールしました。

削除予定のプロジェクトを完全に削除するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. プロジェクトを削除セクションで、完全に削除を選択します。
5. 確認ダイアログで、プロジェクト名を入力し、確認を選択します。

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

プロジェクトを復元する

前提条件:

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

削除保留中のプロジェクトを復元するには、次の手順を実行します。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. プロジェクトを復元セクションで、プロジェクトを復元を選択します。

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

プロジェクトをアーカイブして、読み取り専用にし、将来の参照用にデータを保存します。

プロジェクトをアーカイブすると:

• プロジェクトは非アクティブになり、Archivedバッジを表示します
• リポジトリ、イシュー、マージリクエスト、パッケージを含むほとんどの機能が読み取り専用になります。
• フォークの関係は削除され、フォークからの開いているマージリクエストは閉じられます。
• デプロイされたPagesはカスタムドメインとともに削除されます。
• スケジュールされたCI/CDパイプラインの実行は停止します。
• プルミラーリングが停止します。

前提条件:

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

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

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. プロジェクトのアーカイブセクションで、アーカイブを選択します。

あなたの作業リストビューから直接プロジェクトをアーカイブするには:

1. 上部のバーで、検索または移動先を選択します。
2. ドロップダウンから、すべてのプロジェクトを表示を選択します。
3. メンバータブで、アーカイブしたいプロジェクトを見つけ、縦方向の省略記号（ ）を選択します。
4. アーカイブを選択します。

この操作は、他のリストされたページでも使用できます。

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

プロジェクトのアーカイブ解除を行うと:

• 読み取り専用の制限が解除されます。
• プロジェクトは非アクティブとしてマークされなくなります。
• スケジュールされたCI/CDパイプラインは自動的に再開されます。
• プルミラーリングは自動的に再開されます。

プロジェクトがグループアーカイブの一部としてアーカイブされている場合、個別にアーカイブ解除することはできません。すべてのプロジェクトとサブグループをアーカイブ解除するには、親グループのアーカイブを解除する必要があります。

前提条件:

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

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

1. アーカイブされたプロジェクトを検索します。
   1. 上部のバーで、検索または移動先を選択します。
   2. ドロップダウンから、すべてのプロジェクトを表示を選択します。
   3. 非アクティブタブで、あなたのプロジェクトを選択します。
2. 左側のサイドバーで、設定 > 一般を選択します。
3. 高度な設定で、展開を選択します。
4. プロジェクトのアーカイブ解除セクションで、アーカイブ解除を選択します。

あなたの作業リストビューから直接プロジェクトをアーカイブ解除するには:

1. 上部のバーで、検索または移動先を選択します。
2. ドロップダウンから、すべてのプロジェクトを表示を選択します。
3. 非アクティブタブで、アーカイブ解除したいプロジェクトを見つけ、縦方向の省略記号（ ）を選択します。
4. アーカイブ解除を選択します。

この操作は、他のリストされたページでも使用できます。

プロジェクトを転送

プロジェクトを転送して、別のグループに移動します。プロジェクトの転送により、同じGitLabインスタンス内の任意のネームスペース間で個々のプロジェクトを移動できます。

プロジェクトを以下から転送できます:

• パーソナルネームスペースからグループへ
• あるグループから別のグループへ
• グループからパーソナルネームスペースへ

前提条件:

• ターゲットグループのメンテナーまたはオーナーロール。
• 転送したいプロジェクトのオーナーロール。
• ターゲットグループのプロジェクト作成を有効にします。

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

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 高度な設定を展開します。
4. プロジェクトの転送で、プロジェクトを転送するネームスペースを選択します。
5. プロジェクトの転送を選択します。
6. プロジェクトの名前を入力し、確認を選択します。

新しいプロジェクトページに移動し、以前のURLは新しいプロジェクトURLにリダイレクトされます。

プロジェクトを転送した後、以下を確認してください:

• ローカルリポジトリのリモートを新しいURLに更新します。
• プロジェクトメンバーのアクセスと権限を確認します。
• パッケージ設定を更新し、必要であれば再公開します。
• CI/CDパイプラインとインテグレーションをテストしていること。
• 必要であれば、セキュリティポリシーをレビューし、再割り当てします。

管理者は、管理者エリアからプロジェクトを転送できます。

転送されるデータ

プロジェクトの転送には以下が含まれます:

• プロジェクトコンポーネント:
  • イシュー、マージリクエスト、およびイシュースレッド
  • CI/CDパイプラインと設定
  • ダッシュボードとWiki
  • リポジトリコードとGit履歴
  • プロジェクトアクセストークン
• プロジェクトメンバー:
  • 直接的なプロジェクトメンバーとその役割
  • 保留中のメンバーシップ招待
• 自動調整:
  • 一致するグループラベルが存在しない場合、新しいプロジェクトラベルが作成されます。
  • 必要に応じて、ターゲットグループにエピックのコピーが作成され、プロジェクトごとに個別のコピーが作成されます。
    • 同じエピックにイシューが割り当てられた複数のプロジェクトを転送する場合、そのエピックの個別のコピーが各プロジェクトのターゲットグループに作成されます。

既知の問題

プロジェクトを転送する際は、以下の制限に留意してください。

継承されたメンバーシップを持つプロジェクトの場合:

• プロジェクトで継承されたメンバーシップを持つメンバーは、ターゲットグループのメンバーでもある場合を除き、アクセスを失います。
• プロジェクトは、ターゲットグループから新しいメンバー権限を継承します。

コンテナレジストリが有効になっているプロジェクトの場合:

• GitLab.comの場合: 同じトップレベルグループ内でのみプロジェクトを転送できます。
• GitLab Self-Managed: プロジェクトにはコンテナイメージを含めてはなりません。
• 1,000を超えるコンテナリポジトリを持つプロジェクトは転送できません。詳細については、コンテナレジストリリポジトリの移動または名前変更を参照してください。

パッケージレジストリを使用するプロジェクトの場合:

• ルートネームスペースが変更された場合、命名規則に従うnpmパッケージをプロジェクトから削除する必要があります。プロジェクトを転送した後、次のいずれかを実行できます:
  • 新しいルートネームスペースパスでパッケージスコープを更新し、プロジェクトに再度公開します。
  • ルートネームスペースパスを更新せずにパッケージをプロジェクトに再公開します。これにより、パッケージは命名規則に従わなくなります。ルートネームスペースパスを更新せずにパッケージを再公開した場合、そのパッケージはインスタンスエンドポイントでは利用できません。

セキュリティポリシーを持つプロジェクトの場合:

• プロジェクトにはセキュリティポリシーがあってはなりません。プロジェクトにセキュリティポリシーが割り当てられている場合、転送中に自動的に割り当てが解除されます。

プロジェクトを転送すると:

• プロジェクトのパスが変更されます。必要に応じて、プロジェクトコンポーネントへのURLを変更してください。

GitLab.comプロジェクトを別のサブスクリプションティアに転送

GitLab.com PremiumまたはUltimateのライセンスを持つネームスペースから、GitLab Freeへプロジェクトを転送する場合:

• プロジェクトアクセストークンは失効されます。
• パイプラインサブスクリプションとテストケースは削除されます。

プロジェクトをアクションメニューで管理する

すべてのあなたのプロジェクトのリストを表示し、アクションメニューでそれらを管理できます。

前提条件:

• アクションを実行するには、必要なプロジェクト権限が必要です。

アクションメニューでプロジェクトを管理するには:

1. 上部のバーで、検索または移動先を選択します。
2. ドロップダウンから、すべてのプロジェクトを表示を選択します。
3. プロジェクトページで、あなたのプロジェクトを見つけ、縦方向の省略記号（ ）を選択します。
4. アクションを選択します。

あなたのプロジェクトのステータスに応じて、次のアクションが利用可能です:

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

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

LDAPグループを介してプロジェクトへのアクセスを管理する

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

LDAPグループを使用してプロジェクトへのアクセスを管理することはできませんが、次の回避策を使用できます。

前提条件:

• LDAPをGitLabと統合する必要があります。
• 管理者である必要があります。

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

プロジェクトエイリアス

通常、GitLabリポジトリには、ネームスペースとプロジェクト名を使用してアクセスします。ただし、頻繁にアクセスされるリポジトリをGitLabに移行する場合は、プロジェクトエイリアスを使用して、元の名前でそれらのリポジトリにアクセスできます。プロジェクトエイリアスを介してリポジトリにアクセスすると、そのようなリポジトリの移行に関連するリスクが軽減されます。

この機能は、SSH経由のGitでのみ使用できます。また、プロジェクトエイリアスを作成できるのはGitLab管理者のみであり、APIを介してのみ作成できます。詳細については、プロジェクトエイリアスAPIドキュメントを参照してください。

管理者がプロジェクトのエイリアスを作成すると、そのエイリアスを使用してリポジトリのクローンを作成できます。たとえば、管理者がプロジェクトhttps://gitlab.com/gitlab-org/gitlabのエイリアスgitlabを作成した場合、git clone git@gitlab.com:gitlab-org/gitlab.gitの代わりにgit clone git@gitlab.com:gitlab.gitを使用してプロジェクトのクローンを作成できます。

関連トピック

• GitLabにインポートおよび移行する。
• 外部リポジトリをGitLab CI/CDに接続する
• プロジェクトをフォークする
• プロジェクトの表示レベルと権限を調整する
• プロジェクト名とグループ名のルール