UPack Overview
  • 18 May 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

UPack Overview

  • Dark
    Light
  • PDF

What is UPack

UPack is a technology-neutral packaging platform that allows you to uniformly distribute your applications and components across environments to enable consistent deployment and testing.

Package

Package your applications and components directly from the Visual Studio Extension or the Jenkins Plug-in, or using free and open-source tools including the Universal Package Explorer or the cross-platform UPack Command-line Interface.

Extend

Include any metadata, such as git branch name or commit-id, or customer-specific package information; or even extend the package format itself for delivering content and features within your own applications and services using UPackLib.NET or the API.

Distribute

Distribute your packages securely, to any number of clients and endpoints using ProGet’s universal feeds, or simply store them on disk or a network share. Use virtual packages to mix-and-match other packages and external content to simplify and standardize distribution.

Deploy

Deploy your packages to servers and the cloud with BuildMaster, or use the UPack Command-line Interface to install them on workstation or server. Alternatively, use the UPackLib.NET library or open specifications to deploy, install, or configure packages as your application demands.

Discover

Discover which packages have been installed on a machine with upack or UPackLib.NET to see where the package came from, which tool installed it, and which user triggered the deployment. Universal Packages also have a built-in audit history that lets you track changes or repackaging back to the source.

Versioning

Universal Package Feeds were designed to be provide immediate, out-of-the-box functionality for most packaging needs, and also to serve as a platform that you can easily extend or interact with.

Universal Feed API Versions

VersionNotes
1.5.0Added version ranges to dependencies in package manifest
1.4.0Added shortDescription to package manifest
1.3.0Added Feed Metadata Endpoint
Added Download VPack Endpoint
1.2.0Added Virtual Packages
Added tags to packages
Added Repackaging
Added package hash to package identification string (dependencies, package history)
1.1.1Increased group length from 50 to 250
1.1.0Added Download Package File Endpoint
1.0.0Introduction

Universal Package Versions

The Universal Package Files themselves are designed to be both backwards- and forwards-compatible. This is easily accomplished because the minimum requirements for what makes a universal package are incredibly minimal. Thus, changes will always be additive and their usage will be optional.

In the extremely unlikely event that a future version of this specification is not compatible (we can think of absolutely no reason this would ever be), these would likely be exposed as a totally different format (like a .upack2 extension).

UPack Specifications:

All of the UPack tools adhere to the following set of specifications. The specifications were designed to be easy to understand and implement for your own use cases.

Universal Package

A ZIP archive containing any sort of content, along with a simple, JSON-formatted manifest file describing that content using built-in or additional metadata.

Virtual Package

A JSON-formatted file that behaves like a universal package, but with contents that are downloaded and assembled at install time.

Universal Package Registry

A JSON-formatted file that describes what packages are installed in a particular context (on a server, in an application), as well as when it was installed, who installed it, and why it was installed. It also provides for a package cache, in case packages need to be reinstalled or audited.

Universal Feed

An HTTP-based API used to list, download, and publish universal package files to a web-based package manager like ProGet.


Was this article helpful?