プロジェクトで作業の整理を始める
GitLabのプロジェクトを使用すると、特定の開発プロジェクトに関するすべてのデータを整理できます。プロジェクトは、チームと協力して作業し、ファイルを保存して、タスクを管理する場所です。
プロジェクトを使用すると、次のことが可能です。
- コードを記述および保存する
- イシューとタスクを追跡する
- コード変更の共同作業を行う
- アプリをテストしてデプロイする
プロジェクトの作成とメンテナンスは、以下に示すより大きなワークフローの一部です。
ステップ1: プロジェクトを作成する
まず、コードベース、ドキュメント、関連リソースを格納するための新しいプロジェクトをGitLabで作成します。
プロジェクトには1つのリポジトリが含まれます。リポジトリには、作業に関連するすべてのファイル、ディレクトリ、データが格納されます。
プロジェクトを作成する際に、開発ワークフローやコラボレーションの要件に合わせて、次の項目を確認して設定します。
- 表示レベル
- マージリクエストの承認
- イシュートラッキング
- CI/CDパイプライン
- イシューやマージリクエストなどのエンティティの説明テンプレート
詳細については、以下を参照してください。
ステップ2: プロジェクトへのアクセスを保護および制御する
次のツールを使用して、プロジェクトへの安全なアクセスを管理します。
- プロジェクトアクセストークン: 自動化されたツールまたは外部システムに特定のアクセス権を付与し、安全なインテグレーションを可能にします。
- デプロイキー: リポジトリへの読み取り専用アクセス権を付与し、外部システムへのプロジェクトの安全なデプロイを可能にします。
- デプロイトークン: プロジェクトのリポジトリとレジストリへの一時的かつ限定的なアクセス権を付与し、安全なデプロイと自動化を可能にします。
詳細については、以下を参照してください。
ステップ3: プロジェクトの共同作業を行い、共有する
複数のプロジェクトをグループに招待できます。これは、sharing a project with a groupと呼ばれることもあります。各プロジェクトには、独自のリポジトリ、イシュー、マージリクエストなどの機能があります。
グループ内に複数のプロジェクトをまとめることで、チームメンバーはグループ全体の作業状況の概要を把握しながら、個々のプロジェクトで共同作業を行えます。
プロジェクトへのアクセスをより細かく制御するために、グループにサブグループを追加することもできます。
詳細については、以下を参照してください。
ステップ4: プロジェクトの発見可能性と認知度を高める
検索ボックスを使用すると、GitLabインスタンス全体から特定のプロジェクト、イシュー、マージリクエスト、コードスニペットをすばやく見つけることができます。
プロジェクトを見つけやすくするには、次のようにします。
- 予約済みのプロジェクト名とグループ名を考慮し、一貫性があり認識しやすいプロジェクトの命名スキームを作成します。
- プロジェクトの
READMEファイルにバッジを追加します。バッジには、ビルドステータス、プロジェクトの健全性、テストカバレッジ、バージョン番号など、重要な情報を表示できます。 - プロジェクトのトピックを割り当てます。トピックは、プロジェクトを整理して見つけやすくするためのラベルです。
詳細については、以下を参照してください。
ステップ5: 開発効率を高め、コード品質を維持する
生産性を高め、高品質なコードベースを維持するために、次のようなコードインテリジェンス機能を使用します。
- コードナビゲーション
- ホバー情報
- 自動補完
コードインテリジェンスとは、コードベースを効率的に調査、分析、保守するのに役立つ各種のツールです。
プロジェクト内の特定のファイルをすばやく見つけて移動するには、ファイルファインダーを使用します。
詳細については、以下を参照してください。
ステップ6: プロジェクトをGitLabに移行する
ファイルエクスポートを使用して、他のシステムまたはGitLabインスタンスからプロジェクトをGitLabに移行します。
アクセス頻度の高いリポジトリをGitLabに移行する場合、プロジェクトエイリアスを使用すると、元の名前で引き続きアクセスできます。
GitLab.comでは、プロジェクトをあるネームスペースから別のネームスペースに転送できます。転送すると、プロジェクトは基本的に別のグループに移動し、そのグループのメンバーがアクセス権または所有権を持つようになります。
詳細については、以下を参照してください。