Artefakty vydaných verzí a zdroje artefaktůRelease artifacts and artifact sources

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2015Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015

Poznámka

V Microsoft Team Foundation Server (TFS) 2018 a předchozích verzích se kanály sestavení a vydání nazývají definice, spuštění se nazývají sestavení, připojení služby se nazývají koncové body služby, fáze se nazývají prostředí a úlohy se nazývají fáze.In Microsoft Team Foundation Server (TFS) 2018 and previous versions, build and release pipelines are called definitions, runs are called builds, service connections are called service endpoints, stages are called environments, and jobs are called phases.

Poznámka

Toto téma se zabývá klasickými kanály pro vydávání verzí.This topic covers classic release pipelines. Chcete-li pochopit artefakty v kanálech YAML, přečtěte si téma artefakty.To understand artifacts in YAML pipelines, see artifacts.

Verze je kolekce artefaktů v procesech CI/CD DevOps.A release is a collection of artifacts in your DevOps CI/CD processes. Artefakt je nasaditelné součásti aplikace.An artifact is a deployable component of your application. Azure Pipelines mohou nasazovat artefakty, které jsou vytvářeny pomocí široké škály zdrojů artefaktůa uloženy v různých typech úložišť artefaktů.Azure Pipelines can deploy artifacts that are produced by a wide range of artifact sources, and stored in different types of artifact repositories.

Při vytváření kanálu vydání propojíte příslušné zdroje artefaktů s kanálem pro vydávání verzí.When authoring a release pipeline, you link the appropriate artifact sources to your release pipeline. Například můžete propojit Azure Pipelines kanál sestavení nebo projekt Jenkinse k vašemu kanálu vydávání verzí.For example, you might link an Azure Pipelines build pipeline or a Jenkins project to your release pipeline.

Při vytváření vydané verze zadáte přesnou verzi těchto zdrojů artefaktů; například číslo sestavení přicházející z Azure Pipelines nebo verze sestavení pocházející z projektu Jenkinse.When creating a release, you specify the exact version of these artifact sources; for example, the number of a build coming from Azure Pipelines, or the version of a build coming from a Jenkins project.

Po vytvoření je vydaná verze nemůžete změnit.After a release is created, you cannot change these versions. Verze je v podstatě definovaná artefakty verze, které tvoří verzi.A release is fundamentally defined by the versioned artifacts that make up the release. Při nasazení verze do různých fází budete nasazovat a ověřovat stejné artefakty ve všech fázích.As you deploy the release to various stages, you will be deploying and validating the same artifacts in all stages.

Jednu verzi kanálu můžete propojit s několika zdroji artefaktů, z nichž jeden je primárním zdrojem.A single release pipeline can be linked to multiple artifact sources, of which one is the primary source. V takovém případě při vytváření vydané verze určíte jednotlivé verze pro každý z těchto zdrojů.In this case, when you create a release, you specify individual versions for each of these sources.

Artefakty v kanálu a vydané verzi

Artefakty jsou centrálně na řadu funkcí v Azure Pipelines.Artifacts are central to a number of features in Azure Pipelines. Některé funkce, které jsou závislé na propojení artefaktů s kanálem verze, jsou:Some of the features that depend on the linking of artifacts to a release pipeline are:

  • Automatické triggery vydaných verzíAuto-trigger releases. Můžete nakonfigurovat, aby se nové verze automaticky vytvořily, když se vytvoří nová verze artefaktu.You can configure new releases to be automatically created whenever a new version of an artifact is produced. Další informace najdete v tématu triggery průběžného nasazování.For more information, see Continuous deployment triggers. Všimněte si, že možnost automatického vytváření vydání je k dispozici pouze pro některé zdroje artefaktů.Note that the ability to automatically create releases is available for only some artifact sources.

  • Podmínky aktivace.Trigger conditions. Můžete nakonfigurovat, aby se vydaná verze vytvořila automaticky, nebo nasazení vydané verze do fáze, která se aktivuje automaticky, pokud jsou splněné jenom konkrétní podmínky artefaktů.You can configure a release to be created automatically, or the deployment of a release to a stage to be triggered automatically, when only specific conditions on the artifacts are met. Můžete například nakonfigurovat, aby se vydané verze automaticky vytvořily jenom v případě, že je z určité větve vytvořený nový Build.For example, you can configure releases to be automatically created only when a new build is produced from a certain branch.

  • Verze artefaktů.Artifact versions. Můžete nakonfigurovat vydání, aby automaticky používalo konkrétní verzi artefaktů sestavení, vždy používat nejnovější verzi, nebo můžete určit verzi při vytvoření vydání.You can configure a release to automatically use a specific version of the build artifacts, to always use the latest version, or to allow you to specify the version when the release is created.

  • Proměnné artefaktů.Artifact variables. Každý artefakt, který je součástí vydané verze, má k němu přidružená metadata, která jsou k dispozici pro úlohy prostřednictvím proměnných.Every artifact that is part of a release has metadata associated with it, exposed to tasks through variables. Tato metadata zahrnují číslo verze artefaktu, větev kódu, ze které byl artefakt vytvořen (v případě artefaktů sestavení nebo zdrojového kódu), kanál, který vytvořil artefakt (v případě artefaktů sestavení) a další.This metadata includes the version number of the artifact, the branch of code from which the artifact was produced (in the case of build or source code artifacts), the pipeline that produced the artifact (in the case of build artifacts), and more. Tyto informace jsou dostupné v úlohách nasazení.This information is accessible in the deployment tasks. Další informace naleznete v tématu proměnné artefaktů.For more information, see Artifact variables.

  • Pracovní položky a potvrzení změn.Work items and commits. Pracovní položky nebo potvrzení, které jsou součástí vydání, jsou vypočítány z verzí artefaktů.The work items or commits that are part of a release are computed from the versions of artifacts. Například každé sestavení v Azure Pipelines je přidruženo k sadě pracovních položek a potvrzení.For example, each build in Azure Pipelines is associated with a set of work items and commits. Pracovní položky nebo potvrzení ve vydané verzi jsou vypočítány jako sjednocení všech pracovních položek a potvrzení všech sestavení mezi aktuální verzí a předchozí verzí.The work items or commits in a release are computed as the union of all work items and commits of all builds between the current release and the previous release. Všimněte si, že Azure Pipelines v tuto chvíli dokáže vypočítat pracovní položky a potvrzení pouze pro určité zdroje artefaktů.Note that Azure Pipelines is currently able to compute work items and commits for only certain artifact sources.

  • Stahování artefaktů.Artifact download. Pokaždé, když je verze nasazená do fáze, ve výchozím nastavení Azure Pipelines automaticky stáhne všechny artefakty v této verzi do agenta , ve kterém je úloha nasazení spuštěná.Whenever a release is deployed to a stage, by default Azure Pipelines automatically downloads all the artifacts in that release to the agent where the deployment job runs. Postup pro stažení artefaktů závisí na typu artefaktu.The procedure to download artifacts depends on the type of artifact. Například Azure Pipelines artefakty jsou staženy pomocí algoritmu, který současně stahuje více souborů.For example, Azure Pipelines artifacts are downloaded using an algorithm that downloads multiple files in parallel. Artefakty Git se stáhnou pomocí funkce knihovny Git.Git artifacts are downloaded using Git library functionality. Další informace najdete v tématu stažení artefaktů.For more information, see Artifact download.

