UiPath Pack

Mit der UiPathPack-Aufgabe können Sie ein vorhandenes UiPath-Projekt in ein NuGet-Paket packen.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Pack zu konfigurieren.

Argument	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Versionsverwaltungsmethode auswählen (erforderlich)	Sie können eine automatisch generierte Version auswählen, die Projektversion verwenden oder eine neue Version definieren. Weitere Informationen finden Sie unter Paketversionen.
Version (erforderlich)	Nur für moderne Ordner zusammen mit einer dynamischen Zuordnungsstrategie verfügbar. Das Festlegen der Paketversion bietet die Möglichkeit, die erstellten Pakete und deren Quellversionen effizienter zu verfolgen. Beispielsweise kann das Microsoft-Assembly-Muster verwendet werden, um die NuGet-Paketversion zu erstellen: [Hauptversion].[Nebenversion].[Buildnummer].[Revisionsnummer]. Die verfügbaren Optionen sind: AutoVersion : Diese Option aktualisiert die Version automatisch auf die nächste sequenzielle Zahl. Sie können das folgende Beispiel für die Aufgabenkonfiguration verwenden: Aufgabe - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' – Aufgabe: UiPathPack@3 Eingaben: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' ManualVersion : Mit dieser Option können Sie Ihre eigene Versionsnummer angeben. Sie können das folgende Beispiel für die Aufgabenkonfiguration verwenden: Aufgabe - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' – Aufgabe: UiPathPack@3 Eingaben: versionType: ManualVersion Version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' CurrentVersion : Diese Option behält die Version bei, die in der Datei project.json angegeben ist. Sie können das folgende Beispiel für die Aufgabenkonfiguration verwenden: Aufgabe - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' – Aufgabe: UiPathPack@3 Eingaben: VersionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests'
Projektpfad (erforderlich)	Wählen Sie den Speicherort des Projekts aus, das verpackt werden soll. Dies kann ein direkter Pfad zu einer PROJECT.JSON-Datei oder einem Verzeichnis mit einem oder mehreren Projekten sein. Im letzteren Fall wird jedes Projekt der Ebene eins einzeln gepackt.
Ausgabetyp auswählen (nur für manuelle Versionierung erforderlich)	Legen Sie einen Projekttyp für das Projekt fest, das verpackt werden soll. Wenn Sie None festlegen, wird der Projekttyp aus der JSON-Datei des Projekts extrahiert. Die folgenden Projekttypen werden unterstützt: „Prozess“, „Bibliothek“, „Tests“, „Objekte“, „Keine“.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Ausgabepfad (Erforderlich)	Legen Sie einen Ordnerpfad fest, auf dem das Paket abgelegt werden soll.
Aufteilen der Ausgabe in Design- und Runtime-Bibliotheken	Wählen Sie diese Option aus, um die Ausgabe in Design- und Runtime-Bibliotheken aufzuteilen. Standardmäßig ist diese Option nicht aktiviert.
Deaktivieren Sie integrierte NuGet-Feeds	Wählen Sie diese Option aus, um integrierte NuGet-Feeds zu deaktivieren. Standardmäßig ist dies auf „false“ festgelegt.
Versionsinformationen des Quellcodes und URL der Automation Hub-Idee	Wählen Sie diese Option aus, um Paketmetadaten einschließlich Versionsinformationen des Quellcodes und der URL der Automation Hub-Idee zu aktivieren. Wenn diese Option aktiviert ist, können Sie Repository-Details und die Projekt-URL angeben.
Der vollständige Pfad zu project.json im Remote-Repository	Geben Sie den vollständigen Pfad zu project.json im Remote-Repository an. Verfügbar, wenn Paketmetadaten aktiviert sind.
Die Commit-ID	Geben Sie die Commit-ID von Ihrem Versionskontrollsystem an. Verfügbar, wenn Paketmetadaten aktiviert sind. Beispiel: $(Build.SourceVersion)
Die Repository-Verzweigung	Geben Sie den Namen der Repository-Verzweigung an. Verfügbar, wenn Paketmetadaten aktiviert sind. Beispiel: $(Build.SourceBranchName)
Der Typ des Repositorys	Geben Sie den Typ des Repositorys an (z. B. git). Verfügbar, wenn Paketmetadaten aktiviert sind.
URL der Automation Hub-Idee	Geben Sie die URL der Automation Hub-Idee an, um das Paket mit einer bestimmten Automatisierungsidee zu verknüpfen. Verfügbar, wenn Paketmetadaten aktiviert sind.
Versionshinweise	Geben Sie Versionshinweise für das Paket an. Verfügbar, wenn Paketmetadaten aktiviert sind.
Workflow-Analyse ausführen	Wählen Sie diese Option aus, um Workflow-Analyseregeln in Ihrem Automatisierungsprojekt auszuführen (z. B. Aufträge bei Fehlern fehlschlagen lassen). Standardmäßig ist diese Option nicht aktiviert. Weitere Informationen finden Sie unter Regeln für Anwendungstests mit der Workflow-Analyse.
Pfad der Governance-Datei	Geben Sie den Pfad zu Governance-Richtlinien an, die Workflow-Analyseregeln enthalten. Richtlinien können von Automation Ops heruntergeladen oder aus der exportierten komprimierten ZIP-Datei von Studio extrahiert werden. Verfügbar, wenn die Workflow-Analyse aktiviert ist.
Zertifikatpfad	Geben Sie den Pfad zur Zertifikatsdatei im Format PFX an Format, das zum Signieren des Pakets verwendet wird. Wenn bereitgestellt, wird das Paket digital mit dem Zertifikat signiert. Beispiel: $(Build.SourcesDirectory)\certificates\signing-cert.pfx
Zertifikatkennwort	Geben Sie das Kennwort für das Zertifikat an. Es wird empfohlen, diesen Wert als geheime Variable in Azure DevOps zu speichern. Beispiel: $(CertificatePassword)
Zeitstempelserver-URL	Geben Sie die URL des Zeitstempelservers an, der beim Signieren des Pakets verwendet werden soll. Der Zeitstempel stellt sicher, dass die Signatur auch nach Ablauf des Zertifikats gültig bleibt. Beispiel: https://timestamp.digicert.com
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für das UiPath Pack anzeigen.

