Populate vaults with packages

This topic describes guidelines and common use cases for storing packages in a vault and explains how to copy a vault's URL to use it in your build and deployment processes.

Guidelines for package deployment

There are many reasons to store binaries in a vault, but these are the common use cases:

Internal Binaries built from your software. When you publish these package types, they typically do not need to be approved and can be consumed by developers.
External

Components downloaded from third-party vendors, such as Maven or Python PIP. When a package of this type has been added to a vault, it can be reviewed, approved, and then consumed by developers.

You can use external packages in build and deployment processes only after the packages have been approved. For details, see Review and approve vault packages.

Guidelines for deploying packages:

  • You can deploy artifacts to both local and remote vaults.

  • To deliver to a remote vault, make sure the vault is not set to read-only. For details, see Create and manage vaults.

  • Only the chains that run from trusted products can deliver to a vault. For details, see Define trusted products for a vault.

  • When building software, you need to specify the URL for the vault you are deploying to or pulling from. The URL configuration depends on the package type, build systems, and IDEs you are using. For details, see your package manager's user help.

Back to top

Copy vault URL

Specify a vault's URL in your build and deployment processes to point to the vault location in PulseUno and deliver packages to the vault.

After you deliver packages to a vault, publish them so that they can be can be reviewed by approvers. For details, see Publish packages to a vault.

Vault URL format

Use the following URL format to specify the vault location in PulseUno:

Maven, npm, PyPI http://<hostname>:<port>/vault-server/<vault-type>/<space-name>/<vault-name>
Docker <hostname>:<port>/<space-name>/<vault-name>

where:

Parameter Description
<hostname>:<port> Specifies the machine name and port number where the PulseUno vault is located, for example, dev:8080.
vault-server Specify this parameter for Maven, npm, and PyPI.
<vault-type> Specifies the vault type: maven, npm, docker, or PyPI.
<space-name> Specifies the PulseUno space where the vault is located, for example, app.
<vault-name> Specifies the vault that will be populated with package contents, for example, dev-cache.

Example: Maven vault URL: http://dev:8080/vault-server/maven/app/dev-cache

To copy a vault's URL:

  1. In PulseUno, navigate to Spaces and select a space.

  2. In the sidebar, select Vaults.
  3. On the Vaults page, click the name of a vault. The Details page opens. The vault's URL is displayed on the right.
  4. To copy the URL to your clipboard, click Copy .

    You can then paste the link into your IDE or build scripts.

Back to top

See also: