ProGet Documentation

Cloud Package Stores

  • Last Modified: 2018-01-10

This feature is available in paid and trial ProGet editions.

ProGet defaults to storing package files on disk, but you can configure a feed to store packages on the cloud (Amazon S3 or Microsoft Azure Blob) instead. This offers two key benefits:

Scale when you need with cloud package stores; this takes the guess work out of your future storage needs. By storing packages on the cloud, you no longer have to worry about maintaining, installing, or provisioning additional storage capacity.

Disaster recovery is made simple; both Amazon S3 and Azure Blob storage offer redundancy, meaning that you don't have to worry about complex, disaster recovery plans for large amounts of package files because your files are automatically saved to the cloud.

Cloud storage is generally slower, as it's much faster to read/write files from local disk than it is over an internet connection. However, the speed difference may not be noticed in day-to-day use.

Configuring a Feed to Use Cloud Storage

By default, ProGet stores packages on disk using a disk-based package store.

You can change a feed's package store by going to the Manage Feed page, and clicking change next to the Package Store heading. This will open a dialog that allows you to select between Amazon S3 and Microsoft Azure.

If you don't see Amazon S3 or Microsoft Azure as an option, then validate that those extensions are installed by going to Administration > Extensions

After selecting the package store type, you will be presented with a handful of required configuration options.

Amazon S3 Options

Access Key & Secret Access Key This is the equivalent of a username and password for Amazon Web Services; you can create one with the Amazon IAM console
Bucket Name The name of the storage bucket configured on S3 that will be used as a packages store
Target Path The path within the specified bucket; the default is "/"
Reduce Redundancy When set, ProGet will request files to be written using a Reduced Redundancy storage class (instead of Standard), which this tends to have a lower storage fee; see S3 documentation to learn more about this
Make Public When set, the files uploaded will be given public permission to view; this is generally not recommended
Encrypted When set, ProGet will request server-side encryption is used for packages; this is generally not recommended
Region Endpoint The region endpoint (such as us-east-1) where the bucket is located

Azure Blob Options

Connection string A Microsoft Azure connection string, like DefaultEndpointsProtocol=https;AccountName=account-name;AccountKey=account-key
Container The name of the Azure Blob Container that will receive the uploaded files.
Target Path The path in the specified Azure Blob

Migrating an Existing Feed

When you change a feed's package store, the package files will not be moved. To ensure the new package store has the same packages, you can perform the following steps

  1. Clear the cached packages
  2. Stop the ProGet Service
  3. Note the disk path of the feed
  4. Change the package store and configure appropriately
  5. Set the Drop Path to be the disk path from step 3
  6. Start the service
  7. Once imported, delete the empty disk path from step 3

Have a question? Try the Q&A Forum

Our documentation is now Open Source and on GitHub. We highly encourage our users to contribute and get involved! .