Beispiel: Grundlegende Paketerstellung

- task: UiPathPack@2
  inputs:
    versionType: AutoVersion
    projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    outputType: 'Process'
    orchestratorConnection: 'service-connection-name'
    traceLevel: 'Information'

Beispiel: Paket mit Signierung

- task: UiPathPack@2
  displayName: 'Pack and Sign UiPath Project'
  inputs:
    versionType: 'ManualVersion'
    version: '1.0.$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\MyAutomationProject'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    certificatePath: '$(Build.SourcesDirectory)\certificates\signing-cert.pfx'
    certificatePassword: '$(SigningCertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Information'

Beispiel: Paket mit Workflow-Analyse und -Signatur

- task: UiPathPack@2
  displayName: 'Pack, Analyze, and Sign Project'
  inputs:
    versionType: 'ManualVersion'
    version: '$(Major).$(Minor).$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\EnterpriseAutomation'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    runWorkflowAnalysis: true
    certificatePath: '$(Pipeline.Workspace)\secure-files\company-cert.pfx'
    certificatePassword: '$(CertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Verbose'

Hinweis:

Wenn Sie die Paketsignierung verwenden, speichern Sie Ihr Zertifikatkennwort als geheime Variable in Azure DevOps. Navigieren Sie zu Pipelines > Bibliothek > Variablengruppen oder definieren Sie sie in Ihren Pipelinevariablen mit dem aktivierten Schlosssymbol, um sie zu sichern.