InstallAppleCertificate@1 - Apple Certificate v1 タスクのインストール

このタスクを使用して、macOS エージェントでビルドするために必要な Apple 証明書をインストールします。 このタスクを使用して、セキュリティ で保護されたファイル として保存されている Apple 証明書をサーバーにインストールできます。

構文

# Install Apple Certificate v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity.

入力

certSecureFile - 証明書 (P12)
string. 必須です。

macOS エージェントにインストールするためにアップロードされた Secure Files 証明書 (.p12) を指定します。


certPwd - 証明書 (P12) パスワード
string.

Apple 証明書 (.p12) のパスワードを指定します。 タブでロックが有効になっている新しいビルド変数を Variables 使用して、この値を暗号化します。


keychain - キーチェーン
string. 必須です。 使用できる値: default (既定のキーチェーン)、 temp (一時キーチェーン)、 custom (カスタム キーチェーン)。 既定値: temp

Apple 証明書をインストールするキーチェーンを指定します。 一時キーチェーンは、ビルドまたはリリースが完了すると常に削除されます。


keychainPassword - キーチェーン パスワード
string.

キーチェーンのロックを解除するパスワードを指定します。 タブでロックが有効になっている新しいビルド変数を Variables 使用して、この値を暗号化します。 一時キーチェーンがまだ指定されていない場合は、一時キーチェーンのパスワードが生成されます。


customKeychainPath - カスタム キーチェーン パス
string. 次の場合に keychain = custom必要です。

カスタム キーチェーン ファイルへの完全パスを指定します。 キーチェーンがまだ存在しない場合は、キーチェーンが作成されます。


deleteCert - キーチェーンから証明書を削除する
boolean. 省略可能。 次の場合に使用します keychain = custom || keychain = default

ビルドまたはリリースの完了後にキーチェーンから削除する証明書を指定します。


deleteCustomKeychain - カスタム キーチェーンを削除する
boolean. 省略可能。 次の場合に使用します keychain = custom

ビルドまたはリリースの完了後にエージェントから削除するカスタム キーチェーンを指定します。


signingIdentity - 証明書署名 ID
string.

Common Name署名証明書のサブジェクトを指定します。 これが空のままである場合は、 Common Name 解析を試みます。


タスクコントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、 コントロール オプションと一般的なタスク プロパティに関するページを参照してください。

出力変数

このタスクでは、ダウンストリームのステップ、ジョブ、およびステージで使用できる次の 出力変数を定義します。

signingIdentity
署名証明書のサブジェクトの解決済 Common Name みを指定します。 入力として提供されるか、P12 証明書ファイルから解析されます。

keychainPath
証明書を含むキーチェーン ファイルのパスを指定します。

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.116.0 以上
タスクのカテゴリ ユーティリティ