Humanitec

Humanitec offers products to build on top of your Internal Developer Portal (IDP) for containerized workloads.

Integrating Humanitec with Cortex allows you to run a Humanitec pipeline directly from Cortex.

How to integrate Humanitec with Cortex

Prerequisites

Before getting started:

• You should have an app with a working pipeline configured in Humanitec.

• Create a service user in Humanitec, and create an API token in Humanitec for the service user.

Step 1: Create a Workflow in Cortex

1. Follow the instructions to begin creating a Workflow and configure its basic settings.

2. Add an HTTP request block to your Workflow. Configure the block:

   • Block name: Enter a descriptive name for the block.

   • Slug: Enter a unique identifier for the block.

   • HTTP method: Select POST.

   • URL: Enter a Humanitec API URL based on the Humanitec call createPipelineRun, e.g., https://api.humanitec.io/orgs/<your-Humanitec-org>/<your-app-ID>/pipelines/<pipeline-ID>/runs

3. At the bottom of the side panel, click Save.

4. Make any other necessary changes to your Workflow, then in the upper right corner of the page, click Save workflow.

Alternatively, you can also use an Async HTTP request block in your Workflow, using the Humanitec action actions/humanitec/http@v1 to call back to Cortex.

Step 2: Run the Workflow

• At the top of your Workflow in Cortex, click Run.

In your Humanitec workspace under your app's pipelines, you will see the run listed under the Runs tab: