パブリック・リポジトリーの場合

パブリック・リポジトリーで障害が発生した場合、Git リポジトリーの HTTPS URL を使用するように既存のビルドを更新してから、ビルドを実行します。

1. ibmcloud ce build update コマンドを使用して、Git リポジトリーの HTTPS URL を使用するようにビルド構成を更新します。次に例を示します。

   ibmcloud ce build update --name <BUILD_NAME> --source <GIT_REPO>
   

2. ibmcloud ce buildrun submit コマンドを使用して、新しいビルドを実行依頼します。 buildrun submit コマンドには、--build オプションを指定して、ビルド構成の名前を指定する必要があります。 必要に応じて、--name オプションを指定して、そのビルド実行の名前を指定することもできます。 --name オプションを指定した場合は、必ず、失敗したビルド実行とは異なるビルド実行名を使用するか、失敗したビルド実行を ibmcloud ce buildrun delete コマンドを使用して削除してください。 以下に例を示します。

   ibmcloud ce buildrun submit --build <BUILD_NAME> --name <BUILDRUN_NAME>
   

プライベート・リポジトリーの場合

プライベート・リポジトリーで障害が発生した場合は、SSH シークレットを作成し、SSH プロトコルを使用します。 SSH シークレットには、コンテナー・イメージをビルドするためのソース・コードが含まれているプライベート・リポジトリーにアクセスするための資格情報が含まれています。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 SSH 秘密には秘密鍵が含まれ、対応する公開鍵は Git リポジトリー・プロバイダーに保管されます。 鍵ペアを作成して公開部分を GitHub または GitLab に保管する方法について詳しくは、プライベート・コード・リポジトリーへのアクセスを参照してください。 秘密鍵ファイルを Code Engine にアップロードするためには、秘密鍵ファイルをパスフレーズで暗号化しないでおくことが重要です。 秘密鍵ファイルの形式は変わることがあるため、ファイルが暗号化されているかどうかを判断するのは面倒です。 鍵ペアの作成に使用された ssh-keygen ツールのバージョンに応じて、ファイルには以下のいずれかのヘッダーが含まれています。

• ファイルが -----BEGIN RSA PRIVATE KEY----- で始まっていれば、そのファイルは PEM 形式を使用しており、以前のバージョンの ssh-keygen で作成されています。 パスフレーズを使用してファイルが暗号化されていれば、そのファイルには通常、Proc-Type: 4,ENCRYPTED のような行が含まれています。

• ファイルが -----BEGIN OPENSSH PRIVATE KEY----- で始まっていれば、そのファイルは新しいバージョンの ssh-keygen で作成されています。 パスフレーズを使用して暗号化されているかどうかを確認するには、ssh-keygen -p -f <ID_FILE>コマンドを実行します。

  ssh-keygen -p -f <ID_FILE>   
      Enter old passphrase:
  

  ssh-keygen -p -f <ID_FILE>
      Key has comment '<COMMENT>'
  Enter new passphrase (empty for no passphrase):
  

  コマンドをエスケープするには、Ctrl+C を使用します。 コマンドが旧パスフレーズを要求した場合は (最初の例)、元のファイルが暗号化されています。そうでない場合は、新しいファイルのパスフレーズが直接求められます (2 番目の例)。

  暗号化された秘密鍵ファイルを復号するには、次のコマンドを実行し、新しいパスフレーズは空にしておきます。

  $ ssh-keygen -p -f <ID_FILE>
  
  Enter old passphrase: <PASSPHRASE>
  Key has comment '<COMMENT>'
  Enter new passphrase (empty for no passphrase):
  Enter same passphrase again:
  Your identification has been saved with the new passphrase.
  

  このコマンドによって秘密鍵ファイルが変更されます。 暗号化されたバージョンを保持する必要がある場合は、最初にコピーを作成してください。

SSH シークレットを作成し、SSH プロトコルを使用するには、以下のようにします。

1. ibmcloud ce secret create --format ssh コマンドを実行します。 SSH シークレットは、 Git リポジトリー・アクセス・シークレットとしても使用されます。 SSH_KEY_PATH は、アカウントの公開鍵と一致する秘密鍵ファイル、またはリポジトリー内のデプロイメント・キーを指している必要があります。 このコマンドは、名前とキー・パスを必要とします。また、既知の hosts ファイルへのパスなど、その他のオプション引数も許可します。 --known-hosts-path オプションを指定する場合は、 Git リポジトリーのホスト (例えば、 github.com または gitlab.com ) を既知の hosts ファイルに含めます。 詳しくは、プライベート・コード・リポジトリーへのアクセスを参照してください。

   ibmcloud ce secret create --format ssh --name <GIT_REPO_SECRET> --key-path <SSH_KEY_PATH> --known-hosts-path  <PATH_TO_KNOWN_HOSTS_FILE>
   

2. ibmcloud ce build update コマンドを使用して、 Git リポジトリーの SSH URL を使用し、SSH シークレット <GIT_REPO_SECRET> を参照するようにビルド構成を更新します。 以下に例を示します。

   ibmcloud ce build update --name <BUILD_NAME> --source <GIT_REPO> --git-repo-secret <GIT_REPO_SECRET>
   

   前の例では、ソースに git@ プレフィックスを使用して SSH URL を指定します。例えば --source git@github.com:IBM/CodeEngine.git とします。