Skip to content

Update Humanitec integration docs to contain newly supported resources #2502

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 22 commits into from
Aug 5, 2025
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
b8629d5
Enhance Humanitec integration documentation by adding new templates f…
lordsarcastic Jul 2, 2025
7dee5c9
Update Humanitec integration documentation to include additional enti…
lordsarcastic Jul 2, 2025
c7caa0d
Merge branch 'main' into digcs-43
lordsarcastic Jul 2, 2025
8ebad67
Merge branch 'main' into digcs-43
lordsarcastic Jul 3, 2025
76c3589
Update humanitec-integration.md
kodjomiles Jul 3, 2025
a22b10c
Enhance Humanitec integration guide with detailed prerequisites, comm…
lordsarcastic Jul 8, 2025
f6334fe
Chore: Spaced instructions
lordsarcastic Jul 8, 2025
7e66ce9
Merge branch 'main' into digcs-43
lordsarcastic Jul 8, 2025
a17ba11
Merge branch 'main' into digcs-43
lordsarcastic Jul 8, 2025
79f8bf9
Refine Humanitec integration guide by updating the introduction for c…
lordsarcastic Jul 21, 2025
a639dd9
Merge remote-tracking branch 'origin/main' into digcs-43
lordsarcastic Jul 21, 2025
29e0c82
Merge branch 'main' into digcs-43
lordsarcastic Jul 22, 2025
72e734f
Merge branch 'main' into digcs-43
lordsarcastic Jul 22, 2025
041e658
Merge branch 'main' into digcs-43
lordsarcastic Jul 29, 2025
b026830
Fix: Indentation and period at the end of points
lordsarcastic Jul 29, 2025
7416c98
Merge branch 'main' into digcs-43
lordsarcastic Jul 29, 2025
27c5856
Merge branch 'main' into digcs-43
kodjomiles Aug 1, 2025
374dbca
Fix indentation so it falls under the right point
lordsarcastic Aug 1, 2025
b447f7c
Merge branch 'digcs-43' of github.com:port-labs/port-docs into digcs-43
lordsarcastic Aug 1, 2025
c2845f0
Merge branch 'main' into digcs-43
hadar-co Aug 5, 2025
f630ec9
Update docs/guides/all/humanitec-integration.md
kodjomiles Aug 5, 2025
0601b2b
Update docs/guides/all/humanitec-integration.md
kodjomiles Aug 5, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 29 additions & 3 deletions docs/guides/all/humanitec-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,21 @@ import HumanitecExporterMainScript from "/docs/guides/templates/humanitec/_human
import HumanitecExporterRequirements from "/docs/guides/templates/humanitec/_humanitec_exporter_requirements.mdx";
import HumanitecExporterPortClient from "/docs/guides/templates/humanitec/_humanitec_exporter_port_client.mdx";
import HumanitecExporterHumanitecClient from "/docs/guides/templates/humanitec/_humanitec_exporter_humanitec_client.mdx";
import HumanitecGroups from "/docs/guides/templates/humanitec/_humanitec_groups.mdx";
import HumanitecUsers from "/docs/guides/templates/humanitec/_humanitec_users.mdx";
import HumanitecPipelines from "/docs/guides/templates/humanitec/_humanitec_pipelines.mdx";
import HumanitecDeploymentDeltas from "/docs/guides/templates/humanitec/_humanitec_deployment_deltas.mdx";
import HumanitecDeploymentSets from "/docs/guides/templates/humanitec/_humanitec_deployment_sets.mdx";
import HumanitecSecretStores from "/docs/guides/templates/humanitec/_humanitec_secret_stores.mdx";
import HumanitecValueSetVersions from "/docs/guides/templates/humanitec/_humanitec_value_set_versions.mdx";
import HumanitecSharedValues from "/docs/guides/templates/humanitec/_humanitec_shared_values.mdx";


# Humanitec Integration

## Overview

In this example, you are going to create a github worklow integration to facilitate the ingestion of Humanitec applications, environments, workloads, resources and resource graphs into your port catalog on schedule
In this example, you are going to create a github worklow integration to facilitate the ingestion of Humanitec applications, environments, workloads, resources, resource graphs, pipelines, deployment deltas, deployment sets, secret stores, shared values, value set versions, users, groups into your port catalog on schedule