Zdroje artefaktůArtifact sources

Existuje několik typů nástrojů, které můžete použít v procesu životního cyklu aplikace k vytváření nebo ukládání artefaktů.There are several types of tools you might use in your application lifecycle process to produce or store artifacts. Můžete například použít průběžné integrační systémy, například Azure Pipelines, Jenkinse nebo TeamCity, a vydávat artefakty.For example, you might use continuous integration systems such as Azure Pipelines, Jenkins, or TeamCity to produce artifacts. K ukládání artefaktů můžete použít také systémy správy verzí, jako je Git nebo TFVC.You might also use version control systems such as Git or TFVC to store your artifacts. Případně můžete k ukládání artefaktů použít úložiště, jako je Azure Artifacts nebo úložiště NuGet.Or you can use repositories such as Azure Artifacts or a NuGet repository to store your artifacts. Můžete nakonfigurovat Azure Pipelines k nasazení artefaktů ze všech těchto zdrojů.You can configure Azure Pipelines to deploy artifacts from all these sources.

Ve výchozím nastavení bude verze vytvořená z kanálu vydaných verzí používat nejnovější verzi artefaktů.By default, a release created from the release pipeline will use the latest version of the artifacts. V době, kdy propojujete zdroj artefaktů s kanálem verze, můžete toto chování změnit tak, že vyberete jednu z možností pro použití nejnovějšího sestavení z konkrétní větve zadáním značek, konkrétní verze nebo umožníte uživateli zadat verzi při vytvoření vydané verze z kanálu.At the time of linking an artifact source to a release pipeline, you can change this behavior by selecting one of the options to use the latest build from a specific branch by specifying the tags, a specific version, or allow the user to specify the version when the release is created from the pipeline.

Přidání artefaktu

Pokud propojíte více než jednu sadu artefaktů, můžete určit, který primární (výchozí).If you link more than one set of artifacts, you can specify which is the primary (default).

Výběr možnosti výchozí verze

Důležité

Default versionPoložky rozevíracího seznamu artefaktů závisí na repository type definici propojeného sestavení.The Artifacts Default version drop down list items depends on the repository type of the linked build definition.

  • Všechny typy úložišť podporují následující možnosti: Specify at the time of release creation , a Specific version Latest .The following options are supported by all the repository types: Specify at the time of release creation, Specific version, and Latest.

  • Latest from a specific branch with tags a Latest from the build pipeline default branch with tags Možnosti jsou podporovány následujícími typy úložišť: TfsGit , GitHub , Bitbucket a GitHubEnterprise .Latest from a specific branch with tags and Latest from the build pipeline default branch with tags options are supported by the following repository types: TfsGit, GitHub, Bitbucket, and GitHubEnterprise.

  • Latest from the build pipeline default branch with tags není podporován XAML definicemi sestavení.Latest from the build pipeline default branch with tags is not supported by XAML build definitions.

Následující části popisují, jak pracovat s různými typy zdrojů artefaktů.The following sections describe how to work with the different types of artifact sources.

Zdroje artefaktů – Azure PipelinesArtifact sources - Azure Pipelines

Kanál verze můžete propojit s některým z kanálů sestavení v Azure Pipelines nebo kolekci projektů TFS.You can link a release pipeline to any of the build pipelines in Azure Pipelines or TFS project collection.

Poznámka

V kanálu sestavení musíte zahrnout úlohu artefakty publikování .You must include a Publish Artifacts task in your build pipeline. V případě kanálů sestavení XAML je artefakt s odkládacím názvem publikován implicitně.For XAML build pipelines, an artifact with the name drop is published implicitly.

Některé rozdíly mezi různými verzemi TFS a Azure Pipelines jsou:Some of the differences in capabilities between different versions of TFS and Azure Pipelines are:

  • TFS 2015: kanály sestavení můžete propojit pouze ze stejného projektu kolekce.TFS 2015: You can link build pipelines only from the same project of your collection. Můžete propojit několik definic, ale nemůžete zadat výchozí verze.You can link multiple definitions, but you cannot specify default versions. Aktivační událost průběžného nasazování můžete nastavit jenom pro jednu z definic.You can set up a continuous deployment trigger on only one of the definitions. Pokud je propojeno více kanálů sestavení, jsou použity nejnovější sestavení všech ostatních definic společně se sestavením, které aktivovalo vytváření vydání.When multiple build pipelines are linked, the latest builds of all the other definitions are used, along with the build that triggered the release creation.

  • TFS 2017 a novější a Azure Pipelines: kanály sestavení můžete propojit z libovolného projektu v Azure Pipelines nebo TFS.TFS 2017 and newer and Azure Pipelines: You can link build pipelines from any of the projects in Azure Pipelines or TFS. Můžete propojit více kanálů sestavení a zadat výchozí hodnoty pro každý z nich.You can link multiple build pipelines and specify default values for each of them. Aktivační události průběžného nasazování můžete nastavit na více zdrojů sestavení.You can set up continuous deployment triggers on multiple build sources. Po dokončení kteréhokoliv sestavení se spustí vytvoření vydané verze.When any of the builds completes, it will trigger the creation of a release.

