正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

プロジェクトの作成

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

プロジェクトを作成するには、いくつかのオプションがあります。空のプロジェクトを作成する、組み込みまたはカスタムテンプレートからプロジェクトを作成する、git pushでプロジェクトを作成するといったことができます。

空のプロジェクトを作成する

空のプロジェクトを作成するには:

  1. 左側のサイドバーの上部で、新規作成 plus )を選択し、新規プロジェクト/リポジトリを選択します。
  2. 空のプロジェクトの作成を選択します。
  3. プロジェクトの詳細を入力します:
    1. プロジェクト名: プロジェクトの名前を入力します。詳細については、命名規則を参照してください。
    2. プロジェクトslug: プロジェクトのパスを入力します。GitLabは、URLパスとしてslugを使用します。
    3. プロジェクトのデプロイ先(オプション): プロジェクトを特定の環境にデプロイする場合は、関連するデプロイ先を選択します。
    4. 表示レベル: 適切な表示レベルを選択します。ユーザーの表示およびアクセス権を参照してください。
    5. リポジトリを初期化しREADMEファイルを生成する: このオプションを選択すると、Gitリポジトリを初期化し、デフォルトブランチを作成して、このプロジェクトのリポジトリのクローンを作成できるようになります。
    6. 静的アプリケーションセキュリティテスト (SAST) を有効にする: このオプションを選択すると、既知のセキュリティの脆弱性に関するソースコードが分析されます。
    7. シークレット検出を有効にする: このオプションを選択して、ソースコードのシークレットと認証情報を分析し、承認されていないアクセスを防ぎます。
  4. プロジェクトを作成を選択します。

組み込みのテンプレートからプロジェクトを作成する

組み込みのテンプレートは、新しいプロジェクトにファイルを取り込み、作成開始を支援します。これらのテンプレートは、project-templatesグループとpagesグループから提供されています。誰でも組み込みプロジェクトテンプレートにコントリビュートできます。

組み込みのテンプレートからプロジェクトを作成するには:

  1. 左側のサイドバーの上部で、新規作成 plus )を選択し、新規プロジェクト/リポジトリを選択します。
  2. テンプレートから作成を選択します。
  3. ビルトインタブを選択します。
  4. テンプレートのリストで次のように選択します:
    • テンプレートをプレビューするには、プレビューを選択します。
    • テンプレートを使用するには、テンプレートを使用を選択します。
  5. プロジェクトの詳細を入力します:
    • プロジェクト名: プロジェクトの名前を入力します。
    • プロジェクトslug: プロジェクトのパスを入力します。GitLabは、URLパスとしてslugを使用します。
    • **プロジェクトの説明 (オプション)**プロジェクトの説明を入力します。文字の上限は500字です。
    • 表示レベル: 適切な表示レベルを選択します。ユーザーの表示およびアクセス権を参照してください。
  6. プロジェクトを作成を選択します。

ユーザーがテンプレートからプロジェクトを作成するか、プロジェクトをインポートすると、そのユーザーはインポートされたアイテムの作成者として表示されます。この際、テンプレートまたはインポートの元のタイムスタンプが保持されます。これが原因で、アイテムがユーザーのアカウントが存在するより前に作成されたかのように表示されることがあります。

インポートされたオブジェクトには、By <username> on <timestamp>というラベルが付きます。GitLab 17.1より前では、ラベルの末尾に(imported from GitLab)が付いていました。

HIPAA監査プロトコルテンプレートからプロジェクトを作成する

HIPAA監査プロトコルテンプレートには、米国保健福祉省が発行したHIPAA監査プロトコルの監査照会に関するイシューが含まれています。

