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

You can easily connect Humanitec to an Amazon s3 bucket. The next paragraphs explain how.

Add your AWS Account

You can add your AWS Account in the Organization Settings.
UI
CLI
API
  1. 1.
    Click on the Accounts tab.
  2. 2.
    Select Amazon Web Services.
  3. 3.
    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).
  4. 4.
    Once the account was authorized, it will show up at the top of the accounts list.
Add AWS account
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Accounts can be added via the Create Resource Account endpoint.

Connect s3 bucket to Humanitec

You can easily connect Humanitec to an Aiven managed database instance. The following paragraph explains how.
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).
UI
CLI
API
  1. 1.
    Start on the Resources Management screen and click on the Show all resources button. An overlay with all available resource categories and types will be presented to you.
  2. 2.
    Below Data storages click on s3 bucket, which opens a dialog.
  3. 3.
    Choose an ID that you will use to identify the resource definition in Humanitec later.
  4. 4.
    Select a driver, here - s3. 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.
  5. 5.
    Below Credentials make sure your AWS account is selected.
  6. 6.
    After adding the values and clicking Create the s3 bucket will be successfully registered in Humanitec and show up at the top of the resource list.
Create s3 Bucket resource definition
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Resource definitions can be created via the Create Dynamic Resource endpoint.

Define Matching

Next, you can configure matching criteria for your s3 bucket resource. This enables you to define specific environments or applications to be deployed to this resource.
UI
CLI
API
By clicking on your s3 bucket in the list of resources, the Matching row will expand and allow you to add or remove matching criteria. Each s3 bucket can be matched to specific Environment Types, App IDs, Environment IDs or Resource IDs. Empty fields are automatically resolved to match all values of the given category.
Define Matching
Based on this Resource Definition, during the deployment on any of the matching applications or environments, an Active Resource will be provisioned if required.
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Matching criteria can be created via the Create new Matching Criteria endpoint.
Last modified 28d ago