Manage Blob Storage

Learn how to connect and manage other resources in Humanitec.

Introduction

Humanitec is designed to easily integrate with managed file storage (e.g., Amazon S3, Google Cloud Storage). Most required Drivers are still experimental and currently thoroughly tested by our team before being released as out-of-the-box integrations. Please contact us to get access to these experimental Drivers.

The following sections provide an overview of the integrations that are available out-of-the-box in Humanitec.

If you cannot find the file storage you need in the list below or if you happen to have special requirements, reach out to us and we are happy to support you. Alternatively, you can create your own Resource Driver.

Amazon S3

With Humanitec, you can use your existing S3 bucket or dynamically create a new one.

Add Dynamic Resource Definition

To provision S3 dynamically, add it as a Dynamic Resource Definition. The bucket will be provisioned during the deployment time and destroyed when its introductory Environment is deleted.

Add AWS Account

You can add your AWS Account in the Organization Settings.

  • Click on the Dynamic resources tab.

  • Select Amazon Web Services.

Add AWS account
  • Humanitec will ask you to provide an account name (a memorable name that will be displayed for this account), an access key ID, and a secret access key (see how to create AWS access key under IAM user).

  • Once you have added your account you will see the available Dynamic Resource Definitions.

AWS account added

Add Dynamic Resource Definition

  • In Organization Settings, Dynamic Resource tab, click on your AWS account that you want to use for adding your S3 Bucket.

  • Click on the S3 Bucket resource definition.

  • Add a memorable ID for this Resource Definition and select a driver, here - aws.

  • Based on your resource driver, a form will be shown with the required driver parameters which will be passed to the driver on every resource creation. In this use case, the region is a mandatory driver value and it must match the region that your AWS account has access to. Add the values and click create.

Add S3 bucket as dynamic resource
  • Once created, the Resource Definition will appear in the list.

Dynamic S3 bucket added
  • Assign your Resource Definition to an Environment Type.

Assign dynamic S3 bucket to environment type

Based on this Resource Definition, during the deployment on any of the matching environments, an Active Resource will be provisioned if required.

Add Static Resource Definition

Prerequisites

To integrate an existing S3 Bucket statically with Humanitec, add it as a Static Resource Definition. You need to be an owner of the S3 Bucket that you want to connect with or be granted the permissions for this Bucket (learn more).

Steps

  • In the Organization Settings page, click Static Resources.

  • Click S3 Bucket, which opens a dialog to define your S3 Bucket as a static resource.

  • Define an ID by which you will identify your resource definition

  • Add S3 Bucket name and Region.

  • Provide Access key ID and Secret access key to allow Humanitec access the Bucket (see how to create AWS access key under IAM user).

  • Click Create and it will appear in the list.

  • Assign your Static Resource Definition to an Environment Type.

Static S3 bucket added

Based on this Static Resource Definition, during the deployment on any of the matching environments, the data required for the application to access the resource will be returned.