Při použití Azure Pipelinesch zdrojů jsou k dispozici následující funkce:The following features are available when using Azure Pipelines sources:

FunkceFeature Chování s Azure Pipelinesmi zdrojiBehavior with Azure Pipelines sources
Automatické triggery vydaných verzíAuto-trigger releases Nové verze lze vytvořit automaticky při vytváření nových sestavení (včetně sestavení XAML).New releases can be created automatically when new builds (including XAML builds) are produced. Podrobnosti najdete v tématu průběžné nasazování .See Continuous Deployment for details. V rámci kanálu sestavení nemusíte konfigurovat cokoli.You do not need to configure anything within the build pipeline. Rozdíly mezi verzemi TFS najdete v poznámkách výše.See the notes above for differences between version of TFS.
Proměnné artefaktůArtifact variables Pro sestavení z Azure Pipelines je podporována řada proměnných artefaktů .A number of artifact variables are supported for builds from Azure Pipelines.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines se integruje s pracovními položkami v TFS a Azure Pipelines.Azure Pipelines integrates with work items in TFS and Azure Pipelines. Tyto pracovní položky jsou také zobrazeny v podrobnostech o vydaných verzích.These work items are also shown in the details of releases. Azure Pipelines se integruje s řadou systémů správy verzí, jako jsou TFVC a Git, GitHub, subverze a další úložiště Git.Azure Pipelines integrates with a number of version control systems such as TFVC and Git, GitHub, Subversion, and Other Git repositories. Azure Pipelines zobrazuje potvrzení pouze v případě, že je sestavení vytvořeno ze zdrojového kódu v TFVC nebo Git.Azure Pipelines shows the commits only when the build is produced from source code in TFVC or Git.
Stažení artefaktůArtifact download Ve výchozím nastavení jsou artefakty sestavení staženy do agenta.By default, build artifacts are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.
Oddíl nasazení v builduDeployment section in build Souhrn sestavení obsahuje oddíl nasazení , který obsahuje seznam všech fází, do kterých bylo sestavení nasazeno.The build summary includes a Deployment section, which lists all the stages to which the build was deployed.

Ve výchozím nastavení se vydaných verzí spustí s oborem autorizace úlohy na úrovni kolekce.By default, the releases execute in with a collection level Job authorization scope. To znamená, že vydání mají přístup k prostředkům ve všech projektech v organizaci (nebo kolekci pro Azure DevOps Server).That means releases can access resources in all projects in the organization (or collection for Azure DevOps Server). To je užitečné při propojování artefaktů sestavení z jiných projektů.This is useful when linking build artifacts from other projects. Můžete povolit možnost omezit rozsah autorizace úlohy na aktuální projekt pro kanály vydaných verzí v nastavení projektu, chcete-li omezit přístup k artefaktům pro verze v projektu.You can enable Limit job authorization scope to current project for release pipelines in project settings to restrict access to artifacts for releases in a project.

Nastavení rozsahu autorizace úlohy pro organizaci:To set job authorization scope for the organization:

  • Přejděte na stránku nastavení vaší organizace v uživatelském rozhraní Azure DevOps.Navigate to your organization settings page in the Azure DevOps user interface.
  • V části kanály vyberte nastavení.Select Settings under Pipelines.
  • Pokud chcete omezit rozsah na aktuální projekt, zapněte pro kanály vydaných verzí rozsah autorizace úlohy přepínač omezit na aktuální projekt .Turn on the toggle Limit job authorization scope to current project for release pipelines to limit the scope to current project. Toto je doporučené nastavení, protože vylepšuje zabezpečení vašich kanálů.This is the recommended setting, as it enhances security for your pipelines.

Nastavení rozsahu autorizace úlohy pro určitý projekt:To set job authorization scope for a specific project:

  • Přejděte na stránku nastavení projektu v uživatelském rozhraní Azure DevOps.Navigate to your project settings page in the Azure DevOps user interface.
  • V části kanály vyberte nastavení.Select Settings under Pipelines.
  • Pro omezení rozsahu na projekt zapněte přepínač omezit rozsah autorizace úlohy na aktuální projekt.Turn on the toggle Limit job authorization scope to current project to limit the scope to project. Toto je doporučené nastavení, protože vylepšuje zabezpečení vašich kanálů.This is the recommended setting, as it enhances security for your pipelines.

Poznámka

Pokud je obor nastaven na hodnotu projekt na úrovni organizace, nemůžete změnit obor v každém projektu.If the scope is set to project at the organization level, you cannot change the scope in each project.

Všechny úlohy ve vydaných verzích se spouštějí s rozsahem autorizace úlohy nastaveným na shromažďování.All jobs in releases run with the job authorization scope set to collection. Jinými slovy, tyto úlohy mají přístup k prostředkům ve všech projektech v kolekci projektu.In other words, these jobs have access to resources in all projects in your project collection.

Zdroje artefaktů – TFVC, Git a GitHubArtifact sources - TFVC, Git, and GitHub

Existují scénáře, ve kterých můžete chtít použít artefakty uložené v systému správy verzí přímo bez jejich předání prostřednictvím kanálu sestavení.There are scenarios in which you may want to consume artifacts stored in a version control system directly, without passing them through a build pipeline. Například:For example:

  • Vyvíjíte aplikaci PHP nebo JavaScript, která nevyžaduje explicitní kanál sestavení.You are developing a PHP or a JavaScript application that does not require an explicit build pipeline.

  • Můžete spravovat konfigurace pro různé fáze v různých úložištích správy verzí a chcete tyto konfigurační soubory spotřebovat přímo ze správy verzí jako součást kanálu nasazení.You manage configurations for various stages in different version control repositories, and you want to consume these configuration files directly from version control as part of the deployment pipeline.

  • Svou infrastrukturu a konfiguraci můžete spravovat jako kód (například šablony Azure Resource Manager) a chcete tyto soubory spravovat v úložišti správy verzí.You manage your infrastructure and configuration as code (such as Azure Resource Manager templates) and you want to manage these files in a version control repository.

