このタスクを使用して、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
するときに使用します。
ビルドまたはリリースの完了後にエージェントから削除するカスタム キーチェーンを指定します。
証明書署名 IDの signingIdentity
-
string
.
署名証明書のサブジェクトの Common Name
を指定します。 空のままにした場合、Common Name
の解析を試みます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
このタスクでは、次の 出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。
signingIdentity
署名証明書のサブジェクトの解決済み Common Name
を指定します。 入力として指定されるか、P12 証明書ファイルから解析されます。
keychainPath
証明書を含むキーチェーン ファイルのパスを指定します。