InstallAppleCertificate@1 - Menginstal tugas Apple Certificate v1

Artikel
05/16/2024

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.

Sintaks

# 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.

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. Rantai kunci sementara akan selalu dihapus setelah build atau rilis selesai.

keychainPassword - Kata sandi rantai kunci
string.

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 belum 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. Opsional. 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. Opsional. 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.

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 mendefinisikan 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.

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	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.116.0 atau lebih tinggi
Kategori tugas	Utilitas

Share via