Vzhledem k tomu, že v jednom kanálu vydání můžete nakonfigurovat více zdrojů artefaktů, můžete propojit kanál sestavení, který vytváří binární soubory aplikace, a úložiště správy verzí, které ukládá konfigurační soubory do stejného kanálu, a při nasazení použít dvě sady artefaktů.Because you can configure multiple artifact sources in a single release pipeline, you can link both a build pipeline that produces the binaries of the application as well as a version control repository that stores the configuration files into the same pipeline, and use the two sets of artifacts together while deploying.

Azure Pipelines se integruje do úložišť Správa verzí Team Foundation (TFVC), úložišť Git a úložišť GitHubu.Azure Pipelines integrates with Team Foundation Version Control (TFVC) repositories, Git repositories, and GitHub repositories.

Kanál verze můžete propojit s jakýmkoli z úložišť Git nebo TFVC v některém z projektů v kolekci (k těmto úložištím budete potřebovat přístup pro čtení).You can link a release pipeline to any of the Git or TFVC repositories in any of the projects in your collection (you will need read access to these repositories). Při nasazování artefaktů řízení verzí v rámci stejné kolekce se nevyžaduje žádné další nastavení.No additional setup is required when deploying version control artifacts within the same collection.

Když propojíte úložiště Git nebo GitHub a vyberete větev, můžete po uložení artefaktu upravit výchozí vlastnosti typů artefaktů.When you link a Git or GitHub repository and select a branch, you can edit the default properties of the artifact types after the artifact has been saved. To je užitečné zejména ve scénářích, kdy se větev pro stabilní verze artefaktu mění a verze průběžného doručování by měly pomocí této větve získat novější verze artefaktu.This is particularly useful in scenarios where the branch for the stable version of the artifact changes, and continuous delivery releases should use this branch to obtain newer versions of the artifact. Můžete také zadat podrobnosti rezervace, například to, jestli se mají rezervovat dílčí moduly a LFS, a hloubku omezeného načtení.You can also specify details of the checkout, such as whether checkout submodules and LFS-tracked files, and the shallow fetch depth.

Když propojíte větev TFVC, můžete zadat sadu změn, která se má nasadit při vytváření vydané verze.When you link a TFVC branch, you can specify the changeset to be deployed when creating a release.

Při použití TFVC, Gitu a GitHubu jsou k dispozici následující funkce:The following features are available when using TFVC, Git, and GitHub sources:

FunkceFeature Chování se zdroji TFVC, Git a GitHubuBehavior with TFVC, Git, and GitHub sources
Automatické triggery vydaných verzíAuto-trigger releases Můžete nakonfigurovat Trigger průběžného nasazování pro vložení do úložiště v kanálu vydávání verzí.You can configure a continuous deployment trigger for pushes into the repository in a release pipeline. To může automaticky aktivovat vydání při provedení nového potvrzení do úložiště.This can automatically trigger a release when a new commit is made to a repository. Viz triggery.See Triggers.
Proměnné artefaktůArtifact variables Pro zdroje správy verzí je podporována řada proměnných artefaktů .A number of artifact variables are supported for version control sources.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení přidružené k vydání při použití artefaktů správy verzí.Azure Pipelines cannot show work items or commits associated with releases when using version control artifacts.
Stažení artefaktůArtifact download Ve výchozím nastavení jsou artefakty řízení verze staženy do agenta.By default, version control artifacts are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Ve výchozím nastavení se vydaných verzí spustí s oborem autorizace úlohy na úrovni kolekce.By default, the releases execute in with a collection level Job authorization scope. To znamená, že vydání mají přístup ke všem úložištím v organizaci (nebo kolekci pro Azure DevOps Server).That means releases can access all repositories in the organization (or collection for Azure DevOps Server). Můžete povolit možnost omezit rozsah autorizace úlohy na aktuální projekt pro kanály vydaných verzí v nastavení projektu, chcete-li omezit přístup k artefaktům pro verze v projektu.You can enable Limit job authorization scope to current project for release pipelines in project settings to restrict access to artifacts for releases in a project.

Zdroje artefaktů – JenkinseArtifact sources - Jenkins

Aby bylo možné využívat artefakty Jenkinse, je nutné vytvořit připojení služby s přihlašovacími údaji pro připojení k serveru Jenkinse.To consume Jenkins artifacts, you must create a service connection with credentials to connect to your Jenkins server. Další informace najdete v tématech připojení služby a připojení služby Jenkinse.For more information, see service connections and Jenkins service connection. Pak můžete propojit projekt Jenkinse s kanálem pro vydávání verzí.You can then link a Jenkins project to a release pipeline. Aby bylo možné publikovat artefakty, musí být projekt Jenkinse nakonfigurovaný pomocí akce po sestavení.The Jenkins project must be configured with a post build action to publish the artifacts.

Při použití Jenkinse zdrojů jsou k dispozici následující funkce:The following features are available when using Jenkins sources:

FunkceFeature Chování s Jenkinse zdrojiBehavior with Jenkins sources
Automatické triggery vydaných verzíAuto-trigger releases Můžete nakonfigurovat Trigger průběžného nasazování pro vložení do úložiště v kanálu vydávání verzí.You can configure a continuous deployment trigger for pushes into the repository in a release pipeline. To může automaticky aktivovat vydání při provedení nového potvrzení do úložiště.This can automatically trigger a release when a new commit is made to a repository. Viz triggery.See Triggers.
Proměnné artefaktůArtifact variables Pro sestavení z Jenkinse je podporována řada proměnných artefaktů .A number of artifact variables are supported for builds from Jenkins.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení pro sestavení Jenkinse.Azure Pipelines cannot show work items or commits for Jenkins builds.
Stažení artefaktůArtifact download Ve výchozím nastavení se Jenkinse sestavení stáhnou do agenta.By default, Jenkins builds are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Artefakty vygenerované Jenkinse sestaveními jsou obvykle šířeny do úložišť úložiště pro archivaci a sdílení.Artifacts generated by Jenkins builds are typically propagated to storage repositories for archiving and sharing. Úložiště objektů BLOB v Azure je jedním z podporovaných úložišť, které vám umožní využívat projekty Jenkinse, které publikují do úložiště Azure jako zdroje artefaktů v kanálu vydávání verzí.Azure blob storage is one of the supported repositories, allowing you to consume Jenkins projects that publish to Azure storage as artifact sources in a release pipeline. Nasazení stahují artefakty automaticky z Azure do agentů.Deployments download the artifacts automatically from Azure to the agents. V této konfiguraci není nutné připojení mezi agentem a serverem Jenkinse.In this configuration, connectivity between the agent and the Jenkins server is not required. Agenty hostované Microsoftem se dají použít bez vystavení serveru na internetu.Microsoft-hosted agents can be used without exposing the server to internet.

Poznámka

Azure Pipelines nemusí být schopné kontaktovat server Jenkinse, pokud je například ve vaší podnikové síti.Azure Pipelines may not be able to contact your Jenkins server if, for example, it is within your enterprise network. V takovém případě můžete integrovat Azure Pipelines s Jenkinse tím, že nastavíte místního agenta, který bude mít přístup k serveru Jenkinse.In this case you can integrate Azure Pipelines with Jenkins by setting up an on-premises agent that can access the Jenkins server. Při propojování se sestavením nebudete moci zobrazit název Jenkinsech projektů, ale můžete ho zadat do pole dialogu odkaz.You will not be able to see the name of your Jenkins projects when linking to a build, but you can type this into the link dialog field.

Další informace o možnostech integrace Jenkinse najdete v tématu integrace Azure Pipelines s úlohami Jenkinse, kanály a artefakty.For more information about Jenkins integration capabilities, see Azure Pipelines Integration with Jenkins Jobs, Pipelines, and Artifacts.

Zdroje artefaktů – Azure Container Registry, Docker, KubernetesArtifact sources - Azure Container Registry, Docker, Kubernetes

Při nasazování kontejnerizovaných aplikací se změny image kontejneru nejprve nasdílí do registru kontejneru.When deploying containerized apps, the container image is first pushed to a container registry. Po dokončení nahrávání se image kontejneru dá nasadit do služby Web App for Containers nebo do clusteru Docker/Kubernetes.After the push is complete, the container image can be deployed to the Web App for Containers service or a Docker/Kubernetes cluster. Musíte vytvořit připojení služby s přihlašovacími údaji, abyste se mohli připojit ke službě, abyste mohli nasazovat image umístěné v nějakém nebo do Azure.You must create a service connection with credentials to connect to your service to deploy images located there, or to Azure. Další informace najdete v tématu připojení služby.For more information, see service connections.

K dispozici jsou následující funkce při použití Azure Container Registry, Docker Kubernetes sources:The following features are available when using Azure Container Registry, Docker, Kubernetes sources:

FunkceFeature Chování se zdroji DockerBehavior with Docker sources
Automatické triggery vydaných verzíAuto-trigger releases Pro obrázky můžete nakonfigurovat Trigger průběžného nasazování.You can configure a continuous deployment trigger for images. To může automaticky aktivovat vydání při provedení nového potvrzení do úložiště.This can automatically trigger a release when a new commit is made to a repository. Viz triggery.See Triggers.
Proměnné artefaktůArtifact variables Pro sestavení je podporována řada proměnných artefaktů .A number of artifact variables are supported for builds.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení změn.Azure Pipelines cannot show work items or commits.
Stažení artefaktůArtifact download Ve výchozím nastavení jsou sestavení stažena do agenta.By default, builds are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Poznámka

V případě průběžného nasazování z více zdrojů artefaktů (více registrů/úložišť) není možné mapovat zdroje artefaktů tak, aby aktivovaly konkrétní fáze.In the case of continuous deployment from multiple artifact sources (multiple registries/repositories), it isn't possible to map artifact sources to trigger particular stages. Vydaná verze bude vytvořena, kdykoli bude k dispozici vložení do některého ze zdrojů artefaktů.A release will be created anytime there is a push to any of the artifact sources. Pokud chcete namapovat zdroj artefaktů pro aktivaci konkrétní fáze, doporučuje se rozložit kanál verze na více kanálů vydávání verzí.If you wish to map an artifact source to trigger a specific stage, the recommended way is to decompose the release pipeline into multiple release pipelines.

Zdroje artefaktů – Azure ArtifactsArtifact sources - Azure Artifacts

Scénáře, kdy je vhodné tyto artefakty spotřebovat:Scenarios where you may want to consume these artifacts are:

  1. Máte k dispozici sestavení vaší aplikace (například TFS, Azure Pipelines, TeamCity, Jenkinse), které jste publikovali jako balíček Azure Artifacts a chcete tento artefakt ve vydané verzi spotřebovat.You have your application build (such as TFS, Azure Pipelines, TeamCity, Jenkins) published as a package to Azure Artifacts and you want to consume the artifact in a release.
  2. V rámci nasazení vaší aplikace potřebujete další balíčky, které jsou uložené v Azure Artifacts.As part of your application deployment, you need additional packages stored in Azure Artifacts.

Když propojíte takový artefakt s kanálem verze, musíte vybrat informační kanál, balíček a výchozí verzi balíčku.When you link such an artifact to your release pipeline, you must select the Feed, Package, and the Default version for the package. Můžete si vybrat nejnovější verzi balíčku, použít konkrétní verzi nebo vybrat verzi v době vytváření vydaných verzí.You can choose to pick up the latest version of the package, use a specific version, or select the version at the time of release creation. Během nasazování se balíček stáhne do složky agenta a obsah se extrahuje jako součást provádění úlohy.During deployment, the package is downloaded to the agent folder and the contents are extracted as part of the job execution.

