Humanitec Documentation
WebsiteStatusLogin inGet started
Search…
Introduction
Welcome
How does Humanitec integrate?
What happens if you hit "Deploy"?
Getting Started
Technical Requirements
Create Sample App
Connect own Infrastructure
Work with Sample App
Migrate own App
Guides
Connect CI Setup
Orchestrate Infrastructure
Resource Definitions
Manage Kubernetes Clusters
Manage DNS
Manage Relational Databases
Aiven
Amazon RDS
Azure Database
Google Cloud SQL
Manage Blob Storage
Manage persistent Volumes
Define and Manage Environment Types
Manage Application Configuration
Manage Users & Permissions
Using Humanitec
Work with Apps
Work with Environments
Work with Workloads
Integrations
Resource Types
Resource Drivers
Create own Resource Driver
Reference
Concepts
Placeholders
User Interface (UI)
Command Line Interface (CLI)
Workload Profiles
Platform API
Troubleshooting
Support Channels
Powered By GitBook
Aiven
Learn how to provision databases in instances running in Aiven

Overview

Aiven provides modern, fully-managed open source data infrastructure which is immediately deployable in public clouds, including Amazon Web Services, Google Cloud Platform, and Microsoft Azure. Aiven is a particularly good provider for teams with multi-cloud needs: for example running development environments on AWS and production systems on Azure.
Aiven supports the postgres and mysql resource types.

Adding your Aiven Account

You can add your Aiven Account in the Organization Settings.
UI
CLI
API
  1. 1.
    Click on the Accounts tab.
  2. 2.
    Select Aiven.
  3. 3.
    You will be asked to provide an Account Name (a memorable name that will be displayed for this account).
  4. 4.
    Enter your Aiven Authentication Token.
  5. 5.
    Click on Authorize.
Steps 1 & 2 of adding your Aiven account
Steps 3-5 of adding your Aiven 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.

Creating a resource definition for an Aiven managed instance

You can easily connect Humanitec to an Aiven managed database instance. The following paragraph explains how.
UI
CLI
API
  1. 1.
    Start on the Resources Management screen.
  2. 2.
    Select Show all resources.
  3. 3.
    Below Data storages click on the type of database you want to create. This will open a dialog.
  4. 4.
    Choose an ID that you will use to identify the resource definition in Humanitec later.
  5. 5.
    Select a Driver, here - postgres. 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.
  6. 6.
    Below Credentials make sure your Aiven account is selected.
  7. 7.
    Fill out the connection parameters that Humanitec will use to create/delete databases in the instance. You can find them in the Services section of the Aiven Console.
  8. 8.
    Click on Create.
Steps 1 - 2 of creating a resource definition for an Aiven managed instance
Steps 3 - 7 of creating a resource definition for an Aiven managed instance
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 database. This enables you to define specific environments or applications to be deployed to this resource.
UI
CLI
API
By clicking on your database in the list of resources, the Matching row will expand and allow you to add or remove matching criteria. Each database resource 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 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.
Previous
Manage Relational Databases
Next
Amazon RDS
Last modified 2mo ago
Copy link
Contents
Overview
Adding your Aiven Account
Creating a resource definition for an Aiven managed instance
Define Matching