Cloud Manager リポジトリ

リポジトリは、Git を使用してコードを管理する場所です。 Cloud Manager プログラムのリポジトリを作成する方法について説明します。

リポジトリへのアクセス

Cloud Manager からセルフサービスで Git リポジトリにアクセスして管理できます。

リポジトリにアクセスするには、Cloud Manager で利用可能な「リポジトリ情報にアクセス」ボタンを使用します。これは、パイプラインカードで最も目立つようになっています。

  1. my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。

  2. プログラムの概要​ページから​パイプライン​カードに移動すると、「リポジトリ情報にアクセス」オプションが表示され、このパイプラインで設定された Git リポジトリにアクセスして管理できます。

    「リポジトリ情報にアクセス」ボタン

  3. 実稼動以外」のパイプラインタブに切り替えると、パイプライン用に設定されている「リポジトリ情報にアクセス」オプションも使用できます。

    実稼動以外のパイプライン

  4. リポジトリ情報にアクセス」ボタンをクリックして、次のダイアログを開きます。

    • Git リポジトリへの URL
    • ユーザー名
    • パスワード
    • リポジトリをローカルに複製するために実行する Git コマンド

    リポジトリ情報ダイアログ

指定した情報を使用してリポジトリのクローンをローカルに作成し、ローカル開発を開始できるようにします。

メモ

リポジトリ情報にアクセス」オプションは、デベロッパー​または​デプロイメントマネージャー​の役割を持つユーザーに表示されます。

リポジトリの追加

Cloud Manager でリポジトリを追加するには、次の手順に従います。

  1. my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。

  2. プログラムの概要​ページで、「リポジトリー」タブをクリックし、リポジトリー​ページに移動します。

  3. リポジトリーを追加」をクリックして、ウィザードを起動します。

    メモ

    リポジトリを追加するには、デプロイメントマネージャー​または​ビジネスオーナー​の役割が必要です。

    リポジトリを追加

  4. 必要に応じて名前と説明を入力し、「保存」をクリックします。

    リポジトリの詳細

  5. 保存」を選択します。

新しく作成されたリポジトリが表示されます。

新しいリポジトリが作成されました

Cloud Manager で作成されたリポジトリは、パイプラインを作成するときに選択できます。

リポジトリの表示と編集

Cloud Manager でリポジトリを編集および表示するには、次の手順に従います。

  1. my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。

  2. プログラムの概要​ページで、「リポジトリ」タブをクリックし、リポジトリ​ページに移動します。ここでは、既存のリポジトリの詳細を表示できます。

  3. リポジトリを選択し、表の右端にある省略記号ボタンをクリックして、リポジトリ URL のコピー、リポジトリの​表示と更新、または​削除​を実行します。

リポジトリを編集

Git サブモジュールのサポート

Git サブモジュールを使用すると、ビルド時に Git リポジトリ間で複数のブランチのコンテンツを結合できます。

Cloud Manager のビルドプロセスを実行すると、パイプライン用に設定されたリポジトリのクローンを作成し、設定されたブランチをチェックアウトした後に、ブランチのルートディレクトリに .gitmodules ファイルが含まれている場合は、コマンドが実行されます。

$ git submodule update --init

これにより、各サブモジュールが適切なディレクトリにチェックアウトされます。この手法は、Git サブモジュールの使用に慣れており、外部マージプロセスの管理を希望しない組織にとって、複数のソース Git リポジトリーでの操作の代わりに使用できる可能性があります。

例えば、3 つのリポジトリがあり、それぞれに main という名前のブランチが 1 つあるとします。「プライマリ」リポジトリ(パイプラインで設定されたもの)の main ブランチには、他の 2 つのリポジトリに含まれるプロジェクトを宣言する pom.xml ファイルが含まれます。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>customer.group.id</groupId>
    <artifactId>customer-reactor</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>project-a</module>
        <module>project-b</module>
    </modules>

</project>

次に、他の 2 つのリポジトリー用のサブモジュールを追加します。

$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectA/ project-a
$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectB/ project-b

その結果、.gitmodules ファイルは次のようになります。

[submodule "project-a"]
    path = project-a
    url = https://git.cloudmanager.adobe.com/ProgramName/projectA/
    branch = main
[submodule "project-b"]
    path = project-b
    url = https://git.cloudmanager.adobe.com/ProgramName/projectB/
    branch = main

Git サブモジュールの詳細については、Git リファレンスマニュアルを参照してください。

制限事項

Git サブモジュールを使用する場合は、次の点に注意してください。

  • Git の URL は、上記の構文に正確に一致している必要があります。
  • セキュリティ上の理由から、これらの URL に資格情報を埋め込まないでください。
  • ブランチのルートにあるサブモジュールのみがサポートされます。
  • Git サブモジュール参照は、特定の Git コミットに保存されます。
    • その結果、サブモジュールリポジトリに対して変更を加える場合、git submodule update --remote などを使用して、参照されるコミットを更新する必要があります。
  • 特に必要がない限り、「シャロー」サブモジュールを使用することを強くお勧めします。
    • それには、サブモジュールごとに git config -f .gitmodules submodule.<submodule path>.shallow true を実行します。

このページ