Při použití Azure Artifactsch zdrojů jsou k dispozici následující funkce:The following features are available when using Azure Artifacts sources:

FunkceFeature Chování s Azure Artifactsmi zdrojiBehavior with Azure Artifacts sources
Automatické triggery vydaných verzíAuto-trigger releases Můžete nakonfigurovat Trigger průběžného nasazování pro balíčky.You can configure a continuous deployment trigger for packages. To může automaticky aktivovat vydání při aktualizaci balíčku.This can automatically trigger a release when a package is updated. Viz triggery.See Triggers.
Proměnné artefaktůArtifact variables Pro balíčky je podporována řada proměnných artefaktů .A number of artifact variables are supported for packages.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení změn.Azure Pipelines cannot show work items or commits.
Stažení artefaktůArtifact download Ve výchozím nastavení se balíčky stáhnou do agenta.By default, packages are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Zpracování snímků MavenHandling Maven Snapshots

Při získávání artefaktů Maven a artefakt je sestavení snímku, lze stáhnout více verzí tohoto snímku najednou (například, myApplication-2.1.0.BUILD-20190920.220048-3.jar myApplication-2.1.0.BUILD-20190820.221046-2.jar myApplication-2.1.0.BUILD-20190820.220331-1.jar ).When obtaining Maven artifacts and the artifact is a snapshot build, multiple versions of that snapshot may be downloaded at once (e.g. myApplication-2.1.0.BUILD-20190920.220048-3.jar, myApplication-2.1.0.BUILD-20190820.221046-2.jar, myApplication-2.1.0.BUILD-20190820.220331-1.jar). Před dalším postupem nasazení bude pravděpodobně nutné přidat další automatizaci, aby bylo možné zachovat pouze nejnovější artefakt.You will likely need to add additional automation to keep only the latest artifact prior to subsequent deployment steps. To lze provést pomocí následujícího fragmentu kódu prostředí PowerShell:This can be accomplished with the following PowerShell snippet:

# Remove all copies of the artifact except the one with the lexicographically highest value.
Get-Item "myApplication*.jar" | Sort-Object -Descending Name | Select-Object -SkipIndex 0 | Remove-Item

Další informace najdete v přehledu Azure Artifacts .For more information, see the Azure Artifacts overview.

Zdroje artefaktů – externí nebo místní TFSArtifact sources - External or on-premises TFS

K nasazení artefaktů publikovaných místním serverem TFS můžete použít Azure Pipelines.You can use Azure Pipelines to deploy artifacts published by an on-premises TFS server. Nemusíte mít na internetu viditelný server TFS; Právě jste nastavili místního agenta pro automatizaci.You don't need to make the TFS server visible on the Internet; you just set up an on-premises automation agent. Buildy z místního serveru TFS se stáhnou přímo do místního agenta a pak se nasadí na zadané cílové servery.Builds from an on-premises TFS server are downloaded directly into the on-premises agent, and then deployed to the specified target servers. Nebudou opustit podnikovou síť.They will not leave your enterprise network. To vám umožní využívat všechny vaše investice do místního serveru TFS a využívat možnosti vydání v Azure Pipelines.This allows you to leverage all of your investments in your on-premises TFS server, and take advantage of the release capabilities in Azure Pipelines.

Tip

Pomocí tohoto mechanismu můžete také nasadit artefakty publikované v jednom předplatném Azure Pipelines v jiném Azure Pipelines nebo nasadit artefakty publikované v jednom Team Foundation Server z jiného Team Foundation Server.Using this mechanism, you can also deploy artifacts published in one Azure Pipelines subscription in another Azure Pipelines, or deploy artifacts published in one Team Foundation Server from another Team Foundation Server.

Chcete-li povolit tyto scénáře, je nutné nainstalovat artefakty TFS pro rozšíření Azure Pipelines z Visual Studio Marketplace.To enable these scenarios, you must install the TFS artifacts for Azure Pipelines extension from Visual Studio Marketplace. Pak vytvořte připojení služby s přihlašovacími údaji pro připojení k serveru TFS (podrobnosti najdete v tématu připojení služby ).Then create a service connection with credentials to connect to your TFS server (see service connections for details).

Pak můžete propojit kanál sestavení TFS s kanálem pro vydávání verzí.You can then link a TFS build pipeline to your release pipeline. V seznamu typ vyberte externí sestavení TFS .Choose External TFS Build in the Type list.

Při použití externích zdrojů TFS jsou k dispozici následující funkce:The following features are available when using external TFS sources:

FunkceFeature Chování s externími zdroji TFSBehavior with external TFS sources
Automatické triggery vydaných verzíAuto-trigger releases Aktivační událost průběžného nasazování pro externí zdroje TFS se nedá nakonfigurovat v kanálu vydávání verzí.You cannot configure a continuous deployment trigger for external TFS sources in a release pipeline. Chcete-li po dokončení sestavení automaticky vytvořit novou vydanou verzi, je nutné přidat do kanálu sestavení v externím serveru TFS skript pro vyvolání Azure Pipelines rozhraní REST API a vytvořit novou verzi.To automatically create a new release when a build is complete, you would need to add a script to your build pipeline in the external TFS server to invoke Azure Pipelines REST APIs and to create a new release.
Proměnné artefaktůArtifact variables Pro externí zdroje TFS je podporována řada proměnných artefaktů .A number of artifact variables are supported for external TFS sources.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení pro externí zdroje TFS.Azure Pipelines cannot show work items or commits for external TFS sources.
Stažení artefaktůArtifact download Ve výchozím nastavení jsou externí artefakty TFS staženy do agenta.By default, External TFS artifacts are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Poznámka