:::info Prerequisites

Expand All @@ -45,6 +54,23 @@ Create the following blueprint definitions in port:

<HumanitecResourceBlueprint/>

<HumanitecSecretStores/>

<HumanitecSharedValues/>

<HumanitecValueSetVersions/>

<HumanitecDeploymentSets/>

<HumanitecPipelines/>

<HumanitecDeploymentDeltas/>

<HumanitecUsers/>

<HumanitecGroups/>


:::tip Blueprint Properties
You may select the blueprints depending on what you want to track in your Humanitec account.
:::
Expand All @@ -54,7 +80,7 @@ You may select the blueprints depending on what you want to track in your Humani
:::tip
Fork our [humanitec integration repository](https://github.com/port-labs/humanitec-integration-script.git) to get started.
:::
1. Create the following Python files in a folder name `integration` folder at the root of your GitHub repository:
1. Create the following Python files in a folder named `integration` at the base directory of your GitHub repository:
1. `main.py` - Orchestrates the synchronization of data from Humanitec to Port, ensuring that resource entities are accurately mirrored and updated on your port catalog.
2. `requirements.txt` - This file contains the dependencies or necessary external packages need to run the integration

Expand Down Expand Up @@ -146,5 +172,5 @@ jobs:
</details>


Done! Any change that happens to your application, environment, workloads or resources in Humanitec will be synced to Port on the schedule interval defined in the GitHub workflow.
Done! Any change that happens to your application, environment, workloads, resources, resource graphs, pipelines, deployment deltas, deployment sets, secret stores, shared values, value set versions, users, groups in Humanitec will be synced to Port on the schedule interval defined in the GitHub workflow.

59 changes: 59 additions & 0 deletions docs/guides/templates/humanitec/_humanitec_deployment_deltas.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<details>
<summary>Humanitec Deployment Deltas</summary>

```json showLineNumbers
{
"identifier": "humanitecDeploymentDelta",
"title": "Humanitec Deployment Delta",
"icon": "Deployment",
"schema": {
"properties": {
"status": {
"title": "Status",
"description": "The status of the deployment delta",
"type": "string",
"icon": "DefaultProperty"
},
"createdAt": {
"title": "Created At",
"description": "The date and time when the deployment delta was created",
"type": "string",
"format": "date-time",
"icon": "DefaultProperty"
},
"createdBy": {
"title": "Created By",
"description": "The user who created the deployment delta",
"type": "string",
"icon": "DefaultProperty"
},
"comment": {
"title": "Comment",
"description": "Comment for the deployment delta",
"type": "string",
"icon": "DefaultProperty"
},
"environment": {
"title": "Environment",
"description": "The environment for the deployment delta",
"type": "string",
"icon": "DefaultProperty"
}
},
"required": []
},
"mirrorProperties": {},
"calculationProperties": {},
"aggregationProperties": {},
"relations": {
"humanitecApplication": {
"title": "Application",
"target": "humanitecApplication",
"required": false,
"many": false
}
}
}
```

</details>
53 changes: 53 additions & 0 deletions docs/guides/templates/humanitec/_humanitec_deployment_sets.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
<details>
<summary>Humanitec Deployment Sets</summary>

```json showLineNumbers
{
"identifier": "humanitecDeploymentSet",
"title": "Humanitec Deployment Set",
"icon": "Deployment",
"schema": {
"properties": {
"version": {
"title": "Version",
"description": "The version of the deployment set",
"type": "string",
"icon": "DefaultProperty"
},
"createdAt": {
"title": "Created At",
"description": "The date and time when the deployment set was created",
"type": "string",
"format": "date-time",
"icon": "DefaultProperty"
},
"createdBy": {
"title": "Created By",
"description": "The user who created the deployment set",
"type": "string",
"icon": "DefaultProperty"
},
"comment": {
"title": "Comment",
"description": "Comment for the deployment set",
"type": "string",
"icon": "DefaultProperty"
}
},
"required": []
},
"mirrorProperties": {},
"calculationProperties": {},
"aggregationProperties": {},
"relations": {
"humanitecApplication": {
"title": "Application",
"target": "humanitecApplication",
"required": false,
"many": false
}
}
}
```

</details>
Loading