Update Humanitec integration docs to contain newly supported resources #2502
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…or Deployment Deltas, Deployment Sets, Secret Stores, Shared Values, Users, Groups, and Pipelines. Update HumanitecExporter to support syncing these new entities and improve error handling in API calls. Refactor existing code for better clarity and maintainability.
…ties such as pipelines, deployment deltas, deployment sets, secret stores, shared values, value set versions, users, and groups for improved clarity on synchronization capabilities.
|
This pull request is automatically being deployed by Amplify Hosting (learn more). |
kodjomiles
requested changes
Jul 3, 2025
There was a problem hiding this comment.
Some of the comments apply to other places and should replicated as same like the headings, the click to drops, the numbered list in a numbered list.
also for the sidebar we can have something like
Overview Set up data model Implementation Add GitHub secrets Add python scripts Add GitHub workflow
docs/guides/templates/humanitec/_humanitec_deployment_deltas.mdx
Outdated
Show resolved
Hide resolved
…on use cases, and updated workflow setup instructions. Added new images and improved section headers for clarity. Updated summary for blueprint templates to include "Click to expand" for better user experience.
hadar-co
requested changes
Jul 9, 2025
|
|
||
| # Humanitec Integration | ||
|
|
||
| ## Overview | ||
| In this guide, 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. |
There was a problem hiding this comment.
Suggested change
| In this guide, 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. | |
| This guide demonstrates how 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. | |
|
|
||
| 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 | ||
| <img src="/img/guides/humanitecEnvironment.png" alt="Humanitec Integration" width="75%" border="1px" /> |
There was a problem hiding this comment.
the image doesnt appear, looks like a small typo
| :::tip Blueprint Properties | ||
| You may select the blueprints depending on what you want to track in your Humanitec account. | ||
| ::: | ||
|
|
||
| ## GitHub Workflow | ||
| ## Set up the integration | ||
|
|
||
| :::tip |
There was a problem hiding this comment.
this is quite strange as a callout. What would you like the user to do here? perhaps make this a regular step and clarify
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Enhance Humanitec integration documentation by adding new templates for Deployment Deltas, Deployment Sets, Secret Stores, Shared Values, Users, Groups, and Pipelines. Update HumanitecExporter to support syncing these new entities.
Updated docs pages
Please also include the path for the updated docs
docs/guides/all/humanitec-integration)