Azure Pipelines nemusí být schopné kontaktovat místní server TFS v případě, že je ve vaší podnikové síti.Azure Pipelines may not be able to contact an on-premises TFS server in case it's within your enterprise network. V takovém případě můžete integrovat Azure Pipelines se sadou TFS tím, že nastavíte místního agenta, který bude mít přístup k serveru TFS.In that case you can integrate Azure Pipelines with TFS by setting up an on-premises agent that can access the TFS server. Při propojování k sestavení nebudete moci zobrazit názvy projektů TFS ani kanály sestavení, ale tyto proměnné můžete zahrnout do polí v dialogovém okně odkaz.You will not be able to see the name of your TFS projects or build pipelines when linking to a build, but you can include those variables in the link dialog fields. Kromě toho, když vytvoříte vydání, Azure Pipelines nemusí být schopné zadat dotaz na server TFS pro čísla sestavení.In addition, when you create a release, Azure Pipelines may not be able to query the TFS server for the build numbers. Místo toho zadejte ID sestavení (nikoli číslo sestavení) požadovaného sestavení v příslušném poli nebo vyberte nejnovější sestavení.Instead, enter the Build ID (not the build number) of the desired build in the appropriate field, or select the Latest build.

Zdroje artefaktů – TeamCityArtifact sources - TeamCity

Aby bylo možné integrovat s TeamCity, musíte nejdřív na webu Marketplace nainstalovat artefakty TeamCity pro rozšíření Azure Pipelines .To integrate with TeamCity, you must first install the TeamCity artifacts for Azure Pipelines extension from Marketplace.

Pokud chcete využívat artefakty TeamCity, Začněte vytvořením připojení služby s přihlašovacími údaji pro připojení k vašemu serveru TeamCity (podrobnosti najdete v tématu připojení ke službě ).To consume TeamCity artifacts, start by creating a service connection with credentials to connect to your TeamCity server (see service connections for details).

Pak můžete propojit konfiguraci sestavení TeamCity s kanálem verze.You can then link a TeamCity build configuration to a release pipeline. Konfigurace sestavení TeamCity musí být nakonfigurována s akcí pro publikování artefaktů.The TeamCity build configuration must be configured with an action to publish the artifacts.

Při použití TeamCity zdrojů jsou k dispozici následující funkce:The following features are available when using TeamCity sources:

FunkceFeature Chování s TeamCity zdrojiBehavior with TeamCity sources
Automatické triggery vydaných verzíAuto-trigger releases Aktivační událost průběžného nasazování pro TeamCity zdroje v kanálu verze nelze nakonfigurovat.You cannot configure a continuous deployment trigger for TeamCity sources in a release pipeline. Chcete-li po dokončení sestavení vytvořit nové vydání automaticky, přidejte do projektu TeamCity skript, který vyvolá rozhraní REST API Azure Pipelines k vytvoření nové vydané verze.To create a new release automatically when a build is complete, add a script to your TeamCity project that invokes the Azure Pipelines REST APIs to create a new release.
Proměnné artefaktůArtifact variables Pro sestavení z TeamCity je podporována řada proměnných artefaktů .A number of artifact variables are supported for builds from TeamCity.
Pracovní položky a potvrzeníWork items and commits Azure Pipelines nemůže zobrazit pracovní položky nebo potvrzení pro sestavení TeamCity.Azure Pipelines cannot show work items or commits for TeamCity builds.
Stažení artefaktůArtifact download Ve výchozím nastavení se TeamCity sestavení stáhnou do agenta.By default, TeamCity builds are downloaded to the agent. Ve fázi můžete nakonfigurovat možnost pro přeskočení stahování artefaktů.You can configure an option in the stage to skip the download of artifacts.

Poznámka

Azure Pipelines nemusí být schopné kontaktovat server TeamCity, pokud je například ve vaší podnikové síti.Azure Pipelines may not be able to contact your TeamCity server if, for example, it is within your enterprise network. V takovém případě můžete integrovat Azure Pipelines s TeamCity tím, že nastavíte místního agenta, který bude mít přístup k serveru TeamCity.In this case you can integrate Azure Pipelines with TeamCity by setting up an on-premises agent that can access the TeamCity server. Při propojování se sestavením nebudete moci zobrazit název TeamCitych projektů, ale můžete ho zadat do pole dialogu odkaz.You will not be able to see the name of your TeamCity projects when linking to a build, but you can type this into the link dialog field.

Zdroje artefaktů – vlastní artefaktyArtifact sources - Custom artifacts

Kromě integrovaných zdrojů artefaktů Azure Artifacts podporuje integraci jakýchkoli vlastních zdrojů artefaktů s modelem rozšiřitelnosti artefaktů.In addition to built-in artifact sources, Azure Artifacts supports integrating any custom artifact source with the artifact extensibility model. Můžete připojit libovolný vlastní zdroj artefaktů a Azure DevOps bude poskytovat prvotřídní uživatelské prostředí a bezproblémové integrace.You can plug in any custom artifact source, and Azure DevOps will provide a first-class user experience and seamless integration.

Další informace najdete v tématu rozšiřující model artefaktů Azure DevOps.For more information, see Azure DevOps artifact extensibility model.

Zdroje artefaktů – další zdrojeArtifact sources - Other sources

Vaše artefakty mohou být vytvořeny a zpřístupněny jinými typy zdrojů, jako je například úložiště NuGet.Your artifacts may be created and exposed by other types of sources such as a NuGet repository. I když dál rozbalíme typy zdrojů artefaktů, které jsou podporované v Azure Pipelines, můžete je začít používat, aniž byste čekali na podporu pro konkrétní typ zdroje.While we continue to expand the types of artifact sources supported in Azure Pipelines, you can start using it without waiting for support for a specific source type. Jednoduše přeskočte propojení zdrojů artefaktů v kanálu vydání a přidejte vlastní úkoly do fází, které stáhnou artefakty přímo ze zdroje.Simply skip the linking of artifact sources in a release pipeline, and add custom tasks to your stages that download the artifacts directly from your source.

Alias zdroje artefaktůArtifact source alias

