InstallAppleCertificate@2 - Menginstal tugas sertifikat Apple v2
Gunakan tugas ini untuk menginstal sertifikat Apple yang diperlukan untuk membangun agen macOS. Anda dapat menggunakan tugas ini untuk menginstal sertifikat Apple yang disimpan sebagai file aman di server.
Instal sertifikat Apple yang diperlukan untuk membangun agen macOS.
Sintaks
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. 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.
#setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.
#opensslPkcsArgs: # string. OpenSSL arguments for PKCS12.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. 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.
#setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. 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.
# Install Apple Certificate v2
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. 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.
Input
certSecureFile
- Sertifikat (P12)
string
. Wajib diisi.
Menentukan sertifikat (.p12) yang diunggah ke untuk Secure Files
diinstal pada agen macOS.
certPwd
- Kata sandi sertifikat (P12)
string
.
Menentukan kata sandi ke sertifikat Apple (.p12). Gunakan variabel build baru dengan kuncinya diaktifkan pada tab Variables
untuk mengenkripsi nilai ini.
keychain
- Keychain
string
. Wajib diisi. Nilai yang diizinkan: default
(Rantai Kunci Default), temp
(Rantai Kunci Sementara), custom
(Rantai Kunci Kustom). Nilai default: temp
.
Menentukan rantai kunci untuk menginstal sertifikat Apple. Untuk build yang dihosting Microsoft, gunakan Temporary Keychain
. Rantai kunci sementara akan selalu dihapus setelah build atau rilis selesai.
keychainPassword
- Kata sandi rantai kunci
string
. Diperlukan saat keychain = custom || keychain = default
.
Menentukan kata sandi untuk membuka kunci rantai kunci. Gunakan variabel build baru dengan kuncinya diaktifkan pada tab Variables
untuk mengenkripsi nilai ini. Kata sandi dihasilkan untuk rantai kunci sementara jika tidak ditentukan.
customKeychainPath
- Jalur rantai kunci kustom
string
. Diperlukan saat keychain = custom
.
Menentukan jalur lengkap ke file rantai kunci kustom. Rantai kunci akan dibuat jika belum ada.
deleteCert
- Menghapus sertifikat dari rantai kunci
boolean
. Pilihan. Gunakan saat keychain = custom || keychain = default
.
Menentukan sertifikat yang akan dihapus dari rantai kunci setelah build atau rilis selesai.
deleteCustomKeychain
- Menghapus rantai kunci kustom
boolean
. Pilihan. Gunakan saat keychain = custom
.
Menentukan rantai kunci kustom untuk dihapus dari agen setelah build atau rilis selesai.
signingIdentity
- Identitas penandatanganan sertifikat
string
.
Common Name
Menentukan subjek dalam sertifikat penandatanganan. Akan mencoba mengurai Common Name
jika ini dibiarkan kosong.
setUpPartitionIdACLForPrivateKey
- Menyiapkan ACL partition_id untuk kunci privat yang diimpor
boolean
.
Jika true
, mengatur partition_id
ACL untuk kunci privat yang codesign
diimpor sehingga tidak akan meminta untuk menggunakan kunci untuk penandatanganan. Ini tidak diperlukan untuk rantai kunci sementara di MacOS High Sierra. Pelajari selengkapnya tentang Open Radar.
opensslPkcsArgs
- Argumen OpenSSL untuk PKCS12
string
.
Argumen untuk informasi sertifikat ekstraksi menggunakan openssl.
Opsi kontrol tugas
Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.
Variabel output
Tugas ini menentukan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.
signingIdentity
Menentukan penyelesaian Common Name
subjek dalam sertifikat penandatanganan. Baik disediakan sebagai input atau diurai dari file sertifikat P12.
keychainPath
Menentukan jalur untuk file rantai kunci dengan sertifikat.
Keterangan
Gunakan tugas ini untuk menginstal sertifikat Apple yang diperlukan untuk membangun agen macOS. Anda dapat menggunakan tugas ini untuk menginstal sertifikat Apple yang disimpan sebagai file aman di server.
Persyaratan
Persyaratan | Deskripsi |
---|---|
Jenis alur | YAML, Build klasik, Rilis klasik |
Berjalan pada | Agen, DeploymentGroup |
Permintaan | Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: xcode |
Kemampuan | Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan. |
Pembatasan perintah | Tugas ini berjalan menggunakan pembatasan perintah berikut: dibatasi |
Variabel yang dapat diatur | Tugas ini memiliki izin untuk mengatur variabel berikut: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN |
Versi agen | 2.182.1 atau lebih tinggi |
Kategori tugas | Utilitas |
Persyaratan | Deskripsi |
---|---|
Jenis alur | YAML, Build klasik, Rilis klasik |
Berjalan pada | Agen, DeploymentGroup |
Permintaan | Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: xcode |
Kemampuan | Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan. |
Pembatasan perintah | Apa pun |
Variabel yang dapat diatur | Apa pun |
Versi agen | 2.116.0 atau lebih tinggi |
Kategori tugas | Utilitas |