An integration used to import Humanitec resources into Port, providing comprehensive visibility into your Humanitec applications, environments, resources, secrets, deployments, and pipelines.
This integration syncs the following Humanitec entities to Port:
- Applications - Humanitec applications
- Environments - Application environments (dev, staging, prod, etc.)
- Workloads - Application workloads and modules
- Resources - Active resources provisioned in environments
- Resource Graphs - Dependency graphs between resources
- Secret Stores - Organization-level secret stores
- Shared Values - Application and environment-level configuration/secrets
- Value Set Versions - Versioned sets of shared values
- Deployment Sets - Deployment configurations
- Pipelines - CI/CD pipeline definitions
- Deployment Deltas - Deployment change definitions
- Users - Organization users and their roles
- Groups - User groups and permissions
- Python 3.10 or higher
- Humanitec API access with appropriate permissions
- Port API access with client credentials
- Clone this repository:
git clone <repository-url>
cd humanitec-integration-script
- Install dependencies:
pip install -r requirements.txt
Create a .env
file in the root directory with the following variables:
# Humanitec Configuration
ORG_ID=your-humanitec-org-id
API_KEY=your-humanitec-api-key
API_URL=https://api.humanitec.com
# Port Configuration
PORT_CLIENT_ID=your-port-client-id
PORT_CLIENT_SECRET=your-port-client-secret
Variable | Description | Required | Default |
---|---|---|---|
ORG_ID |
Your Humanitec organization ID | Yes | - |
API_KEY |
Your Humanitec API key/token | Yes | - |
API_URL |
Humanitec API base URL | No | https://api.humanitec.com |
PORT_CLIENT_ID |
Port client ID | Yes | - |
PORT_CLIENT_SECRET |
Port client secret | Yes | - |
cd integration
python main.py
cd integration
python main.py \
--org-id your-humanitec-org-id \
--api-key your-humanitec-api-key \
--port-client-id your-port-client-id \
--port-client-secret your-port-client-secret
The integration can be run via GitHub Actions workflow. See the GitHub Workflow documentation for setup instructions.
Option | Description | Required | Default |
---|---|---|---|
--org-id |
Humanitec organization ID | No* | From .env |
--api-key |
Humanitec API key | No* | From .env |
--api-url |
Humanitec API URL | No | https://api.humanitec.com |
--port-client-id |
Port client ID | No* | From .env |
--port-client-secret |
Port client secret | No* | From .env |
Required if not provided via environment variables or GitHub Actions secrets
- Integration Documentation: Port Integration Guide
- Development Guide: Ocean Integration Development
- Humanitec API Docs: Humanitec API Documentation
This integration is provided as-is for use with Port and Humanitec platforms.