Aby se zajistila jedinečnost každého stažení artefaktů, každý zdroj artefaktů propojený s kanálem verze se automaticky doručí na konkrétní umístění pro stahování, které se označuje jako _source alias_ .To ensure the uniqueness of every artifact download, each artifact source linked to a release pipeline is automatically provided with a specific download location known as the _source alias_. K tomuto umístění je možné přistupovat prostřednictvím proměnné:This location can be accessed through the variable:

$(System.DefaultWorkingDirectory)\[source alias]

Tato jedinečnost také zajišťuje, že pokud později přejmenujete zdroj propojeného artefaktu v původním umístění (například přejmenujete kanál sestavení v Azure Pipelines nebo projektu v Jenkinse), nemusíte upravovat vlastnosti úlohy, protože umístění pro stahování definované v agentovi se nemění.This uniqueness also ensures that, if you later rename a linked artifact source in its original location (for example, rename a build pipeline in Azure Pipelines or a project in Jenkins), you don't need to edit the task properties because the download location defined in the agent does not change.

Zdrojový alias je ve výchozím nastavení název vybraného zdroje při propojení zdroje artefaktu s předponou podtržítka; v závislosti na typu zdroje artefaktu se bude jednat o název kanálu sestavení, úlohy, projektu nebo úložiště.The source alias is, by default, the name of the source selected when you linked the artifact source, prefixed with an underscore; depending on the type of the artifact source this will be the name of the build pipeline, job, project, or repository. Alias zdroje můžete upravit z karty artefakty v kanálu uvolnění; například při změně názvu kanálu sestavení a chcete použít alias zdroje, který odráží název kanálu sestavení.You can edit the source alias from the artifacts tab of a release pipeline; for example, when you change the name of the build pipeline and you want to use a source alias that reflects the name of the build pipeline.

Primární zdrojPrimary source

Když propojíte více zdrojů artefaktů s kanálem verze, jedna z nich je určena jako primární zdroj artefaktů.When you link multiple artifact sources to a release pipeline, one of them is designated as the primary artifact source. Primární zdroj artefaktu se používá k nastavení počtu předem definovaných proměnných.The primary artifact source is used to set a number of pre-defined variables. Dá se použít taky při vydávání názvů.It can also be used in naming releases.

Stažení artefaktůArtifact download

Když nasadíte vydání verze do fáze, artefakty verze z každého ze zdrojů se ve výchozím nastavení stáhnou do agenta automatizace, aby úlohy běžící v rámci této fáze mohly tyto artefakty nasadit.When you deploy a release to a stage, the versioned artifacts from each of the sources are, by default, downloaded to the automation agent so that tasks running within that stage can deploy these artifacts. Artefakty stažené do agenta se po dokončení vydání neodstraní.The artifacts downloaded to the agent are not deleted when a release is completed. Při zahájení další verze ale stažené artefakty se odstraní a nahradí se novou sadou artefaktů.However, when you initiate the next release, the downloaded artifacts are deleted and replaced with the new set of artifacts.

Nová jedinečná složka v agentovi se vytvoří pro každý kanál verze při zahájení vydání a artefakty se stáhnou do této složky.A new unique folder in the agent is created for every release pipeline when you initiate a release, and the artifacts are downloaded into that folder. $(System.DefaultWorkingDirectory)Proměnná se mapuje do této složky.The $(System.DefaultWorkingDirectory) variable maps to this folder.

Azure Pipelines aktuálně neprovádí žádnou optimalizaci, aby se zabránilo stahování nezměněných artefaktů, pokud je stejná verze znovu nasazena.Azure Pipelines currently does not perform any optimization to avoid downloading the unchanged artifacts if the same release is deployed again. Kromě toho, protože dříve stažený obsah je vždy odstraněn při zahájení nové verze, Azure Pipelines nemůže agentovi provádět přírůstkové stahování.In addition, because the previously downloaded contents are always deleted when you initiate a new release, Azure Pipelines cannot perform incremental downloads to the agent.

Můžete ale dát pokyn, aby Azure Pipelines Přeskočit automatické stahování artefaktů do agenta pro konkrétní úlohu a fázi nasazení, pokud chcete.You can, however, instruct Azure Pipelines to skip the automatic download of artifacts to the agent for a specific job and stage of the deployment if you wish. Obvykle to provedete, když úkoly v této úloze nevyžadují žádné artefakty, nebo Pokud implementujete vlastní kód v úloze ke stažení artefaktů, které požadujete.Typically, you will do this when the tasks in that job do not require any artifacts, or if you implement custom code in a task to download the artifacts you require.

V Azure Pipelines můžete ale vybrat, které artefakty chcete stáhnout do agenta pro konkrétní úlohu a fázi nasazení.In Azure Pipelines, you can, however, select which artifacts you want to download to the agent for a specific job and stage of the deployment. Obvykle to provedete tak, aby se zlepšila efektivita kanálu nasazení, pokud úkoly v této úloze nevyžadují všechny nebo žádné artefakty nebo Pokud implementujete vlastní kód v úloze ke stažení artefaktů, které požadujete.Typically, you will do this to improve the efficiency of the deployment pipeline when the tasks in that job do not require all or any of the artifacts, or if you implement custom code in a task to download the artifacts you require.

Výběr artefaktů ke stažení

Proměnné artefaktůArtifact variables

Azure Pipelines zpřístupňuje sadu předem definovaných proměnných, které můžete používat a používat v úlohách a skriptech. například při spouštění skriptů PowerShellu v úlohách nasazení.Azure Pipelines exposes a set of pre-defined variables that you can access and use in tasks and scripts; for example, when executing PowerShell scripts in deployment jobs. Pokud je k dispozici více zdrojů artefaktů propojených s kanálem verze, můžete získat přístup k informacím o každé z nich.When there are multiple artifact sources linked to a release pipeline, you can access information about each of these. Seznam všech předem definovaných proměnných artefaktů naleznete v tématu Variables.For a list of all pre-defined artifact variables, see variables.

Další informaceAdditional information

Nápověda a podporaHelp and support