HIPAA監査プロトコルテンプレートからプロジェクトを作成するには:

  1. 左側のサイドバーの上部で、新規作成 plus )を選択し、新規プロジェクト/リポジトリを選択します。
  2. テンプレートから作成を選択します。
  3. ビルトインタブを選択します。
  4. HIPAA監査プロトコルテンプレートを見つけて、次のように選択します:
    • テンプレートをプレビューするには、プレビューを選択します。
    • テンプレートを使用するには、テンプレートを使用を選択します。
  5. プロジェクトの詳細を入力します:
    • プロジェクト名: プロジェクトの名前を入力します。
    • プロジェクトslug: プロジェクトのパスを入力します。GitLabは、URLパスとしてslugを使用します。
    • **プロジェクトの説明 (オプション)**プロジェクトの説明を入力します。文字の上限は500字です。
    • 表示レベル: 適切な表示レベルを選択します。ユーザーの表示およびアクセス権を参照してください。
  6. プロジェクトを作成を選択します。

カスタムテンプレートからプロジェクトを作成する

カスタムプロジェクトテンプレートは、インスタンスおよびグループで使用できます。

カスタムテンプレートからプロジェクトを作成するには:

  1. 左側のサイドバーの上部で、新規作成 plus )を選択し、新規プロジェクト/リポジトリを選択します。
  2. テンプレートから作成を選択します。
  3. インスタンスまたはグループタブを選択します。
  4. テンプレートのリストで次のように選択します:
    • テンプレートをプレビューするには、プレビューを選択します。
    • テンプレートを使用するには、テンプレートを使用を選択します。
  5. プロジェクトの詳細を入力します:
    • プロジェクト名: プロジェクトの名前を入力します。
    • プロジェクトslug: プロジェクトのパスを入力します。GitLabは、URLパスとしてslugを使用します。
    • **プロジェクトの説明 (オプション)**プロジェクトの説明を入力します。文字の上限は500字です。
    • 表示レベル: 適切な表示レベルを選択します。ユーザーの表示およびアクセス権を参照してください。
  6. プロジェクトを作成を選択します。

SHA-256ハッシュを使用するプロジェクトを作成する

  • ステータス: 実験的機能

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。この機能はテストには利用できますが、本番環境での使用には適していません。

プロジェクトの作成時にのみ、プロジェクトのSHA-256ハッシュを選択できます。Gitでは、後でSHA-256に移行したり、元のSHA-1に移行したりといった操作をサポートしていません。

SHA-256ハッシュを使用するプロジェクトを作成するには:

  1. 左側のサイドバーの上部で、新規作成 plus )を選択し、新規プロジェクト/リポジトリを選択します。
  2. プロジェクトの詳細を入力します:
    • プロジェクト名: プロジェクトの名前を入力します。
    • プロジェクトslug: プロジェクトのパスを入力します。GitLabは、URLパスとしてslugを使用します。
    • **プロジェクトの説明 (オプション)**プロジェクトの説明を入力します。文字の上限は500字です。
    • 表示レベル: 適切な表示レベルを選択します。ユーザーの表示およびアクセス権を参照してください。
  3. プロジェクトの設定エリアで、試験版の設定を展開します。
  4. Use SHA-256 as the repository hashing algorithm(リポジトリのハッシュアルゴリズムとしてSHA-256を使用)を選択します。
  5. プロジェクトを作成を選択します。

SHA-256を選択する理由

デフォルトでは、GitはSHA-1ハッシュアルゴリズムを使用して、コミット、blob、ツリー、タグなどのオブジェクトに40文字のIDを生成します。Googleがハッシュコリジョンを生成できる場合、SHA-1アルゴリズムは脆弱であることが証明されました。Gitプロジェクトは、Gitのオブジェクト保存方法のおかげで、これらの種類の攻撃による影響をまだ受けていません。

SHA-256リポジトリでは、アルゴリズムは40文字ではなく64文字のIDを生成します。Gitプロジェクトでは、実験ラベルを削除した際、SHA-256機能を安全に使用できると判断しました。

FedRAMPが実施するNISTやCISAガイドラインなどの連邦規制では、2030年に設定した期限までに各機関がSHA-1の使用を停止し、可能であれば早期にSHA-1から移行することを推奨しています。