How Humanitec integrates

Learn where and how Humanitec integrates with your tools and infrastructure.

Introduction

Humanitec is the fastest way of building your Internal Developer Platform. Integrating existing tools, processes, and infrastructure easily with Humanitec is a very important aspect. This section provides an overview of where and how Humanitec integrates with the tools and infrastructure you already have in place.

Check out Infrastructure Orchestration for more details. Also, make sure you understood the Compatibility Requirements (there aren't too many).

Major Integration Points

There are three major integration points for Humanitec.

  1. Your existing CI pipelines to get container images or at least a notification that a new container image has been build into your Internal Developer Platform.

  2. Any resource that is needed for running your applications. For example:

    • Any Kubernetes cluster (managed or on-prem)

    • Any database or file storage (managed or on-prem)

    • Monitoring systems

    • Image registries (if not using Humanitec's build-in image registry)

  3. Other tools integrated if applicable. For example:

    • IaaC tooling and setup

    • GitOps tooling and processes

The following picture provides a conceptual overview of where Humanitec integrates.

https://docs.google.com/drawings/d/1VCykz-0Qva9VZcAvo8BuSrgEkURfgxcDqrmoyEZqLTs/edit

Humanitec strictly integrates through Application Programming Interfaces (APIs). This enables you to control permissions (typically via service accounts) and to revoke access at any point in time.

Humanitec does not lock you in. You can export the manifests for each deployment and use them in other processes as needed.

Orchestrate Infrastructure

Humanitec provides two different ways to manage resources, a static and a dynamic approach.

  • A good example of a static resource is a production database used by your application. Your DevOps team can configure Humanitec to always use the same static database for your production environment.

  • A good example of a dynamic resource are your development databases. Ideally, you want to create a new database in your database server whenever a new environment is created and remove it automatically when the respective environment is deleted. Humanitec supports this out of the box.

All resource integrations can be managed by the DevOps team and can be assigned to environment types (such as development, QA, and production). Head over to this section to learn more about all the details.

Integrations per Type

The following table provides a rough overview of the different types of systems you can integrate with Humanitec as well as some examples.

Type

Description

Examples

CI Pipelines

Inform your Internal Developer Platform whenever a new build is available and trigger automation rules.

  • Github

  • Bitbucket

  • Gitlab

  • CircleCI

  • Codefresh

  • Jenkins

Image Registries

Use Humanitec's out-of-the-box image registry to securely store all of your organization's container images or connect your (existing) image registry with Humanitec.

  • JFrog Container Registry

  • Harbor

  • Elastic Container Registry

Kubernetes Clusters

Connect your (existing) Kubernetes clusters to Humanitec and manage all deployments through Humanitec. Humanitec integrates via the cluster API and a service account. Humanitec deploys each new environment into a separate namespace.

  • GKE

  • EKS

  • AKS

  • OpenShift

Databases & File Storage

Connect your (existing) static databases/file storage for specific environments. Leverage the power of managed databases/file storage and Humanitec's dynamic resource management to fully manage the entire resource lifecycle for your development environments.

  • Google CloudSQL

  • Amazon RDS

  • Aiven

  • MariaDB

  • Amazon S3

DNS

Connect your (existing) DNS setup for specific environments. Leverage the power of Humanitec's dynamic DNS to provision individual URLs for all your development environments.

  • Route 53

  • Cloudflare

IaC Setups

Trigger your (existing) IaC scripts whenever Humanitec dynamically creates a new environment.

  • Terraform

  • Pulumi

Monitoring & Chaos Engineering Tools

Use sidecar containers to integrate all your workloads with monitoring, chaos engineering tools, or the custom reporting tool you developed inhouse for years.

  • Datadog

  • Grafana

  • Instana

  • Gremlin

GitOps Tools

Connect with GitOps tools using the exported manifests for each deployment run through Humanitec.

  • ArgoCD

  • Flux

  • Weaveworks