# Port Documentation > Port is an internal developer portal (IDP) platform that gives engineering teams a software catalog, self-service actions, automations, scorecards, and 100+ integrations connected to their existing tools. API base URLs: EU https://api.port.io, US https://api.us.port.io. - [Port Documentation](/index.md) ## getting-started ### connect-tools Connect Git providers and other tools to Port during onboarding. Install integrations to start populating your software catalog automatically. - [Connect your tools](/getting-started/connect-tools.md): Connect Git providers and other tools to Port during onboarding. Install integrations to start populating your software catalog automatically. ### default-components Reference for default Port blueprints including service, workload, environment, user, and team. Describes each blueprint's purpose and properties. - [Default blueprints](/getting-started/default-components.md): Reference for default Port blueprints including service, workload, environment, user, and team. Describes each blueprint's purpose and properties. ### end-user-onboarding Quick start guide for developers and end-users. Learn to navigate the portal, use self-service actions, and find information about services. - [End-user onboarding](/getting-started/end-user-onboarding.md): Quick start guide for developers and end-users. Learn to navigate the portal, use self-service actions, and find information about services. ### onboarding-workshop Self-paced GitHub workshop for platform engineers covering portal configuration, from basic navigation to advanced infrastructure-as-code management. - [Onboarding workshop](/getting-started/onboarding-workshop.md): Self-paced GitHub workshop for platform engineers covering portal configuration, from basic navigation to advanced infrastructure-as-code management. ### overview Start here to connect your first tool, build your service catalog, and set up automatic data discovery in Port. Takes about 30 minutes. - [Getting started](/getting-started/overview.md): Start here to connect your first tool, build your service catalog, and set up automatic data discovery in Port. Takes about 30 minutes. ### set-up-automatic-discovery Automate entity creation with GitOps, scorecards, and auto-discovery. Configure mapping rules to keep your catalog in sync with your tools. - [Set up automatic data mapping](/getting-started/set-up-automatic-discovery.md): Automate entity creation with GitOps, scorecards, and auto-discovery. Configure mapping rules to keep your catalog in sync with your tools. ### set-up-service-catalog Create your service catalog using default blueprints for services, workloads, and environments. Add users and teams to establish ownership. - [Set up your service catalog](/getting-started/set-up-service-catalog.md): Create your service catalog using default blueprints for services, workloads, and environments. Add users and teams to establish ownership. ## build-your-software-catalog ### catalog-auto-discovery Learn how to use AI-powered auto discovery to identify and create missing entities in your catalog based on related data from multiple sources. - [Catalog auto discovery](/build-your-software-catalog/catalog-auto-discovery.md): Learn how to use AI-powered auto discovery to identify and create missing entities in your catalog based on related data from multiple sources. ### custom-integration Learn how to create custom integrations to ingest data from any tool or platform into Port using webhooks, API, or IaC methods. - [Create a custom integration](/build-your-software-catalog/custom-integration.md): Learn how to create custom integrations to ingest data from any tool or platform into Port using webhooks, API, or IaC methods. #### api Learn how to use Port's REST API to model your software catalog, ingest data, invoke actions, and interact with Port programmatically. - [API](/build-your-software-catalog/custom-integration/api.md): Learn how to use Port's REST API to model your software catalog, ingest data, invoke actions, and interact with Port programmatically. ##### advanced Advanced API query parameters including delete_dependents for cascading deletes and create_missing_related_entities for automatic entity creation. - [Advanced](/build-your-software-catalog/custom-integration/api/advanced.md): Advanced API query parameters including delete_dependents for cascading deletes and create_missing_related_entities for automatic entity creation. ##### ci-cd Overview of CI/CD integrations for keeping your software catalog up to date with build versions, job statuses, and other CI/CD data. - [CI/CD](/build-your-software-catalog/custom-integration/api/ci-cd.md): Overview of CI/CD integrations for keeping your software catalog up to date with build versions, job statuses, and other CI/CD data. - [Azure Pipelines](/build-your-software-catalog/custom-integration/api/ci-cd/azure-pipelines.md): Learn how to create, update, and query Port entities directly from Azure Pipelines using Port's API. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/azure-pipelines/examples.md): Examples of creating and updating Port entities from Azure Pipelines, including CI job tracking and Docker image reporting. - [CircleCI workflows](/build-your-software-catalog/custom-integration/api/ci-cd/circleci-workflow.md): Learn how to create, update, and query Port entities directly from CircleCI workflows using Port's API. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/circleci-workflow/examples.md): Examples of creating and updating Port entities from CircleCI workflows, including CI job tracking and Docker image reporting. - [Codefresh Workflow Template](/build-your-software-catalog/custom-integration/api/ci-cd/codefresh-workflow-template.md): Learn how to use Port's Codefresh workflow template to create, update, and query entities directly from Codefresh pipelines. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/codefresh-workflow-template/examples.md): Basic create/update example - [GitHub Workflow](/build-your-software-catalog/custom-integration/api/ci-cd/github-workflow.md): Learn how to use Port's GitHub action to create, update, and query entities directly from GitHub workflows. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/github-workflow/examples.md): Examples of using Port's GitHub action to create entities, import dependencies, and report CI job status from GitHub workflows. - [Gitlab CI Pipelines](/build-your-software-catalog/custom-integration/api/ci-cd/gitlab-pipelines.md): Learn how to create, update, and query Port entities directly from GitLab CI pipeline jobs using Port's API. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/gitlab-pipelines/examples.md): Examples of creating and updating Port entities from GitLab CI pipelines, including CI job tracking and Docker image reporting. - [Jenkins Deployment](/build-your-software-catalog/custom-integration/api/ci-cd/jenkins-deployment.md): Learn how to create, update, and query Port entities directly from Jenkins pipelines using Port's API. - [Examples](/build-your-software-catalog/custom-integration/api/ci-cd/jenkins-deployment/examples.md): Examples of creating and updating Port entities from Jenkins pipelines, including CI job tracking and Docker image reporting. #### gitops Overview of GitOps integration options for managing Port entities using your Git repositories as the source of truth. - [Integrate assets using GitOps](/build-your-software-catalog/custom-integration/gitops.md): Overview of GitOps integration options for managing Port entities using your Git repositories as the source of truth. #### iac Overview of Infrastructure-as-Code methods for ingesting data and defining your software catalog alongside IaC configurations using Terraform or Pulumi. - [IaC](/build-your-software-catalog/custom-integration/iac.md): Overview of Infrastructure-as-Code methods for ingesting data and defining your software catalog alongside IaC configurations using Terraform or Pulumi. ##### pulumi Learn how to use Port's Pulumi provider to manage blueprints and entities as infrastructure-as-code in Python, TypeScript, JavaScript, or Go. - [Pulumi](/build-your-software-catalog/custom-integration/iac/pulumi.md): Learn how to use Port's Pulumi provider to manage blueprints and entities as infrastructure-as-code in Python, TypeScript, JavaScript, or Go. ##### terraform Learn how to use Port's Terraform provider to manage blueprints, entities, and other Port resources as infrastructure-as-code. - [Terraform](/build-your-software-catalog/custom-integration/iac/terraform.md): Learn how to use Port's Terraform provider to manage blueprints, entities, and other Port resources as infrastructure-as-code. #### ocean-custom-integration ##### configuration Prerequisites, resource mapping, and advanced configuration for the Ocean custom integration - [Configuration](/build-your-software-catalog/custom-integration/ocean-custom-integration/configuration.md): Prerequisites, resource mapping, and advanced configuration for the Ocean custom integration ##### installation-types - [Hosted by Port](/build-your-software-catalog/custom-integration/ocean-custom-integration/installation-types/hosted-by-port.md): Install the Ocean custom integration hosted by Port - [Build your integration](/build-your-software-catalog/custom-integration/ocean-custom-integration/installation-types/self-hosted/build-your-integration.md): Interactive guide to configure and install your integration - [Custom authentication](/build-your-software-catalog/custom-integration/ocean-custom-integration/installation-types/self-hosted/custom-authentication.md): Configure OAuth2, JWT, and other dynamic token-based authentication flows - [Setup](/build-your-software-catalog/custom-integration/ocean-custom-integration/installation-types/self-hosted/setup.md): Install the Ocean custom integration in your own infrastructure ##### overview Understanding the Ocean custom integration - [Overview](/build-your-software-catalog/custom-integration/ocean-custom-integration/overview.md): Understanding the Ocean custom integration #### S3-integrations Learn how to ingest data from external sources into Port using Airbyte or Fivetran with S3 as an intermediate storage layer. - [S3 Bucket](/build-your-software-catalog/custom-integration/S3-integrations.md): Learn how to ingest data from external sources into Port using Airbyte or Fivetran with S3 as an intermediate storage layer. #### webhook Learn how to use Port's generic webhook integration to ingest data from any service that provides outgoing webhooks into your software catalog. - [Webhook](/build-your-software-catalog/custom-integration/webhook.md): Learn how to use Port's generic webhook integration to ingest data from any service that provides outgoing webhooks into your software catalog. ##### examples Examples of using Port's webhook integration to ingest resources from various tools like Jira, OpsGenie, SonarQube, and Sentry. - [Examples](/build-your-software-catalog/custom-integration/webhook/examples.md): Examples of using Port's webhook integration to ingest resources from various tools like Jira, OpsGenie, SonarQube, and Sentry. - [Codecov](/build-your-software-catalog/custom-integration/webhook/examples/codecov.md): Ingest CodeCov coverage into your catalog - [Falco Sidekick](/build-your-software-catalog/custom-integration/webhook/examples/falco.md): Ingest Falco alerts into your catalog - [Grafana](/build-your-software-catalog/custom-integration/webhook/examples/grafana.md): Ingest Grafana alerts into your catalog - [JFrog](/build-your-software-catalog/custom-integration/webhook/examples/jfrog.md): Ingest JFrog artifacts, Docker tags and builds into your catalog - [Packages](/build-your-software-catalog/custom-integration/webhook/examples/packages.md): Examples of using Port's webhook integration to ingest software package data into your catalog. - [Golang](/build-your-software-catalog/custom-integration/webhook/examples/packages/go.md): Ingest Golang packages into your catalog - [Java](/build-your-software-catalog/custom-integration/webhook/examples/packages/java.md): Ingest Maven Dependencies into your catalog - [Python](/build-your-software-catalog/custom-integration/webhook/examples/packages/python.md): Ingest Python packages into your catalog - [SOAP API](/build-your-software-catalog/custom-integration/webhook/examples/packages/soap.md): Ingest SOAP API definitions into your catalog - [Terraform State](/build-your-software-catalog/custom-integration/webhook/examples/packages/terraform.md): Ingest Terraform resources into your catalog - [Prometheus](/build-your-software-catalog/custom-integration/webhook/examples/prometheus.md): Ingest Prometheus alerts into your catalog - [Split](/build-your-software-catalog/custom-integration/webhook/examples/split.md): Ingest Split IO Impressions into your catalog - [StackHawk](/build-your-software-catalog/custom-integration/webhook/examples/stackhawk.md): Ingest StackHawk application vulnerabilities into Port ### customize-integrations #### common jq use-cases Common JQ patterns for integration mappings, self-service action backends, and filters. - [Common jq use-cases](/build-your-software-catalog/customize-integrations/common jq use-cases.md): Common JQ patterns for integration mappings, self-service action backends, and filters. #### configure-data-model Learn how to configure your integration's data model using blueprints, properties, and relations to define how data is represented in Port. - [Configure your data model](/build-your-software-catalog/customize-integrations/configure-data-model.md): Learn how to configure your integration's data model using blueprints, properties, and relations to define how data is represented in Port. ##### Iac - [Pulumi-Managed Blueprint Example](/build-your-software-catalog/customize-integrations/configure-data-model/Iac/pulumi-managed-blueprint.md): Comprehensive blueprint with properties, relations and mirror properties - [Terraform-Managed Blueprint Example](/build-your-software-catalog/customize-integrations/configure-data-model/Iac/terraform-managed-blueprint.md): Comprehensive blueprint with properties, relations and mirror properties ##### migrate-data Learn how to migrate entity data between blueprints when evolving your software catalog structure, including property transformations and relation updates. - [Migrate Blueprint Data](/build-your-software-catalog/customize-integrations/configure-data-model/migrate-data.md): Learn how to migrate entity data between blueprints when evolving your software catalog structure, including property transformations and relation updates. ##### relate-blueprints Learn how to create relations between blueprints to define logical connections between assets in your software catalog. - [Relate Blueprints](/build-your-software-catalog/customize-integrations/configure-data-model/relate-blueprints.md): Learn how to create relations between blueprints to define logical connections between assets in your software catalog. ##### setup-blueprint Create and configure Port blueprints to define your data model. Set properties (string, number, boolean, URL, etc.), relations between blueprints, and validation rules. - [Set up blueprints](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint.md): Create and configure Port blueprints to define your data model. Set properties (string, number, boolean, URL, etc.), relations between blueprints, and validation rules. - [Properties](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties.md): Learn how to configure properties in Port blueprints, including creating, editing, and deleting properties from the builder page or software catalog. - [Aggregation Property](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/aggregation-property.md): Learn how to use aggregation properties to calculate metrics based on relations in your catalog, such as counting entities or averaging values. - [Array](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/array.md): Array is a data type used to save lists of data - [Boolean](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/boolean.md): Boolean is a primitive data type that has one of two possible values - true and false - [➕ Calculation Property](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/calculation-property.md): Calculation property allows you to construct new data from existing properties of an entity - [Examples](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/calculation-property/examples.md): Examples of calculation properties including math operations, string concatenation, conditional logic, and date formatting in Port blueprints. - [Datetime](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/datetime.md): Datetime is a data type used to reference a date and time - [Email](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/email.md): Email is a data type used to save Email addresses - [Embedded URL](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/embedded-url.md): Learn how to use embedded URL properties to display external webpages like dashboards, diagrams, and architecture views within entity pages. - [Authentication](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/embedded-url/authentication.md): Learn how to configure SSO authentication for embedded URL properties to display protected webpages within Port entity pages. - [Enum](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/enum.md): Enum is a data type used to define a named set of constant values. - [Labeled URL](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/labeled-url-object.md): Labeled URL is an object type used to store URLs with custom display labels - [Markdown](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/markdown.md): Learn how to use the Markdown property type to display formatted Markdown content within entity pages in Port. - [Meta-Properties](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/meta-properties.md): Reference for meta-properties that exist on every entity by default, including identifier, title, team, timestamps, and created/updated by fields. - [Mirror Property](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/mirror-property.md): Mirror Property allows you to map data from related entities to your entity - [Number](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/number.md): Number is a primitive data type used to save numeric data - [Object](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/object.md): Object is a data type used to save object definitions in JSON - [Proto](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/proto.md): Proto is a data type used to save proto definitions in Port - [String](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/string.md): Configure string properties on Port blueprints, including enum values, formats, and validation rules. String is a primitive data type used to save text data. - [Swagger UI](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/swagger.md): Learn how to use the Swagger UI property to display OpenAPI and AsyncAPI specification files within entity pages in Port. - [Team](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/team.md): Team is a data type used to reference teams that exist in Port - [Timer](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/timer.md): Timer is a data type used to define an expiration date/lifespan of a specific entity - [URL](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/url.md): URL is a data type used to save links to websites - [User](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/user.md): User is a data type used to reference users that exist in Port - [Yaml](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/yaml.md): Yaml is a data type used to save object definitions in YAML #### configure-mapping Configure Port integration mappings using JQ expressions to transform data from external tools into catalog entities. Define selectors, property mappings, and relations in YAML. - [Configure mapping](/build-your-software-catalog/customize-integrations/configure-mapping.md): Configure Port integration mappings using JQ expressions to transform data from external tools into catalog entities. Define selectors, property mappings, and relations in YAML. ### manage-port-across-environments Learn how to manage Port resources across multiple environments using IaC (Terraform) or Git-based resource definitions for consistent deployments. - [Manage Port across environments](/build-your-software-catalog/manage-port-across-environments.md): Learn how to manage Port resources across multiple environments using IaC (Terraform) or Git-based resource definitions for consistent deployments. ### overview Build your software catalog in Port by modeling resources with blueprints and entities, then ingesting data from your tools to populate and connect them. - [Overview](/build-your-software-catalog/overview.md): Build your software catalog in Port by modeling resources with blueprints and entities, then ingesting data from your tools to populate and connect them. ### set-catalog-rbac Learn how to configure role-based access control for your software catalog to control which users can view and modify entities and properties. - [Set catalog RBAC](/build-your-software-catalog/set-catalog-rbac.md): Learn how to configure role-based access control for your software catalog to control which users can view and modify entities and properties. #### examples Examples of catalog RBAC configurations including making entities immutable, property-level permissions, and team ownership-based access control. - [Examples](/build-your-software-catalog/set-catalog-rbac/examples.md): Examples of catalog RBAC configurations including making entities immutable, property-level permissions, and team ownership-based access control. ### sync-data-to-catalog Install and configure Port integrations to sync data from GitHub, GitLab, Kubernetes, AWS, Jira, PagerDuty, and 100+ other tools into your software catalog. Choose hosted or self-hosted deployment. - [Install an integration](/build-your-software-catalog/sync-data-to-catalog.md): Install and configure Port integrations to sync data from GitHub, GitLab, Kubernetes, AWS, Jira, PagerDuty, and 100+ other tools into your software catalog. Choose hosted or self-hosted deployment. #### ai-agents ##### claude Ingest Claude Code usage and analytics into Port to track AI coding tool adoption across your engineering organization. - [Claude AI](/build-your-software-catalog/sync-data-to-catalog/ai-agents/claude.md): Ingest Claude Code usage and analytics into Port to track AI coding tool adoption across your engineering organization. ##### cursor Learn how to ingest Cursor team and model usage into Port to track AI adoption and cost patterns across your engineering organization using the Ocean custom integration framework. - [Cursor](/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor.md): Learn how to ingest Cursor team and model usage into Port to track AI adoption and cost patterns across your engineering organization using the Ocean custom integration framework. ##### github-copilot Ingest GitHub Copilot usage and metrics into Port to track AI coding tool adoption across your engineering organization. - [GitHub Copilot](/build-your-software-catalog/sync-data-to-catalog/ai-agents/github-copilot.md): Ingest GitHub Copilot usage and metrics into Port to track AI coding tool adoption across your engineering organization. ##### n8n Learn how to ingest n8n users, projects, and workflows into Port using the Ocean custom integration framework. - [n8n](/build-your-software-catalog/sync-data-to-catalog/ai-agents/n8n.md): Learn how to ingest n8n users, projects, and workflows into Port using the Ocean custom integration framework. ##### openai Learn how to ingest OpenAI usage metrics, costs, and model information into Port using the Ocean custom integration framework. - [OpenAI](/build-your-software-catalog/sync-data-to-catalog/ai-agents/openai.md): Learn how to ingest OpenAI usage metrics, costs, and model information into Port using the Ocean custom integration framework. ##### zapier Learn how to ingest Zapier apps and zaps into Port using the Ocean custom integration framework. - [Zapier](/build-your-software-catalog/sync-data-to-catalog/ai-agents/zapier.md): Learn how to ingest Zapier apps and zaps into Port using the Ocean custom integration framework. #### apm-alerting Overview of APM and alerting integrations for syncing monitoring data from tools like Datadog, Prometheus, and Azure Monitor to Port. - [APM & alerting](/build-your-software-catalog/sync-data-to-catalog/apm-alerting.md): Overview of APM and alerting integrations for syncing monitoring data from tools like Datadog, Prometheus, and Azure Monitor to Port. ##### azure-monitor Learn how to ingest Azure Monitor alerts, activity logs, and metrics into Port using the Ocean custom integration framework. - [Azure Monitor](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/azure-monitor.md): Learn how to ingest Azure Monitor alerts, activity logs, and metrics into Port using the Ocean custom integration framework. ##### datadog Sync Datadog monitors, services, SLOs, and host data into Port's software catalog, and use it across scorecards, dashboards, and automations. - [Datadog](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/datadog.md): Sync Datadog monitors, services, SLOs, and host data into Port's software catalog, and use it across scorecards, dashboards, and automations. - [Examples](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/datadog/examples.md): Mapping examples for Datadog resources including monitors, services, SLOs, and dashboards using the Datadog integration. ##### dynatrace Sync Dynatrace monitoring data, problems, and services into Port's software catalog. - [Dynatrace](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/dynatrace.md): Sync Dynatrace monitoring data, problems, and services into Port's software catalog. ##### newrelic Sync New Relic monitoring data, alerts, and services into Port's software catalog. - [New Relic](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/newrelic.md): Sync New Relic monitoring data, alerts, and services into Port's software catalog. ##### prometheus Learn how to ingest Prometheus alerts, rules, and scrape targets into Port using the Ocean custom integration framework. - [Prometheus](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/prometheus.md): Learn how to ingest Prometheus alerts, rules, and scrape targets into Port using the Ocean custom integration framework. ##### sentry Sync Sentry projects, issues, and error tracking data into Port's software catalog. - [Sentry](/build-your-software-catalog/sync-data-to-catalog/apm-alerting/sentry.md): Sync Sentry projects, issues, and error tracking data into Port's software catalog. #### argocd Sync Argo CD applications, deployments, and clusters into Port's software catalog. - [Argo CD](/build-your-software-catalog/sync-data-to-catalog/argocd.md): Sync Argo CD applications, deployments, and clusters into Port's software catalog. ##### example Mapping examples for ArgoCD resources including clusters, projects, applications, and deployment history. - [Examples](/build-your-software-catalog/sync-data-to-catalog/argocd/example.md): Mapping examples for ArgoCD resources including clusters, projects, applications, and deployment history. #### cicd ##### jenkins Sync Jenkins jobs, builds, and pipelines into Port's software catalog. - [Jenkins](/build-your-software-catalog/sync-data-to-catalog/cicd/jenkins.md): Sync Jenkins jobs, builds, and pipelines into Port's software catalog. ##### octopus-deploy Sync Octopus Deploy projects, releases, and deployments into Port's software catalog. - [Octopus Deploy Integration](/build-your-software-catalog/sync-data-to-catalog/cicd/octopus-deploy.md): Sync Octopus Deploy projects, releases, and deployments into Port's software catalog. - [Ingest additional resources](/build-your-software-catalog/sync-data-to-catalog/cicd/octopus-deploy/mapping-extra-resources.md): Learn how to map additional Octopus Deploy resources like runbooks, tasks, teams, environments, and workers into Port. #### cloud-cost Overview of cloud cost integrations for syncing cost and usage data from tools like Kubecost and OpenCost to Port. - [Cloud cost](/build-your-software-catalog/sync-data-to-catalog/cloud-cost.md): Overview of cloud cost integrations for syncing cost and usage data from tools like Kubecost and OpenCost to Port. ##### kubecost Sync Kubecost cost allocation and Kubernetes spend data into Port's software catalog. - [Kubecost](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/kubecost.md): Sync Kubecost cost allocation and Kubernetes spend data into Port's software catalog. - [Advanced configuration for Kubecost objects](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/kubecost/advanced.md): Advanced configuration options for Kubecost integration including allocation queries, filters, and cloud cost aggregation parameters. ##### opencost Sync OpenCost Kubernetes cost and resource spend data into Port's software catalog. - [OpenCost](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost.md): Sync OpenCost Kubernetes cost and resource spend data into Port's software catalog. #### cloud-providers Overview of cloud provider integrations for syncing AWS, Azure, and GCP resources to your Port software catalog. - [Cloud providers](/build-your-software-catalog/sync-data-to-catalog/cloud-providers.md): Overview of cloud provider integrations for syncing AWS, Azure, and GCP resources to your Port software catalog. ##### aws-v3 - [Installation](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/installation.md): Install the Port AWS integration using Port-hosted or self-hosted deployment. Covers single account and multi-account setups via ECS, EC2, EKS (IRSA), or one-off Docker runs. - [AWS v3](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/Overview.md): Learn how to sync AWS resources like EC2, S3, Lambda, EKS, and more to Port using the AWS v3 integration with flexible deployment options. - [AWS resource and property reference](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference.md): Reference guide for AWS resource types, actions, and properties supported by the AWS v3 integration including EC2, S3, ECS, Lambda, and more. - [Amazon Elastic Compute Cloud (EC2)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-compute-cloud.md): Reference for Amazon EC2 resources including instances and volumes with supported actions, permissions, and mapping configurations. - [Amazon Elastic Container Registry (ECR)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-registry.md): Reference for Amazon ECR repository resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon Elastic Container Service (ECS)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-container-service.md): Reference for Amazon ECS resources including clusters, services, and task definitions with supported actions and mapping configurations. - [Amazon Elastic Kubernetes Service (EKS)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elastic-kubernetes-service.md): Reference for Amazon EKS cluster resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon ElastiCache](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-elasticache.md): Reference for Amazon ElastiCache resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon Managed Streaming for Apache Kafka (MSK)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-managed-streaming-for-apache-kafka.md): Reference for Amazon MSK cluster resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon Relational Database Service (RDS)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-relational-database-service.md): Reference for Amazon RDS DB instance resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon Simple Queue Service (SQS)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-queue-service.md): Reference for Amazon SQS resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [Amazon Simple Storage Service (S3)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/amazon-simple-storage-service.md): Reference for Amazon S3 bucket resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [AWS Account](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-account.md): Reference for AWS Account information resources for resyncing account data without AWS Organizations permissions. - [AWS Lambda](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-lambda.md): Reference for AWS Lambda resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. - [AWS Organizations](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws-v3/resource-and-property-reference/aws-organizations.md): Reference for AWS Organizations account resources including supported actions, permissions, and mapping configurations for the AWS v3 integration. ##### aws Sync AWS resources into Port's software catalog using the self-hosted AWS integration. - [AWS on-premise](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws.md): Sync AWS resources into Port's software catalog using the self-hosted AWS integration. - [AWS exporter](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/aws-exporter.md): Deprecated AWS exporter documentation - learn about the legacy serverless application for syncing AWS resources to Port. - [Event-based updates](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/aws-exporter/event-based-updates.md): Learn how to configure real-time event-based updates for the deprecated AWS exporter using EventBridge and CloudTrail. - [Examples](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/aws-exporter/examples.md): Examples of mapping AWS resources like ECS clusters, S3 buckets, Lambda functions, and more using the deprecated AWS exporter. - [Connect ECR repository to a service](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/aws-exporter/examples/connect-ecr-repo-to-service-using-tags.md): Learn how to connect AWS ECR repositories to existing services in Port using resource tags for the deprecated AWS exporter. - [Installation](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/aws-exporter/installation.md): Installation guide for the deprecated AWS exporter using Terraform or manual SAM deployment methods. - [Examples](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/examples.md): Base mapping examples for AWS resources including accounts and generic cloud resources using the AWS Ocean integration. - [Mapping Extra Resources](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/examples/mapping_extra_resources.md): Learn how to map additional AWS resources to Port including ECS, Lambda, SQS, DynamoDB, and other Cloud Control API supported resources. - [Live events setup](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/live-events.md): Learn how to set up real-time event processing for AWS resources using EventBridge and CloudTrail to keep your Port catalog updated. - [Multi account support](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/multi_account.md): Learn how to configure the AWS Ocean integration to ingest resources from multiple AWS accounts using cross-account IAM roles. ##### azure Sync Azure cloud resources into Port's software catalog. - [Azure](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure.md): Sync Azure cloud resources into Port's software catalog. - [Azure Resource Graph (Beta)](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/azure-resource-graph.md): Learn how to sync Azure resources to Port using the Azure Resource Graph integration for high-volume, multi-subscription data ingestion. - [Resource Templates](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/resource_templates.md): Base mapping templates for Azure resources including subscriptions, resource groups, and generic cloud resources using the Azure integration. - [Advanced Templates](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/resource_templates/advanced.md): Advanced mapping templates for Azure resources including storage accounts, AKS clusters, virtual machines, and Service Bus resources. - [Mapping Extra Resources](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/resource_templates/mapping_extra_resources.md): Learn how to map additional Azure resources to Port that are not covered in the standard templates by using the Azure REST API reference. ##### gcp Sync Google Cloud (GCP) resources into Port's software catalog. - [GCP](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/gcp.md): Sync Google Cloud (GCP) resources into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/gcp/examples.md): Base mapping examples for GCP resources including projects and generic cloud resources using the GCP integration. - [Map Extra Resources](/build-your-software-catalog/sync-data-to-catalog/cloud-providers/gcp/examples/mapping_extra_resources.md): Learn how to map additional GCP resources to Port including compute instances, BigQuery datasets, and other Asset Inventory supported resources. #### code-quality-security Overview of code quality and security integrations for syncing data from tools like SonarQube, Snyk, Wiz, and Checkmarx to Port. - [Code quality & security](/build-your-software-catalog/sync-data-to-catalog/code-quality-security.md): Overview of code quality and security integrations for syncing data from tools like SonarQube, Snyk, Wiz, and Checkmarx to Port. ##### aikido Sync Aikido security findings and vulnerabilities into Port's software catalog. - [Aikido](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/aikido.md): Sync Aikido security findings and vulnerabilities into Port's software catalog. ##### armorcode Sync ArmorCode security findings and ASPM data into Port's software catalog. - [ArmorCode](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/armorcode.md): Sync ArmorCode security findings and ASPM data into Port's software catalog. ##### browserstack Learn how to ingest BrowserStack Automate test data including plans, projects, and builds into Port using the Ocean custom integration. - [BrowserStack](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/browserstack.md): Learn how to ingest BrowserStack Automate test data including plans, projects, and builds into Port using the Ocean custom integration. ##### checkmarx Sync Checkmarx One scan results and security findings into Port's software catalog. - [Checkmarx One](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/checkmarx.md): Sync Checkmarx One scan results and security findings into Port's software catalog. - [Resource mapping examples](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/checkmarx/examples.md): Mapping examples for Checkmarx resources including projects, scans, SAST, SCA, KICS, and API security findings with blueprints and configurations. ##### snyk Sync Snyk vulnerabilities, projects, and security findings into Port's software catalog. - [Snyk](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/snyk.md): Sync Snyk vulnerabilities, projects, and security findings into Port's software catalog. ##### sonarqube Sync SonarQube code quality metrics, issues, and projects into Port's software catalog. - [SonarQube](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/sonarqube.md): Sync SonarQube code quality metrics, issues, and projects into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/sonarqube/examples.md): Mapping examples for SonarQube resources including projects and analysis results with blueprints and configurations. ##### wiz Sync Wiz cloud security issues and findings into Port's software catalog. - [Wiz](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/wiz.md): Sync Wiz cloud security issues and findings into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/code-quality-security/wiz/examples.md): Mapping examples for Wiz resources including projects, cloud resources, issues, and control findings with blueprints and configurations. #### event-processing ##### kafka Sync Kafka clusters, topics, and brokers into Port's software catalog. - [Kafka](/build-your-software-catalog/sync-data-to-catalog/event-processing/kafka.md): Sync Kafka clusters, topics, and brokers into Port's software catalog. #### feature-management ##### launchdarkly LaunchDarkly integration in Port - [LaunchDarkly](/build-your-software-catalog/sync-data-to-catalog/feature-management/launchdarkly.md): LaunchDarkly integration in Port #### git Overview of Git provider integrations for syncing repositories, pull requests, and other data from GitHub, GitLab, Bitbucket, and Azure DevOps. - [Git](/build-your-software-catalog/sync-data-to-catalog/git.md): Overview of Git provider integrations for syncing repositories, pull requests, and other data from GitHub, GitLab, Bitbucket, and Azure DevOps. ##### azure-devops Sync Azure DevOps repositories, pull requests, and pipelines into Port's software catalog. - [Azure DevOps](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops.md): Sync Azure DevOps repositories, pull requests, and pipelines into Port's software catalog. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/advanced.md): Advanced Azure DevOps integration configuration including createMissingRelatedEntities, deleteDependentEntities, and custom settings. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/capabilities.md): Azure DevOps integration capabilities including file content enrichment for READMEs, CODEOWNERS, and documentation in entity properties. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md): Azure DevOps integration examples for repositories, pull requests, pipelines, teams, and members with blueprint definitions and mapping configurations. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/gitops.md): Manage Port entities as code using port.yml files in Azure DevOps repositories. Define entities declaratively and sync via push events. - [Mapping Extensions](/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/mapping_extensions.md): Extend Azure DevOps mapping with additional data sources beyond JQ. Includes file content enrichment and custom resource extraction. ##### bitbucket - [Bitbucket app (deprecated)](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-app.md): Deprecated Bitbucket Cloud app integration - use the newer Bitbucket Cloud integration instead for syncing repositories and pull requests. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-app/advanced.md): Advanced Bitbucket App configuration including createMissingRelatedEntities and deleteDependentEntities flags. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-app/examples.md): Bitbucket App integration examples for repositories, file contents, and pull requests with blueprint definitions and mapping configurations. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-app/gitops.md): Manage Port entities as code using port.yml files with Bitbucket App. Define entities declaratively and sync via push events. - [Bitbucket Cloud](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud.md): Sync Bitbucket Cloud repositories, pull requests, and projects into Port's software catalog. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/advanced.md): Advanced Bitbucket Cloud configuration including createMissingRelatedEntities and deleteDependentEntities flags. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/capabilities.md): Bitbucket Cloud integration capabilities including repository, pull request, and file ingestion with automatic blueprint creation. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/examples.md): Bitbucket Cloud integration examples for repositories, pull requests, projects, and files with blueprint definitions and mapping configurations. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/gitops.md): Manage Port entities as code using port.yml files in Bitbucket Cloud repositories. Define entities declaratively and sync automatically. - [Bitbucket (self-hosted)](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-server.md): Sync Bitbucket (self-hosted) repositories, pull requests, and projects into Port's software catalog. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-server/gitops.md): Manage Port entities as code using port.yml files in Bitbucket Server repositories. Define entities declaratively and sync via webhooks. ##### custom-gitops-integration Learn how to create a custom GitOps integration to manage Port entities using JSON files in your Git repositories. - [Custom GitOps Integration](/build-your-software-catalog/sync-data-to-catalog/git/custom-gitops-integration.md): Learn how to create a custom GitOps integration to manage Port entities using JSON files in your Git repositories. ##### github-ocean Sync GitHub repositories, pull requests, workflows, and deployments into Port's software catalog using the GitHub Ocean integration. - [GitHub (Ocean)](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean.md): Sync GitHub repositories, pull requests, workflows, and deployments into Port's software catalog using the GitHub Ocean integration. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/capabilities.md): Advanced capabilities of the GitHub Ocean integration including parallel processing, file content ingestion, and custom query filtering. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples.md): Mapping examples for GitHub Ocean resources including repositories, pull requests, issues, deployments, releases, and team members. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/gitops.md): Manage Port entities as code using port.yml files in GitHub repositories. Define entities declaratively and sync via push events. - [Key changes](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/migration/key-changes.md): Overview of key changes between legacy GitHub app and GitHub Ocean including multi-org support, authentication, and mapping syntax updates. - [Migration steps](/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/migration/migration-steps.md): Step-by-step guide for migrating from the legacy GitHub app to GitHub Ocean, including entity ownership transfer and mapping updates. ##### gitlab-v2 Sync GitLab projects, merge requests, and pipelines into Port's software catalog using the v2 integration. - [GitLab v2](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2.md): Sync GitLab projects, merge requests, and pipelines into Port's software catalog using the v2 integration. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/advanced.md): Advanced GitLab v2 configuration including createMissingRelatedEntities, deleteDependentEntities, and custom integration flags. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/capabilities.md): GitLab v2 integration capabilities including file content enrichment for READMEs, CODEOWNERS, and documentation in entity properties. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md): Mapping examples for GitLab v2 resources including groups, projects, issues, merge requests, pipelines, and releases with blueprints and configurations. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/gitops.md): Manage Port entities as code using port.yml files in GitLab v2 repositories. Define entities declaratively and sync via push events. - [Mapping extensions](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/mapping_extensions.md): Extend GitLab v2 mapping with additional data sources beyond JQ. Includes file content enrichment and external API lookups. - [Migration guide to the v2 integration](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/migration.md): Migrate from GitLab v1 to v2 integration. Replace group tokens with service account authentication and update mapping configurations. ##### gitlab Sync GitLab projects, merge requests, and pipelines into Port's software catalog. - [GitLab](/build-your-software-catalog/sync-data-to-catalog/git/gitlab.md): Sync GitLab projects, merge requests, and pipelines into Port's software catalog. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/git/gitlab/advanced.md): Advanced configuration options for the GitLab integration including delete dependents and entity creation flags. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/git/gitlab/capabilities.md): Advanced capabilities of the GitLab integration including file ingestion, folder mapping, and live events configuration. - [Examples](/build-your-software-catalog/sync-data-to-catalog/git/gitlab/examples.md): Mapping examples for GitLab resources including projects, merge requests, pipelines, issues, and groups with blueprints and configurations. - [GitOps](/build-your-software-catalog/sync-data-to-catalog/git/gitlab/gitops.md): Manage Port entities as code using port.yml files in GitLab repositories. Define entities declaratively and sync via push events. - [Mapping Extensions](/build-your-software-catalog/sync-data-to-catalog/git/gitlab/mapping_extensions.md): Extend GitLab mapping with additional data sources beyond JQ. Includes file content enrichment and custom resource extraction. ##### gitops-using-port-crd Learn how to use GitOps with Port's Kubernetes CRDs to export custom entities from your K8s clusters to the catalog. - [GitOps using Port CRDs](/build-your-software-catalog/sync-data-to-catalog/git/gitops-using-port-crd.md): Learn how to use GitOps with Port's Kubernetes CRDs to export custom entities from your K8s clusters to the catalog. ##### working-with-monorepos Learn how to configure Git integrations to create separate entities for each microservice in a monorepo. - [Working with monorepos](/build-your-software-catalog/sync-data-to-catalog/git/working-with-monorepos.md): Learn how to configure Git integrations to create separate entities for each microservice in a monorepo. #### identity-providers ##### azure-ad Learn how to ingest Microsoft Entra ID (Azure AD) users, groups, applications, and service principals into Port. - [Microsoft Entra ID](/build-your-software-catalog/sync-data-to-catalog/identity-providers/azure-ad.md): Learn how to ingest Microsoft Entra ID (Azure AD) users, groups, applications, and service principals into Port. ##### okta Sync Okta users, groups, and applications into Port's software catalog. - [Okta](/build-your-software-catalog/sync-data-to-catalog/identity-providers/okta.md): Sync Okta users, groups, and applications into Port's software catalog. #### incident-management Overview of incident management integrations for syncing data from tools like PagerDuty, OpsGenie, and Incident.io to Port. - [Incident management](/build-your-software-catalog/sync-data-to-catalog/incident-management.md): Overview of incident management integrations for syncing data from tools like PagerDuty, OpsGenie, and Incident.io to Port. ##### firehydrant Sync FireHydrant incidents, services, and on-call data into Port's software catalog. - [FireHydrant](/build-your-software-catalog/sync-data-to-catalog/incident-management/firehydrant.md): Sync FireHydrant incidents, services, and on-call data into Port's software catalog. ##### incident-io Learn how to ingest Incident.io incidents, alerts, schedules, and teams into Port using the Ocean custom integration framework. - [Incident.io](/build-your-software-catalog/sync-data-to-catalog/incident-management/incident-io.md): Learn how to ingest Incident.io incidents, alerts, schedules, and teams into Port using the Ocean custom integration framework. ##### jira-service-management Learn how to ingest Jira Service Management service desks, customer requests, and organizations into Port using the Ocean custom integration. - [Jira Service Management (JSM)](/build-your-software-catalog/sync-data-to-catalog/incident-management/jira-service-management.md): Learn how to ingest Jira Service Management service desks, customer requests, and organizations into Port using the Ocean custom integration. ##### opsgenie Sync Opsgenie alerts, incidents, services, and on-call schedules into Port's software catalog. - [Opsgenie](/build-your-software-catalog/sync-data-to-catalog/incident-management/opsgenie.md): Sync Opsgenie alerts, incidents, services, and on-call schedules into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/incident-management/opsgenie/examples.md): Mapping examples for OpsGenie resources including users, teams, services, alerts, and incidents with blueprints and configurations. ##### pagerduty Sync PagerDuty services, incidents, and on-call schedules into Port's software catalog. - [PagerDuty](/build-your-software-catalog/sync-data-to-catalog/incident-management/pagerduty.md): Sync PagerDuty services, incidents, and on-call schedules into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/incident-management/pagerduty/examples.md): Mapping examples for PagerDuty resources including users, teams, services, incidents, and schedules with blueprints and configurations. ##### rootly Learn how to ingest Rootly incidents, services, teams, and on-call data into Port using the Ocean custom integration framework. - [Rootly](/build-your-software-catalog/sync-data-to-catalog/incident-management/rootly.md): Learn how to ingest Rootly incidents, services, teams, and on-call data into Port using the Ocean custom integration framework. ##### servicenow Sync ServiceNow incidents, services, and CMDB data into Port's software catalog. - [ServiceNow](/build-your-software-catalog/sync-data-to-catalog/incident-management/servicenow.md): Sync ServiceNow incidents, services, and CMDB data into Port's software catalog. ##### statuspage Sync Statuspage pages, components, and incidents into Port's software catalog. - [Statuspage](/build-your-software-catalog/sync-data-to-catalog/incident-management/statuspage.md): Sync Statuspage pages, components, and incidents into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/incident-management/statuspage/examples.md): Mapping examples for Statuspage resources including status pages, components, incidents, and maintenance windows with blueprints and configurations. #### kubernetes-stack ##### komodor Sync Komodor Kubernetes services, deployments, and health data into Port's software catalog. - [Komodor](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/komodor.md): Sync Komodor Kubernetes services, deployments, and health data into Port's software catalog. ##### kubernetes Sync Kubernetes workloads, namespaces, and resources into Port's software catalog. - [Kubernetes](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes.md): Sync Kubernetes workloads, namespaces, and resources into Port's software catalog. - [Advanced](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/advanced.md): Advanced configuration options for the Kubernetes exporter including resync intervals, state keys, and delete behavior parameters. - [Basic example](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/basic-example.md): Basic Example - [Custom CRDs](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/custom-crds.md): Learn how to export and map custom Kubernetes CRDs like ArgoCD resources to Port using the K8s exporter. - [Port Entity CRD](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/port-crd.md): Learn how to use Port's Kubernetes Custom Resource Definitions to define and sync entities from K8s cluster manifests to your catalog. - [Templates](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates.md): Pre-built configuration templates for common Kubernetes exporter use cases and third-party tools like ArgoCD and Istio. - [FluxCD](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/fluxcd.md): FluxCD quickstart - [Kubernetes (advanced)](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/full-kubernetes-exporter.md): Advanced Kubernetes installation - [Istio](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/istio.md): Istio quickstart - [Knative](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/knative.md): Knative quickstart - [Kyverno](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/kyverno.md): Kyverno quickstart - [Red Hat Openshift](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/openshift.md): Openshift quickstart - [Trivy Operator](/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/templates/trivy.md): Trivy quickstart #### other ##### amplication Sync Amplication services and generated resources into Port's software catalog. - [Amplication](/build-your-software-catalog/sync-data-to-catalog/other/amplication.md): Sync Amplication services and generated resources into Port's software catalog. ##### backstage Ingest Backstage entities into your context lake so that agents, workflows, and your team members can access and act on them. - [Backstage](/build-your-software-catalog/sync-data-to-catalog/other/backstage.md): Ingest Backstage entities into your context lake so that agents, workflows, and your team members can access and act on them. ##### slack Learn how to ingest Slack users, channels, and user groups into Port using the Ocean custom integration framework. - [Slack](/build-your-software-catalog/sync-data-to-catalog/other/slack.md): Learn how to ingest Slack users, channels, and user groups into Port using the Ocean custom integration framework. #### project-management Overview of project management integrations for syncing data from tools like Jira, Linear, and other project tracking systems to Port. - [Project management](/build-your-software-catalog/sync-data-to-catalog/project-management.md): Overview of project management integrations for syncing data from tools like Jira, Linear, and other project tracking systems to Port. ##### jira-server Sync Jira Server (self-hosted) projects and issues into Port's software catalog. - [Jira Server (self-hosted)](/build-your-software-catalog/sync-data-to-catalog/project-management/jira-server.md): Sync Jira Server (self-hosted) projects and issues into Port's software catalog. - [Examples](/build-your-software-catalog/sync-data-to-catalog/project-management/jira-server/examples.md): Mapping examples for Jira Server resources including projects, users, and issues with default blueprints and configurations. ##### jira Sync Jira projects, issues, and teams into Port's software catalog. - [Jira](/build-your-software-catalog/sync-data-to-catalog/project-management/jira.md): Sync Jira projects, issues, and teams into Port's software catalog. - [Capabilities](/build-your-software-catalog/sync-data-to-catalog/project-management/jira/capabilities.md): Advanced capabilities of the Jira integration including JQL filtering, field selection, live events, and sprints ingestion. - [Examples](/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples.md): Mapping examples for Jira Cloud resources including issues, epics, sprints, boards, teams, and components with blueprints and configurations. ##### linear Sync Linear teams, issues, and projects into Port's software catalog. - [Linear](/build-your-software-catalog/sync-data-to-catalog/project-management/linear.md): Sync Linear teams, issues, and projects into Port's software catalog. #### terraform-cloud Terraform integration in Port - [Terraform Cloud & Terraform Enterprise](/build-your-software-catalog/sync-data-to-catalog/terraform-cloud.md): Terraform integration in Port ##### examples Mapping examples for Terraform Cloud resources including organizations, workspaces, runs, and state versions with blueprints and configurations. - [Examples](/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/examples.md): Mapping examples for Terraform Cloud resources including organizations, workspaces, runs, and state versions with blueprints and configurations. ## actions-and-automations ### create-self-service-experiences Create self-service actions that let developers trigger workflows from Port, such as scaffolding services, provisioning resources, and running day-2 operations, with forms, guardrails, and approvals. - [Self-service actions](/actions-and-automations/create-self-service-experiences.md): Create self-service actions that let developers trigger workflows from Port, such as scaffolding services, provisioning resources, and running day-2 operations, with forms, guardrails, and approvals. #### send-link-to-action Generate shareable URLs with pre-filled action inputs using JSURL encoding. Useful for bookmarks, documentation, and programmatic links. - [Share a pre-filled action URL](/actions-and-automations/create-self-service-experiences/send-link-to-action.md): Generate shareable URLs with pre-filled action inputs using JSURL encoding. Useful for bookmarks, documentation, and programmatic links. #### set-self-service-actions-rbac Control who can execute self-service actions using role-based permissions. Configure manual approval workflows and ownership-based restrictions. - [Set actions RBAC](/actions-and-automations/create-self-service-experiences/set-self-service-actions-rbac.md): Control who can execute self-service actions using role-based permissions. Configure manual approval workflows and ownership-based restrictions. ##### dynamic-permissions Control action execution and approval using runtime data from your catalog. Define queries and JQ conditions for ownership, manager approval, and on-call rules. - [Dynamic permissions](/actions-and-automations/create-self-service-experiences/set-self-service-actions-rbac/dynamic-permissions.md): Control action execution and approval using runtime data from your catalog. Define queries and JQ conditions for ownership, manager approval, and on-call rules. - [Examples](/actions-and-automations/create-self-service-experiences/set-self-service-actions-rbac/dynamic-permissions/examples.md): Dynamic permissions examples including blocking duplicate entities, requiring manager approval, and enforcing ownership-based execution rules. #### setup-the-backend Configure self-service action backends to execute logic when triggered. Supports GitHub, GitLab, Azure DevOps, Jenkins, webhooks, and more. - [Set up backend](/actions-and-automations/create-self-service-experiences/setup-the-backend.md): Configure self-service action backends to execute logic when triggered. Supports GitHub, GitLab, Azure DevOps, Jenkins, webhooks, and more. #### setup-ui-for-action Configure self-service action frontend including title, icon, operation type (create, day-2, delete), and user form inputs. - [Set up frontend](/actions-and-automations/create-self-service-experiences/setup-ui-for-action.md): Configure self-service action frontend including title, icon, operation type (create, day-2, delete), and user form inputs. ##### advanced-form-configurations Advanced input settings allow you to create more customizable experiences for users who perform self-service actions. This is done by creating adaptive inputs that change according to data about the entity, the user, and other inputs. - [Advanced input configurations](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/advanced-form-configurations.md): Advanced input settings allow you to create more customizable experiences for users who perform self-service actions. This is done by creating adaptive inputs that change according to data about the entity, the user, and other inputs. ##### user-inputs Define user inputs for self-service actions with various types, validation rules, default values, and conditional visibility using jqQuery. - [User Inputs](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs.md): Define user inputs for self-service actions with various types, validation rules, default values, and conditional visibility using jqQuery. - [Array](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/array.md): Array is an input for lists of data - [Datetime](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/datetime.md): Datetime is an input used to reference a date and time - [Email](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/email.md): Email is an input used to save Email addresses - [Entity](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/entity.md): Entity is an input used to reference existing entities from the software catalog when triggering actions - [Number](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/number.md): Number is a basic input for numeric data - [Object](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/object.md): Object is a basic input for JSON data - [Secret](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/secret.md): A secret input encrypts its value before sending it to your backend and never stores or logs it. Choose Port-managed encryption or your own public key. - [Team](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/team.md): Team is an input used to reference teams that exist in Port - [Text](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/text.md): Text is a basic input for textual information - [Toggle (Boolean)](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/toggle.md): Toggle is a basic input that has one of two possible values - true and false - [URL](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/url.md): URL is an input used to save links to websites - [User](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/user.md): User is an input used to reference users that exist in Port - [Yaml](/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/yaml.md): Yaml is an input used to save object definitions in YAML ### define-automations Create Port automations that trigger actions automatically based on catalog events like entity creation, updates, timers, or external webhooks. Configure triggers, conditions, and backend handlers. - [Define automations](/actions-and-automations/define-automations.md): Create Port automations that trigger actions automatically based on catalog events like entity creation, updates, timers, or external webhooks. Configure triggers, conditions, and backend handlers. #### examples Automation examples including Slack/Teams notifications on entity changes, TTL enforcement, PagerDuty incident creation, and scorecard-based alerts. - [Examples](/actions-and-automations/define-automations/examples.md): Automation examples including Slack/Teams notifications on entity changes, TTL enforcement, PagerDuty incident creation, and scorecard-based alerts. #### migrate-from-changelog-destination Step-by-step guide for migrating from the legacy changelogDestination feature to Port Automations. - [Migrate from changelog destination](/actions-and-automations/define-automations/migrate-from-changelog-destination.md): Step-by-step guide for migrating from the legacy changelogDestination feature to Port Automations. #### setup-action Configure automation backends including webhook, GitHub, GitLab, and Kafka. Define JSON payloads with jq expressions and access trigger event data. - [Set up backend](/actions-and-automations/define-automations/setup-action.md): Configure automation backends including webhook, GitHub, GitLab, and Kafka. Define JSON payloads with jq expressions and access trigger event data. #### setup-trigger Configure automation triggers for entity events (create, update, delete, timer expiration) or action run status changes. Supports JQ conditions for filtering. - [Set up trigger](/actions-and-automations/define-automations/setup-trigger.md): Configure automation triggers for entity events (create, update, delete, timer expiration) or action run status changes. Supports JQ conditions for filtering. ### overview Port actions and automations overview. Actions are user-triggered workflows; automations run on infrastructure events. Both support multiple backend types. - [Overview](/actions-and-automations/overview.md): Port actions and automations overview. Actions are user-triggered workflows; automations run on infrastructure events. Both support multiple backend types. ### reflect-action-progress Once a self-service action or automation has been executed, an actionRun object will be created in Port. - [Interact with action runs](/actions-and-automations/reflect-action-progress.md): Once a self-service action or automation has been executed, an actionRun object will be created in Port. ### setup-backend Configure backends for self-service actions including GitHub workflows, GitLab pipelines, Azure DevOps, Jenkins, webhooks, and Kafka topics. - [Backend types](/actions-and-automations/setup-backend.md): Configure backends for self-service actions including GitHub workflows, GitLab pipelines, Azure DevOps, Jenkins, webhooks, and Kafka topics. #### azure-pipeline The Azure backend can trigger Azure pipelines for both self-service actions and automations, using incoming webhook triggers. - [Azure pipeline](/actions-and-automations/setup-backend/azure-pipeline.md): The Azure backend can trigger Azure pipelines for both self-service actions and automations, using incoming webhook triggers. ##### trigger-non-default-branch Configure Port self-service actions to trigger Azure DevOps pipelines from non-default branches using refName parameter. - [Trigger pipelines in non-default branch](/actions-and-automations/setup-backend/azure-pipeline/trigger-non-default-branch.md): Configure Port self-service actions to trigger Azure DevOps pipelines from non-default branches using refName parameter. ##### troubleshooting Common questions and solutions for Azure DevOps integration and pipelines in Port. - [Azure DevOps troubleshooting](/actions-and-automations/setup-backend/azure-pipeline/troubleshooting.md): Common questions and solutions for Azure DevOps integration and pipelines in Port. #### create-update-entity In some cases, we don't want to run complex logic via a workflow or pipeline, but rather want our backend to simply create or update an entity in our software catalog. - [Create/update entity](/actions-and-automations/setup-backend/create-update-entity.md): In some cases, we don't want to run complex logic via a workflow or pipeline, but rather want our backend to simply create or update an entity in our software catalog. #### github-ocean The GitHub Ocean backend allows you to trigger GitHub workflows for your self-service actions and automations, using the GitHub Ocean integration. - [GitHub workflow via Ocean](/actions-and-automations/setup-backend/github-ocean.md): The GitHub Ocean backend allows you to trigger GitHub workflows for your self-service actions and automations, using the GitHub Ocean integration. #### github-workflow The GitHub backend allows you to trigger GitHub workflows for your self-service actions and automations, using Port's GitHub application. - [GitHub workflow](/actions-and-automations/setup-backend/github-workflow.md): The GitHub backend allows you to trigger GitHub workflows for your self-service actions and automations, using Port's GitHub application. ##### auto-discovery Automatically discover and import GitHub workflow actions into Port as self-service actions using the auto discovery tool. - [Auto discovery](/actions-and-automations/setup-backend/github-workflow/auto-discovery.md): Automatically discover and import GitHub workflow actions into Port as self-service actions using the auto discovery tool. #### gitlab-pipeline The GitLab backend allows you to trigger GitLab pipelines for your self-service actions and automations. - [GitLab pipeline](/actions-and-automations/setup-backend/gitlab-pipeline.md): The GitLab backend allows you to trigger GitLab pipelines for your self-service actions and automations. ##### saas Trigger GitLab SaaS pipelines from Port self-service actions using webhook URLs with trigger tokens. - [GitLab SaaS](/actions-and-automations/setup-backend/gitlab-pipeline/saas.md): Trigger GitLab SaaS pipelines from Port self-service actions using webhook URLs with trigger tokens. ##### self-hosted Trigger self-hosted GitLab pipelines from Port using the execution agent with Kafka messaging and GitLab trigger tokens. - [Self-hosted GitLab](/actions-and-automations/setup-backend/gitlab-pipeline/self-hosted.md): Trigger self-hosted GitLab pipelines from Port using the execution agent with Kafka messaging and GitLab trigger tokens. #### jenkins-pipeline The Jenkins backend allows you to trigger Jenkins pipelines for your self-service actions and automations, using webhooks. - [Jenkins pipeline](/actions-and-automations/setup-backend/jenkins-pipeline.md): The Jenkins backend allows you to trigger Jenkins pipelines for your self-service actions and automations, using webhooks. #### kafka Port manages a Kafka topic per customer that publishes the execution run requests. - [Kafka topic](/actions-and-automations/setup-backend/kafka.md): Port manages a Kafka topic per customer that publishes the execution run requests. #### security Port IP addresses for firewall allow lists. Covers webhook outbound IPs and Ocean integration source IPs for EU and US regions. - [Security](/actions-and-automations/setup-backend/security.md): Port IP addresses for firewall allow lists. Covers webhook outbound IPs and Ocean integration source IPs for EU and US regions. #### send-slack-message The Send Slack message backend type allows you to send a message to a Slack channel, using a webhook URL. - [Send Slack message](/actions-and-automations/setup-backend/send-slack-message.md): The Send Slack message backend type allows you to send a message to a Slack channel, using a webhook URL. #### webhook The webhook backend allows you to trigger your own custom webhooks, for both self-service actions and automations. - [Webhook](/actions-and-automations/setup-backend/webhook.md): The webhook backend allows you to trigger your own custom webhooks, for both self-service actions and automations. ##### circle-ci Port's Circle CI integration allows you to trigger new pipelines in Circle CI directly from Port. - [Circle CI Actions](/actions-and-automations/setup-backend/webhook/circle-ci.md): Port's Circle CI integration allows you to trigger new pipelines in Circle CI directly from Port. ##### cloudbuild-pipeline This page will guide you through the process of triggering your Cloud Build pipelines from Port, using Webhook Actions. - [Triggering Cloud Build using webhooks](/actions-and-automations/setup-backend/webhook/cloudbuild-pipeline.md): This page will guide you through the process of triggering your Cloud Build pipelines from Port, using Webhook Actions. ##### examples - [Software templates](/actions-and-automations/setup-backend/webhook/examples/software-templates.md): Use Cookiecutter with Port webhooks to scaffold new service repositories from software templates via self-service actions. - [Terraform: No-Code resource provisioning](/actions-and-automations/setup-backend/webhook/examples/terraform-no-code-resource-provisioning.md): Expose Terraform-based cloud resource provisioning as no-code self-service actions. Example covers S3 bucket lifecycle operations. ##### local-debugging-webhook Debug webhook self-service actions locally using smee.io to receive Port webhook payloads on your development machine. - [Debug webhooks locally](/actions-and-automations/setup-backend/webhook/local-debugging-webhook.md): Debug webhook self-service actions locally using smee.io to receive Port webhook payloads on your development machine. ##### port-execution-agent Port execution agent securely forwards action invocations to private endpoints via Kafka without exposing public URLs. Requires dedicated Kafka topic from Port support. - [Port execution agent](/actions-and-automations/setup-backend/webhook/port-execution-agent.md): Port execution agent securely forwards action invocations to private endpoints via Kafka without exposing public URLs. Requires dedicated Kafka topic from Port support. - [Control the payload](/actions-and-automations/setup-backend/webhook/port-execution-agent/control-the-payload.md): Port offers two ways to control the payload sent to your backend: - [Argo workflow](/actions-and-automations/setup-backend/webhook/port-execution-agent/examples/trigger-an-argo-workflow.md): This example helps internal developer teams to trigger an Argo Workflow using Port's self service actions. We will create a blueprint for argoWorkflow that will be connected to a backend action. We will then add some configuration files (invocations.json) to control the payload and trigger your Argo Workflows directly from Port using the sync execution method. - [CircleCI pipline](/actions-and-automations/setup-backend/webhook/port-execution-agent/examples/trigger-circleCI-pipeline.md): This example helps internal developer teams to trigger CircleCI pipelines using Port's self service actions. In particular, you will create a blueprint for circleCI Project that will be connected to a backend action. You will then add some configuration files (invocations.json) to control the payload and trigger your CircleCI pipeline directly from Port using the sync execution method. - [OpsGenie incident](/actions-and-automations/setup-backend/webhook/port-execution-agent/examples/trigger-opsgenie-incident.md): This example helps internal developer teams to trigger Opsgenie incidents using Port's self service actions. In particular, you will create a blueprint for opsgenieIncident that will be connected to a backend action. You will then add some configuration files (invocations.json) to control the payload and trigger your Opsgenie incident directly from Port using the sync execution method. - [Terraform Cloud run](/actions-and-automations/setup-backend/webhook/port-execution-agent/examples/trigger-terraform-cloud-run.md): This example helps internal developer teams to trigger an Terraform Cloud run using Port's self service actions. We will create a blueprint for Terraform Cloud Workspace that will be connected to a backend action. We will then add some configuration files (invocations.json) to control the payload and trigger your Terraform Cloud run directly from Port using the sync execution method. - [Windmill job](/actions-and-automations/setup-backend/webhook/port-execution-agent/examples/trigger-windmill-job.md): This example helps internal developer teams to trigger Windmill job using Port's self service actions. In particular, you will create a blueprint for windmillJob that will be connected to a backend action. You will then add some configuration files (invocations.json) to control the payload and trigger your Windmill job directly from Port using async/sync execution method. - [ArgoCD](/actions-and-automations/setup-backend/webhook/port-execution-agent/installation-methods/argocd.md): Install the Port execution agent in Kubernetes using ArgoCD with Helm capabilities. Includes manifest examples and configuration steps. - [Docker](/actions-and-automations/setup-backend/webhook/port-execution-agent/installation-methods/docker.md): Run the Port execution agent as a Docker container with Kafka streaming to forward action invocations to private endpoints. - [Helm](/actions-and-automations/setup-backend/webhook/port-execution-agent/installation-methods/helm.md): Install the Port execution agent in Kubernetes using Helm. Configure Kafka credentials and optional GitLab pipeline triggers. - [Usage](/actions-and-automations/setup-backend/webhook/port-execution-agent/usage.md): Configure actions to use the Port execution agent by setting type to WEBHOOK and agent to true. Supports Kafka and HTTP polling streamers. ##### signature-verification Verify webhook signatures using x-port-timestamp and x-port-signature headers to ensure requests are from Port and not tampered with. - [Validate webhook signatures](/actions-and-automations/setup-backend/webhook/signature-verification.md): Verify webhook signatures using x-port-timestamp and x-port-signature headers to ensure requests are from Port and not tampered with. ##### terraform-cloud Port's Terraform Cloud integration allows you to trigger Terraform Cloud runs directly from Port. - [Terraform cloud actions](/actions-and-automations/setup-backend/webhook/terraform-cloud.md): Port's Terraform Cloud integration allows you to trigger Terraform Cloud runs directly from Port. ## scorecards ### concepts-and-structure Understand scorecard concepts including levels, rules, conditions, and filters. Learn how scorecards are structured and how entities are evaluated against defined standards. - [Concepts and structure](/scorecards/concepts-and-structure.md): Understand scorecard concepts including levels, rules, conditions, and filters. Learn how scorecards are structured and how entities are evaluated against defined standards. ### examples #### automation-use-cases Automate responses to scorecard rule changes including Slack/Teams notifications and GitHub issue creation. Includes automation configurations and GitHub workflow examples. - [Automation use-cases](/scorecards/examples/automation-use-cases.md): Automate responses to scorecard rule changes including Slack/Teams notifications and GitHub issue creation. Includes automation configurations and GitHub workflow examples. #### extend-data-model Extend scorecard blueprints with custom properties like SLA tracking and due dates. Build automated workflows for compliance monitoring, reminders, and exception handling. - [Extend the default scorecards](/scorecards/examples/extend-data-model.md): Extend scorecard blueprints with custom properties like SLA tracking and due dates. Build automated workflows for compliance monitoring, reminders, and exception handling. #### scorecard-use-cases Practical scorecard examples including ownership scorecards, relation existence checks, and DORA metrics tracking. Ready-to-use JSON configurations you can implement immediately. - [Scorecard use-cases](/scorecards/examples/scorecard-use-cases.md): Practical scorecard examples including ownership scorecards, relation existence checks, and DORA metrics tracking. Ready-to-use JSON configurations you can implement immediately. ### manage-scorecards Create, edit, and delete Port scorecards using the UI, API, or Terraform. Includes step-by-step instructions and code examples for managing scorecards programmatically. - [Manage scorecards](/scorecards/manage-scorecards.md): Create, edit, and delete Port scorecards using the UI, API, or Terraform. Includes step-by-step instructions and code examples for managing scorecards programmatically. ### manage-using-3rd-party-apps Integrate Port scorecards with Jira, GitHub, and Slack for automated issue tracking and notifications. Overview of available third-party app integrations. - [Manage using 3rd-party apps](/scorecards/manage-using-3rd-party-apps.md): Integrate Port scorecards with Jira, GitHub, and Slack for automated issue tracking and notifications. Overview of available third-party app integrations. #### github Automatically create and close GitHub issues for violated scorecard rules using the Port message sender. Sync scorecard compliance with GitHub issue tracking. - [Open/close GitHub issues](/scorecards/manage-using-3rd-party-apps/github.md): Automatically create and close GitHub issues for violated scorecard rules using the Port message sender. Sync scorecard compliance with GitHub issue tracking. #### jira Automatically create and close Jira issues for violated scorecard rules using the Port message sender. Sync scorecard compliance with Jira task tracking. - [Open/close JIRA issues](/scorecards/manage-using-3rd-party-apps/jira.md): Automatically create and close Jira issues for violated scorecard rules using the Port message sender. Sync scorecard compliance with Jira task tracking. #### slack Send Slack reports and reminders for scorecard compliance using the Port message sender GitHub action. Includes examples of scorecard reports and reminders. - [Send Slack messages](/scorecards/manage-using-3rd-party-apps/slack.md): Send Slack reports and reminders for scorecard compliance using the Port message sender GitHub action. Includes examples of scorecard reports and reminders. ### overview Create Port scorecards to enforce engineering standards across your software catalog. Define rules, assign maturity levels (Bronze, Silver, Gold), and track compliance for services, teams, and resources. - [Scorecards](/scorecards/overview.md): Create Port scorecards to enforce engineering standards across your software catalog. Define rules, assign maturity levels (Bronze, Silver, Gold), and track compliance for services, teams, and resources. ## search-and-query ### advanced Advanced search options including attach_title_to_relation and exclude_calculated_properties query parameters for customizing search results. - [Advanced](/search-and-query/advanced.md): Advanced search options including attach_title_to_relation and exclude_calculated_properties query parameters for customizing search results. ### examples Search and query examples for catalog pages, dashboard widgets, automations, and dynamic action permissions with practical JSON rules. - [Examples](/search-and-query/examples.md): Search and query examples for catalog pages, dashboard widgets, automations, and dynamic action permissions with practical JSON rules. ### global-search Search across entities, actions, blueprints, and tech docs using Cmd+K. Configure which blueprints appear in global search results. - [Global search](/search-and-query/global-search.md): Search across entities, actions, blueprints, and tech docs using Cmd+K. Configure which blueprints appear in global search results. ### operators #### comparison-operators Comparison operators for search rules including equals, contains, greater/less than, between, isEmpty, and property existence checks. - [Comparison operators](/search-and-query/operators/comparison-operators.md): Comparison operators for search rules including equals, contains, greater/less than, between, isEmpty, and property existence checks. #### relation-operators Relation operators for searching entities by relationships including relatedTo, containsAny, and direction/depth controls for traversing relations. - [Relation operators](/search-and-query/operators/relation-operators.md): Relation operators for searching entities by relationships including relatedTo, containsAny, and direction/depth controls for traversing relations. ### overview Port's search and query syntax for filtering and retrieving catalog entities. Used in catalog pages, dashboards, scorecards, self-service action conditions, and the API. - [Overview](/search-and-query/overview.md): Port's search and query syntax for filtering and retrieving catalog entities. Used in catalog pages, dashboards, scorecards, self-service action conditions, and the API. ### structure-and-syntax Search query structure with combinators (and/or), rules, property operators, and meta-properties like $blueprint and $identifier. - [Structure & syntax](/search-and-query/structure-and-syntax.md): Search query structure with combinators (and/or), rules, property operators, and meta-properties like $blueprint and $identifier. ## guides Step-by-step tutorials and walkthroughs for specific Port use cases. These guides show you how to implement common scenarios with Port. For API reference and concept documentation, see the reference sections in /build-your-software-catalog/ and /api-reference/. - [Guides](/guides.md): Step-by-step tutorials and walkthroughs for specific Port use cases. These guides show you how to implement common scenarios with Port. For API reference and concept documentation, see the reference sections in /build-your-software-catalog/ and /api-reference/. ### all #### acknowledge-incident Learn how to acknowledge incidents in Port with our easy-to-follow guide, ensuring swift responses and streamlined operations - [Acknowledge Incident In PagerDuty](/guides/all/acknowledge-incident.md): Learn how to acknowledge incidents in Port with our easy-to-follow guide, ensuring swift responses and streamlined operations #### add-ec2-volume Create a self-service action to add EBS volumes to EC2 instances using GitLab pipelines and Terraform. - [Add a Disk to an AWS EC2 Instance](/guides/all/add-ec2-volume.md): Create a self-service action to add EBS volumes to EC2 instances using GitLab pipelines and Terraform. #### add-rca-context-to-ai-agents Learn how to enhance AI agents with custom context like Root Cause Analysis documents using entities - [Add RCA context to AI agents](/guides/all/add-rca-context-to-ai-agents.md): Learn how to enhance AI agents with custom context like Root Cause Analysis documents using entities #### ai-powered-github-workflow-documentation Automatically generate and maintain human-readable documentation for GitHub Actions workflows using Port's AI agents and automation system - [Auto-generate GitHub workflow documentation](/guides/all/ai-powered-github-workflow-documentation.md): Automatically generate and maintain human-readable documentation for GitHub Actions workflows using Port's AI agents and automation system #### ai-powered-rca-postmortem-generation Generate comprehensive RCA and postmortem documents using AI, incident context, and Port self-service actions. - [AI-powered RCA and postmortem generation](/guides/all/ai-powered-rca-postmortem-generation.md): Generate comprehensive RCA and postmortem documents using AI, incident context, and Port self-service actions. #### ai-powered-work-item-preparation Use AI to enrich work items with context, recommendations, and scorecard readiness signals. - [AI-powered work item preparation](/guides/all/ai-powered-work-item-preparation.md): Use AI to enrich work items with context, recommendations, and scorecard readiness signals. #### apply-labels-to-github-pr-based-on-sonar-scans Learn how to automatically label your GitHub pull request based on SonarQube scan reports - [Auto-label your GitHub PRs with Sonar Scans](/guides/all/apply-labels-to-github-pr-based-on-sonar-scans.md): Learn how to automatically label your GitHub pull request based on SonarQube scan reports #### approval-workflow-for-gitlab-deployment Learn how to chain self service actions and automations to manage deployment in GitLab and ServiceNow - [Approval Workflows for Service Deployment](/guides/all/approval-workflow-for-gitlab-deployment.md): Learn how to chain self service actions and automations to manage deployment in GitLab and ServiceNow #### auto-approve-and-merge-dependabot-prs Learn how to automatically approve and merge your GitHub pull request created by Dependabot - [Auto approve and merge Dependabot PRs](/guides/all/auto-approve-and-merge-dependabot-prs.md): Learn how to automatically approve and merge your GitHub pull request created by Dependabot #### auto-assign-bugs-to-owners Automatically assign Jira bugs to owning teams and services with Port automations and AI. - [Auto-assign bugs to owners with AI](/guides/all/auto-assign-bugs-to-owners.md): Automatically assign Jira bugs to owning teams and services with Port automations and AI. #### auto-enhance-pr-descriptions-with-ai Automatically enhance PR descriptions with AI-generated, template-compliant content using Port AI agents and coding assistants - [Auto-enhance PR descriptions with AI](/guides/all/auto-enhance-pr-descriptions-with-ai.md): Automatically enhance PR descriptions with AI-generated, template-compliant content using Port AI agents and coding assistants #### auto-remediate-insecure-cloud-resources-with-ai Learn how to automatically detect and remediate insecure cloud resources using Port's AI capabilities and Claude Code to generate infrastructure-as-code patches. - [Auto-remediate insecure cloud resources with AI](/guides/all/auto-remediate-insecure-cloud-resources-with-ai.md): Learn how to automatically detect and remediate insecure cloud resources using Port's AI capabilities and Claude Code to generate infrastructure-as-code patches. #### automate-slack-alert-for-overdue-prs Set up automated Slack alerts for overdue PRs in Port, ensuring timely reviews and efficient project management. - [Automate Slack Alert for Overdue PRs](/guides/all/automate-slack-alert-for-overdue-prs.md): Set up automated Slack alerts for overdue PRs in Port, ensuring timely reviews and efficient project management. #### automate-user-role-update Automatically assign an Admin role to users upon joining the admins group. - [Automate admin role assignment](/guides/all/automate-user-role-update.md): Automatically assign an Admin role to users upon joining the admins group. #### automatically-approve-action-using-automation Learn how to set up automated approvals for self service actions, improving efficiency and reducing manual overhead. - [Automate self-service action approvals](/guides/all/automatically-approve-action-using-automation.md): Learn how to set up automated approvals for self service actions, improving efficiency and reducing manual overhead. #### automatically-resolve-tickets-with-coding-agents Learn how to automatically generate GitHub issues from Jira tickets, assign them to coding agents like Copilot, and link pull requests back to Jira — using either a Port workflow or actions, automations, and an AI agent. - [Automatically resolve tickets with coding agents](/guides/all/automatically-resolve-tickets-with-coding-agents.md): Learn how to automatically generate GitHub issues from Jira tickets, assign them to coding agents like Copilot, and link pull requests back to Jira — using either a Port workflow or actions, automations, and an AI agent. #### automatically-resolve-tickets-with-n8n-port-context Learn how to use Port as a context lake in n8n workflows to automatically generate GitHub issues from Jira tickets with rich organizational context and assign them to coding agents. - [Automatically resolve tickets with n8n and Port context](/guides/all/automatically-resolve-tickets-with-n8n-port-context.md): Learn how to use Port as a context lake in n8n workflows to automatically generate GitHub issues from Jira tickets with rich organizational context and assign them to coding agents. #### automatically-set-relations-between-entities-with-automation Save time and reduce errors by automating entity relations without writing integration code. Learn how to automatically link service entities to their owning teams. - [Automatically set relations between entities with automation](/guides/all/automatically-set-relations-between-entities-with-automation.md): Save time and reduce errors by automating entity relations without writing integration code. Learn how to automatically link service entities to their owning teams. #### azure-resource-tagging-initiative Learn how to track and enforce Azure resource tagging compliance using Port scorecards, dashboards, and self-service actions. - [Track Azure Resource tagging compliance](/guides/all/azure-resource-tagging-initiative.md): Learn how to track and enforce Azure resource tagging compliance using Port scorecards, dashboards, and self-service actions. #### broadcast-api-consumers-message Learn how to broadcast messages to API consumers in Port, enhancing communication and system transparency. - [Broadcast message to API consumers](/guides/all/broadcast-api-consumers-message.md): Learn how to broadcast messages to API consumers in Port, enhancing communication and system transparency. #### build-ai-agent-registry Learn how to build a centralized AI Agent Registry in Port to discover, govern, and manage AI agents deployed across AWS Bedrock and Azure AI Foundry. - [Build an AI Agent Registry](/guides/all/build-ai-agent-registry.md): Learn how to build a centralized AI Agent Registry in Port to discover, govern, and manage AI agents deployed across AWS Bedrock and Azure AI Foundry. #### build-port-actions-with-mcp Use AI to create Port self-service actions and automations through natural language conversations, enabling workflow orchestration without manual configuration - [Build actions and automations with AI](/guides/all/build-port-actions-with-mcp.md): Use AI to create Port self-service actions and automations through natural language conversations, enabling workflow orchestration without manual configuration #### build-port-data-model-with-mcp Use AI to build and manage your Port software catalog through natural language conversations, creating blueprints, entities, relations, actions, and scorecards - [Build your software catalog with MCP](/guides/all/build-port-data-model-with-mcp.md): Use AI to build and manage your Port software catalog through natural language conversations, creating blueprints, entities, relations, actions, and scorecards #### build-port-scorecards-with-mcp Use AI to create and manage Port scorecards through natural language conversations, defining quality standards and compliance rules without manual configuration - [Define scorecards with AI](/guides/all/build-port-scorecards-with-mcp.md): Use AI to create and manage Port scorecards through natural language conversations, defining quality standards and compliance rules without manual configuration #### calculate-blast-radius-with-ai Calculate deployment blast radius and production risk using AI, service dependencies, and Port self-service actions. - [Calculate blast radius with AI](/guides/all/calculate-blast-radius-with-ai.md): Calculate deployment blast radius and production risk using AI, service dependencies, and Port self-service actions. #### centralize-ai-coding-rules-with-port Centralize AI coding rules in Port and sync them to AGENTS.md for GitHub Copilot. - [Centralize AI Coding Rules with Port](/guides/all/centralize-ai-coding-rules-with-port.md): Centralize AI coding rules in Port and sync them to AGENTS.md for GitHub Copilot. #### change-on-call-user Quickly change the on-call user in Port with this guide, ensuring continuous coverage and smooth operations. - [Change the on-call In PagerDuty](/guides/all/change-on-call-user.md): Quickly change the on-call user in Port with this guide, ensuring continuous coverage and smooth operations. #### change-pagerduty-incident-owner Effortlessly change the PagerDuty incident owner in Port, ensuring incidents are managed by the right team members. - [Change Incident Owner In Pagerduty](/guides/all/change-pagerduty-incident-owner.md): Effortlessly change the PagerDuty incident owner in Port, ensuring incidents are managed by the right team members. #### change-replica-count Learn how to change the replica count in Port, optimizing resource allocation and maintaining system stability. - [Change Deployment Replica Count](/guides/all/change-replica-count.md): Learn how to change the replica count in Port, optimizing resource allocation and maintaining system stability. #### change-status-and-assignee-of-jira-ticket Quickly change the status and assignee of Jira tickets in Port, streamlining your project management process. - [Change status and assignee of Jira ticket](/guides/all/change-status-and-assignee-of-jira-ticket.md): Quickly change the status and assignee of Jira tickets in Port, streamlining your project management process. #### connect-dynatrace-team-with-entities Learn how to map Dynatrace teams to monitored entities in Port - [Assign teams to monitored entities](/guides/all/connect-dynatrace-team-with-entities.md): Learn how to map Dynatrace teams to monitored entities in Port #### connect-github-codeowners-with-service-team-and-user Learn how to connect GitHub Codeowners with repositories, teams and users in Port, ensuring seamless collaboration and code ownership. - [Connect GitHub CODEOWNERS with Repository, Team & User](/guides/all/connect-github-codeowners-with-service-team-and-user.md): Learn how to connect GitHub Codeowners with repositories, teams and users in Port, ensuring seamless collaboration and code ownership. #### connect-github-pr-with-jira-issue Effortlessly connect GitHub PRs with Jira issues in Port, enhancing traceability and improving project workflows. - [Connect GitHub Pull Request with Jira Issue](/guides/all/connect-github-pr-with-jira-issue.md): Effortlessly connect GitHub PRs with Jira issues in Port, enhancing traceability and improving project workflows. #### connect-github-pr-with-sonar-analysis Learn how to connect GitHub PRs with Sonar analysis in Port, ensuring code quality and streamlined review processes. - [Connect GitHub PR to SonarQube analysis](/guides/all/connect-github-pr-with-sonar-analysis.md): Learn how to connect GitHub PRs with Sonar analysis in Port, ensuring code quality and streamlined review processes. #### copy-pipeline-template-to-target-repo Learn how to copy pipeline template from one repository to another using Port Actions. - [Copy Pipeline Template to Target Repo](/guides/all/copy-pipeline-template-to-target-repo.md): Learn how to copy pipeline template from one repository to another using Port Actions. #### create-an-ec2-instance Learn how to create an EC2 instance in Port with this step-by-step guide, enabling scalable cloud infrastructure setup. - [Create an AWS EC2 instance using GitHub Actions](/guides/all/create-an-ec2-instance.md): Learn how to create an EC2 instance in Port with this step-by-step guide, enabling scalable cloud infrastructure setup. #### create-an-ec2-instance-gitlab Follow this guide to create an EC2 instance for GitLab in Port, ensuring a seamless and scalable CI/CD environment. - [Create an AWS EC2 instance using GitLab CI](/guides/all/create-an-ec2-instance-gitlab.md): Follow this guide to create an EC2 instance for GitLab in Port, ensuring a seamless and scalable CI/CD environment. #### create-an-opsgenie-incident Learn how to create an Opsgenie incident in Port with this guide, ensuring rapid response and effective incident management. - [Create Opsgenie Incident](/guides/all/create-an-opsgenie-incident.md): Learn how to create an Opsgenie incident in Port with this guide, ensuring rapid response and effective incident management. #### create-and-track-dora-metrics-in-your-portal Set up DORA metrics tracking with GitHub and PagerDuty. Configure deployment frequency, lead time, CFR, and MTTR dashboards. - [Create & track DORA metrics in your portal](/guides/all/create-and-track-dora-metrics-in-your-portal.md): Set up DORA metrics tracking with GitHub and PagerDuty. Configure deployment frequency, lead time, CFR, and MTTR dashboards. #### create-and-use-surveys-in-your-portal Set up developer experience surveys in Port. Configure questions, collect responses, and visualize feedback insights. - [Create & use surveys in your portal](/guides/all/create-and-use-surveys-in-your-portal.md): Set up developer experience surveys in Port. Configure questions, collect responses, and visualize feedback insights. #### create-azure-devops-work-item Learn how to create an Azure DevOps work item in Port - [Create an Azure DevOps Work Item](/guides/all/create-azure-devops-work-item.md): Learn how to create an Azure DevOps work item in Port #### create-azure-resource Learn how to create Azure resources in Port, enabling efficient cloud management and scalable infrastructure deployment. - [Deploy Azure Resource using Terraform](/guides/all/create-azure-resource.md): Learn how to create Azure resources in Port, enabling efficient cloud management and scalable infrastructure deployment. #### create-azure-resource-ado Follow this guide to create Azure resources for ADO in Port, ensuring seamless integration and cloud management. - [Create Azure Resource with Terraform](/guides/all/create-azure-resource-ado.md): Follow this guide to create Azure resources for ADO in Port, ensuring seamless integration and cloud management. #### create-cloud-resource-using-iac Learn how to create cloud resources using Infrastructure as Code (IaC) in Port for efficient and automated deployments. - [Create cloud resources using IaC](/guides/all/create-cloud-resource-using-iac.md): Learn how to create cloud resources using Infrastructure as Code (IaC) in Port for efficient and automated deployments. #### create-dev-env Learn how to create a development environment in Port, streamlining your workflow for efficient project setup and testing. - [Manage a Developer Environment Lifecycle](/guides/all/create-dev-env.md): Learn how to create a development environment in Port, streamlining your workflow for efficient project setup and testing. #### create-eks-cluster-and-deploy-app Learn how to create an EKS cluster and deploy your application in Port for scalable and efficient cloud infrastructure. - [Create an EKS cluster and deploy a Node.js app](/guides/all/create-eks-cluster-and-deploy-app.md): Learn how to create an EKS cluster and deploy your application in Port for scalable and efficient cloud infrastructure. #### create-github-pull-request Create GitHub pull requests from Port using Jenkins pipelines for automated infrastructure changes - [Create GitHub pull requests from Port](/guides/all/create-github-pull-request.md): Create GitHub pull requests from Port using Jenkins pipelines for automated infrastructure changes #### create-incident-io-incident Learn how to create an incident.io incident in Port, ensuring timely resolution and effective incident management. - [Create an incident.io Incident](/guides/all/create-incident-io-incident.md): Learn how to create an incident.io incident in Port, ensuring timely resolution and effective incident management. #### create-jira-issue-from-datadog-alert Automatically create Jira issues from monitoring and security alerts in Port using an alert-triggered automation and a Jira webhook. Uses Datadog as the example; swap the source blueprint for Dependabot, New Relic, Snyk, and other tools. - [Create a Jira issue from a monitoring alert](/guides/all/create-jira-issue-from-datadog-alert.md): Automatically create Jira issues from monitoring and security alerts in Port using an alert-triggered automation and a Jira webhook. Uses Datadog as the example; swap the source blueprint for Dependabot, New Relic, Snyk, and other tools. #### create-jira-issue-gitlab Create a self-service action in Port that opens a Jira issue using a GitLab CI pipeline, allowing developers to report bugs or create tickets without leaving Port. - [Create a Jira issue using GitLab CI](/guides/all/create-jira-issue-gitlab.md): Create a self-service action in Port that opens a Jira issue using a GitLab CI pipeline, allowing developers to report bugs or create tickets without leaving Port. #### create-k8s-namespace Follow this guide to create a Kubernetes namespace in Port, enabling organized and efficient resource management. - [Create a Kubernetes namespace](/guides/all/create-k8s-namespace.md): Follow this guide to create a Kubernetes namespace in Port, enabling organized and efficient resource management. #### create-new-aws-account-gitlab Learn how to automate AWS account creation through Port using GitLab CI/CD, enabling streamlined cloud infrastructure provisioning with self-service actions. - [Automate AWS Account Creation with GitLab](/guides/all/create-new-aws-account-gitlab.md): Learn how to automate AWS account creation through Port using GitLab CI/CD, enabling streamlined cloud infrastructure provisioning with self-service actions. #### create-organizational-hierarchy-views Learn how to model and visualize hierarchy tiers in your organization. - [Create organizational hierarchy views](/guides/all/create-organizational-hierarchy-views.md): Learn how to model and visualize hierarchy tiers in your organization. #### create-pagerduty-incident-from-newrelic-alert Learn how to trigger a PagerDuty incident from New Relic alert in Port with this guide, ensuring prompt and effective incident management. - [Create a PagerDuty incident from a New Relic alert](/guides/all/create-pagerduty-incident-from-newrelic-alert.md): Learn how to trigger a PagerDuty incident from New Relic alert in Port with this guide, ensuring prompt and effective incident management. #### create-pagerduty-service Follow this guide to create a PagerDuty service in Port, ensuring efficient incident management and response. - [Create a PagerDuty Service](/guides/all/create-pagerduty-service.md): Follow this guide to create a PagerDuty service in Port, ensuring efficient incident management and response. #### create-roi-dashboard Create a dashboard that tracks the ROI of actions in Port - [Create an actions ROI dashboard](/guides/all/create-roi-dashboard.md): Create a dashboard that tracks the ROI of actions in Port #### create-slack-channel-for-reported-incident Learn how to automatically create a Slack channel and GitHub issue when a PagerDuty incident is reported, enabling real-time team communication and incident documentation. - [Auto-create Slack channel & GitHub issue for PagerDuty incidents](/guides/all/create-slack-channel-for-reported-incident.md): Learn how to automatically create a Slack channel and GitHub issue when a PagerDuty incident is reported, enabling real-time team communication and incident documentation. #### deploy-azure-resource Follow this guide to deploy Azure resources in Port, ensuring efficient cloud management and streamlined operations. - [Deploy resource in Azure Cloud with Terraform](/guides/all/deploy-azure-resource.md): Follow this guide to deploy Azure resources in Port, ensuring efficient cloud management and streamlined operations. #### deploy-cloudformation-template Learn how to deploy CloudFormation templates in Port, enabling automated and efficient cloud resource management. - [Deploy AWS resources using AWS CloudFormation](/guides/all/deploy-cloudformation-template.md): Learn how to deploy CloudFormation templates in Port, enabling automated and efficient cloud resource management. #### deploy-s3-bucket-crossplane Learn how to deploy an S3 bucket using Crossplane in Port, enabling flexible and efficient cloud resource management. - [Deploy S3 Bucket using Crossplane](/guides/all/deploy-s3-bucket-crossplane.md): Learn how to deploy an S3 bucket using Crossplane in Port, enabling flexible and efficient cloud resource management. #### deploy-service-using-aws-codedeploy Learn how to trigger an AWS CodeDeploy application in Port. - [Deploy a service using AWS CodeDeploy](/guides/all/deploy-service-using-aws-codedeploy.md): Learn how to trigger an AWS CodeDeploy application in Port. #### eks-as-a-service-action Learn how to manage EKS as a service in Port, ensuring efficient orchestration and scalable Kubernetes deployments. - [EKS as a service action (EKSaaS)](/guides/all/eks-as-a-service-action.md): Learn how to manage EKS as a service in Port, ensuring efficient orchestration and scalable Kubernetes deployments. #### enforce-ai-coding-security-standards Learn how to enforce AI coding security standards by checking for comprehensive Cursor security rules and GitHub Copilot instructions using Port scorecards and GitHub integration. - [Enforce AI coding security standards](/guides/all/enforce-ai-coding-security-standards.md): Learn how to enforce AI coding security standards by checking for comprehensive Cursor security rules and GitHub Copilot instructions using Port scorecards and GitHub integration. #### enrich-tasks-with-ai Enrich tasks with AI-powered context, providing developers with automated insights, related issues, and potential collaborators. - [Enrich tasks with AI-powered context](/guides/all/enrich-tasks-with-ai.md): Enrich tasks with AI-powered context, providing developers with automated insights, related issues, and potential collaborators. #### ensure-production-readiness Follow this guide to ensure production readiness in Port, optimizing your deployments for reliability and performance. - [Ensure production readiness](/guides/all/ensure-production-readiness.md): Follow this guide to ensure production readiness in Port, optimizing your deployments for reliability and performance. #### escalate-an-incident Learn how to escalate an incident in Port, ensuring timely resolution and effective incident management. - [Escalate an Incident in PagerDuty](/guides/all/escalate-an-incident.md): Learn how to escalate an incident in Port, ensuring timely resolution and effective incident management. #### find-internal-documentation-with-ai Learn how to find internal documentation with AI - [Find internal documentation with AI](/guides/all/find-internal-documentation-with-ai.md): Learn how to find internal documentation with AI #### generate-incident-updates-with-ai Learn how to leverage Port's AI capabilities to enhance incident management with contextual incident updates and automated Slack notifications. - [Generate incident updates with AI](/guides/all/generate-incident-updates-with-ai.md): Learn how to leverage Port's AI capabilities to enhance incident management with contextual incident updates and automated Slack notifications. #### generate-incident-updates-with-n8n-and-port Use Port as a context lake in n8n workflows to automatically generate contextual incident updates and send enriched Slack notifications - [Generate incident updates with n8n and Port](/guides/all/generate-incident-updates-with-n8n-and-port.md): Use Port as a context lake in n8n workflows to automatically generate contextual incident updates and send enriched Slack notifications #### generate-zendesk-ticket-summaries-with-ai Summarize Zendesk tickets with AI using a reusable Port MCP prompt (backed by self-service actions). Requires Port remote MCP installed and connected in your IDE. No AI agents or automations required. - [Summarize Zendesk tickets with AI](/guides/all/generate-zendesk-ticket-summaries-with-ai.md): Summarize Zendesk tickets with AI using a reusable Port MCP prompt (backed by self-service actions). Requires Port remote MCP installed and connected in your IDE. No AI agents or automations required. #### heal-unhealthy-k8s-pods Learn how to use Port's AI capabilities to detect unhealthy Kubernetes pods and automatically trigger remediation actions to restore service health. - [Auto-heal unhealthy kubernetes pods](/guides/all/heal-unhealthy-k8s-pods.md): Learn how to use Port's AI capabilities to detect unhealthy Kubernetes pods and automatically trigger remediation actions to restore service health. #### ignore-snyk-vulnerability Learn how to ignore a synk vulnerability - [Ignore Snyk Vulnerability](/guides/all/ignore-snyk-vulnerability.md): Learn how to ignore a synk vulnerability #### implement-rbac-for-ai-agents-with-n8n-and-port Learn how to implement role-based access control (RBAC) for multi-agent systems using Port and n8n, enabling dynamic tool access control for AI agents based on user roles and permissions. - [RBAC for AI agents with n8n and Port](/guides/all/implement-rbac-for-ai-agents-with-n8n-and-port.md): Learn how to implement role-based access control (RBAC) for multi-agent systems using Port and n8n, enabling dynamic tool access control for AI agents based on user roles and permissions. #### import-and-manage-integration Learn how to import and manage integrations in Port, streamlining your workflows and enhancing system connectivity. - [Manage integration mapping using Terraform](/guides/all/import-and-manage-integration.md): Learn how to import and manage integrations in Port, streamlining your workflows and enhancing system connectivity. #### incident-blueprint Learn how to implement the incident blueprint pattern for self-healing incident workflows - [Implement the incident blueprint pattern](/guides/all/incident-blueprint.md): Learn how to implement the incident blueprint pattern for self-healing incident workflows #### ingest-checkmarx-kics-scan-into-your-catalog Ingests Checkmarx KICS scan results in your Checkmarx KICS file using Port's GitHub file ingesting feature. - [Ingest Checkmarx KICS scan into your catalog](/guides/all/ingest-checkmarx-kics-scan-into-your-catalog.md): Ingests Checkmarx KICS scan results in your Checkmarx KICS file using Port's GitHub file ingesting feature. #### ingest-claude-code-security-reviews Ingest Claude Code security review findings and visualize them in Port dashboards. - [Ingest Claude Code security reviews](/guides/all/ingest-claude-code-security-reviews.md): Ingest Claude Code security review findings and visualize them in Port dashboards. #### ingest-cloud-resources-using-datadog Learn how to ingest cloud resources using Datadog in Port, enhancing visibility and performance monitoring. - [Ingest cloud resources with Datadog](/guides/all/ingest-cloud-resources-using-datadog.md): Learn how to ingest cloud resources using Datadog in Port, enhancing visibility and performance monitoring. #### ingest-cloud-resources-using-dynatrace Learn how to ingest cloud resources using Dynatrace in Port, enhancing visibility and performance monitoring. - [Ingest cloud resources with Dynatrace](/guides/all/ingest-cloud-resources-using-dynatrace.md): Learn how to ingest cloud resources using Dynatrace in Port, enhancing visibility and performance monitoring. #### ingest-cloud-resources-using-newrelic Learn how to ingest cloud resources using New Relic in Port, enhancing visibility and performance monitoring. - [Ingest Cloud Resources with New Relic](/guides/all/ingest-cloud-resources-using-newrelic.md): Learn how to ingest cloud resources using New Relic in Port, enhancing visibility and performance monitoring. #### ingest-dependencies-from-package-json-to-service Parse package.json files from repositories and create dependency entities related to services in your software catalog. - [Ingest dependencies from a package.json file and relate them to a service](/guides/all/ingest-dependencies-from-package-json-to-service.md): Parse package.json files from repositories and create dependency entities related to services in your software catalog. #### ingest-dotnet-framework-versions Ingest .NET framework versions from .csproj files and track them across your repositories using Port - [Ingest .NET framework versions from repositories](/guides/all/ingest-dotnet-framework-versions.md): Ingest .NET framework versions from .csproj files and track them across your repositories using Port #### ingest-gitlab-vulnerabilities-into-your-catalog Ingest GitLab security vulnerabilities into Port using the Ocean Custom Integration, enabling centralized visibility into SAST, DAST, dependency scanning, and container scanning findings per team and service. - [Ingest GitLab security vulnerabilities into Port](/guides/all/ingest-gitlab-vulnerabilities-into-your-catalog.md): Ingest GitLab security vulnerabilities into Port using the Ocean Custom Integration, enabling centralized visibility into SAST, DAST, dependency scanning, and container scanning findings per team and service. #### ingest-javascript-packages-into-your-catalog Ingests all Javascript packages in `package.json` file using Port's GitHub file ingesting feature. - [Ingest Javascript packages into your catalog](/guides/all/ingest-javascript-packages-into-your-catalog.md): Ingests all Javascript packages in `package.json` file using Port's GitHub file ingesting feature. #### ingest-linearb-metrics-into-your-catalog Consolidate LinearB engineering metrics into Port's Engineering Intelligence platform, leveraging Port's native analytics alongside imported data for a unified view of engineering performance. - [Ingest LinearB metrics into Port](/guides/all/ingest-linearb-metrics-into-your-catalog.md): Consolidate LinearB engineering metrics into Port's Engineering Intelligence platform, leveraging Port's native analytics alongside imported data for a unified view of engineering performance. #### ingest-prompts-skills-from-github-using-gitops Learn how to ingest AI prompts and skills from GitHub using GitOps by mapping repo files to Port blueprints. - [Ingest prompts and skills from GitHub using GitOps](/guides/all/ingest-prompts-skills-from-github-using-gitops.md): Learn how to ingest AI prompts and skills from GitHub using GitOps by mapping repo files to Port blueprints. #### ingest-security-issues-from-sarif-files-to-services Ingest security scan results from SARIF files into Port and relate them to service entities in your catalog. - [Ingest security issues from .sarif files and relate them to services](/guides/all/ingest-security-issues-from-sarif-files-to-services.md): Ingest security scan results from SARIF files into Port and relate them to service entities in your catalog. #### ingest-slack-data-via-airbyte-s3-and-webhook Ingest Slack channels and membership data into Port using Airbyte to extract, S3 as intermediate storage, and webhook integration to load. - [Ingest Slack channels data into Port via Airbyte, S3 and webhook](/guides/all/ingest-slack-data-via-airbyte-s3-and-webhook.md): Ingest Slack channels and membership data into Port using Airbyte to extract, S3 as intermediate storage, and webhook integration to load. #### ingest-software-bill-of-materials-sbom-into-your-catalog Ingests software bill of material (SBOM) in your `SBOM.json` or `SBOM.xml` file using Port's GitHub file ingesting feature - [Ingest software bill of material (SBOM) into your catalog](/guides/all/ingest-software-bill-of-materials-sbom-into-your-catalog.md): Ingests software bill of material (SBOM) in your `SBOM.json` or `SBOM.xml` file using Port's GitHub file ingesting feature #### ingest-swagger-paths-into-your-catalog Ingest API paths from an OpenAPI spec in a GitHub repository into Port - [Ingest API paths from an OpenAPI spec in a GitHub repository into Port](/guides/all/ingest-swagger-paths-into-your-catalog.md): Ingest API paths from an OpenAPI spec in a GitHub repository into Port #### ingest-swarmia-metrics-into-your-catalog Consolidate Swarmia DORA and pull request metrics into Port's Engineering Intelligence platform, leveraging Port's native analytics alongside imported data for a unified view of engineering performance. - [Ingest Swarmia metrics into Port](/guides/all/ingest-swarmia-metrics-into-your-catalog.md): Consolidate Swarmia DORA and pull request metrics into Port's Engineering Intelligence platform, leveraging Port's native analytics alongside imported data for a unified view of engineering performance. #### ingest-trivy-vulnerabilities-into-your-catalog Ingests Trivy vulnerabilities in your Trivy scan results file using Port's GitHub file ingesting feature. - [Ingest Trivy vulnerabilities into your catalog](/guides/all/ingest-trivy-vulnerabilities-into-your-catalog.md): Ingests Trivy vulnerabilities in your Trivy scan results file using Port's GitHub file ingesting feature. #### ingest-vulnerability-alerts-from-orca-security-using-a-custom-webhook-integration Ingest vulnerability alerts from Orca Security using a custom webhook integration - [Ingest vulnerability alerts from Orca Security](/guides/all/ingest-vulnerability-alerts-from-orca-security-using-a-custom-webhook-integration.md): Ingest vulnerability alerts from Orca Security using a custom webhook integration #### interact-with-pagerduty-incidents Learn how to create or trigger PagerDuty incidents from Port using synced webhooks or GitHub workflows, and keep your catalog in sync. - [Interact with PagerDuty incidents](/guides/all/interact-with-pagerduty-incidents.md): Learn how to create or trigger PagerDuty incidents from Port using synced webhooks or GitHub workflows, and keep your catalog in sync. #### interact-with-servicenow Learn how to interact with ServiceNow records and delete ServiceNow incidents using Port's self-service actions - [Interact with ServiceNow records](/guides/all/interact-with-servicenow.md): Learn how to interact with ServiceNow records and delete ServiceNow incidents using Port's self-service actions #### keep-azure-catalog-upto-date-with-incremental-syncing Learn how to keep your Azure catalog up to date by syncing only changed resources into Port using GitHub Actions or a local script. - [Keep your Azure catalog up to date with incremental syncing](/guides/all/keep-azure-catalog-upto-date-with-incremental-syncing.md): Learn how to keep your Azure catalog up to date by syncing only changed resources into Port using GitHub Actions or a local script. #### let-developers-enrich-services-using-gitops Learn how developers can enrich repositories using GitOps in Port, enabling efficient and automated service management. - [Enrich services using GitOps](/guides/all/let-developers-enrich-services-using-gitops.md): Learn how developers can enrich repositories using GitOps in Port, enabling efficient and automated service management. #### lock-and-unlock-services-in-port Learn how to implement comprehensive service locking in Port with self-service actions and automated deployment checks in GitHub workflows. - [Lock and unlock services](/guides/all/lock-and-unlock-services-in-port.md): Learn how to implement comprehensive service locking in Port with self-service actions and automated deployment checks in GitHub workflows. #### manage-ai-instructions Learn how to centralize AI instructions in Port and automatically sync them to GitHub repositories, ensuring consistency and governance across your development teams. - [Manage AI Instructions with Port](/guides/all/manage-ai-instructions.md): Learn how to centralize AI instructions in Port and automatically sync them to GitHub repositories, ensuring consistency and governance across your development teams. #### manage-and-surface-technical-docs Learn how to manage and surface technical documentation in Port by ingesting markdown from a Git source, displaying it on service or repository pages, and optionally adding the TechDocs plugin. - [Manage and surface technical documentation in Port](/guides/all/manage-and-surface-technical-docs.md): Learn how to manage and surface technical documentation in Port by ingesting markdown from a Git source, displaying it on service or repository pages, and optionally adding the TechDocs plugin. #### manage-and-visualize-acm-certificates Learn how to monitor and manage your AWS ACM certificates using self-service actions in Port. - [Manage and visualize your ACM certificates](/guides/all/manage-and-visualize-acm-certificates.md): Learn how to monitor and manage your AWS ACM certificates using self-service actions in Port. #### manage-and-visualize-aws-autoscaling-groups Learn how to manage your AWS Auto Scaling Groups using self-service actions in Port. - [Manage your AWS Auto Scaling Groups](/guides/all/manage-and-visualize-aws-autoscaling-groups.md): Learn how to manage your AWS Auto Scaling Groups using self-service actions in Port. #### manage-and-visualize-aws-sqs-queues Learn how to monitor and manage your AWS SQS queues using dashboards and self-service actions in Port. - [Manage and visualize your AWS SQS queues](/guides/all/manage-and-visualize-aws-sqs-queues.md): Learn how to monitor and manage your AWS SQS queues using dashboards and self-service actions in Port. #### manage-and-visualize-azure-virtual-machines Learn how to monitor and manage your Azure Virtual Machines using self-service actions in Port. - [Manage your Azure Virtual Machines](/guides/all/manage-and-visualize-azure-virtual-machines.md): Learn how to monitor and manage your Azure Virtual Machines using self-service actions in Port. #### manage-and-visualize-azure-web-apps Learn how to monitor and manage your Azure web apps using self-service actions in Port. - [Manage and visualize your Azure web apps](/guides/all/manage-and-visualize-azure-web-apps.md): Learn how to monitor and manage your Azure web apps using self-service actions in Port. #### manage-and-visualize-ecs-tasks Learn how to monitor and manage your AWS ECS tasks and services using dashboards and self-service actions in Port. - [Manage and visualize your ECS tasks](/guides/all/manage-and-visualize-ecs-tasks.md): Learn how to monitor and manage your AWS ECS tasks and services using dashboards and self-service actions in Port. #### manage-and-visualize-gcp-compute-engine-instances Learn how to monitor and manage your GCP Compute Engine instances using dashboards and self-service actions in Port. - [Manage and visualize your GCP Compute Engine instances](/guides/all/manage-and-visualize-gcp-compute-engine-instances.md): Learn how to monitor and manage your GCP Compute Engine instances using dashboards and self-service actions in Port. #### manage-and-visualize-jira-issues Learn how to monitor and manage your Jira issues using dashboards and self-service actions in Port. - [Manage and visualize your Jira issues](/guides/all/manage-and-visualize-jira-issues.md): Learn how to monitor and manage your Jira issues using dashboards and self-service actions in Port. #### manage-and-visualize-pagerduty-incidents Learn how to manage your PagerDuty incidents with self-service actions and monitor them using dashboards in Port. - [Manage and visualize your PagerDuty incidents](/guides/all/manage-and-visualize-pagerduty-incidents.md): Learn how to manage your PagerDuty incidents with self-service actions and monitor them using dashboards in Port. #### manage-and-visualize-your-launchdarkly-feature-flags Learn how to manage and visualize your LaunchDarkly feature flags using dashboards and self-service actions in Port. - [Manage and visualize your LaunchDarkly feature flags](/guides/all/manage-and-visualize-your-launchdarkly-feature-flags.md): Learn how to manage and visualize your LaunchDarkly feature flags using dashboards and self-service actions in Port. #### manage-clusters Master the management of clusters in Port with this guide, ensuring efficient and scalable infrastructure operations. - [Create and manage Kubernetes clusters](/guides/all/manage-clusters.md): Master the management of clusters in Port with this guide, ensuring efficient and scalable infrastructure operations. #### manage-ec2-instances Learn how to manage EC2 instances in Port, ensuring optimal performance and efficient cloud resource management. - [Manage An AWS EC2 Instance](/guides/all/manage-ec2-instances.md): Learn how to manage EC2 instances in Port, ensuring optimal performance and efficient cloud resource management. #### manage-firehydrant-incidents Learn how to create or trigger FireHydrant incidents from Port using synced webhooks or GitHub workflows, and keep your catalog in sync. - [Manage FireHydrant incidents](/guides/all/manage-firehydrant-incidents.md): Learn how to create or trigger FireHydrant incidents from Port using synced webhooks or GitHub workflows, and keep your catalog in sync. #### manage-kubernetes-namespaces Learn how to manage Kubernetes namespaces through Port with automated workflows, approval processes, and chained self-service actions. - [Manage Kubernetes namespaces](/guides/all/manage-kubernetes-namespaces.md): Learn how to manage Kubernetes namespaces through Port with automated workflows, approval processes, and chained self-service actions. #### manage-mcp-registry Learn how to build and manage a centralized MCP server registry in Port for governance, discovery, and team collaboration - [Manage MCP Server Registry](/guides/all/manage-mcp-registry.md): Learn how to build and manage a centralized MCP server registry in Port for governance, discovery, and team collaboration #### manage-pagerduty-on-call-schedules Learn how to manage and track PagerDuty on-call schedules across teams and services with dashboards and self-service actions. - [Manage PagerDuty on-call schedules](/guides/all/manage-pagerduty-on-call-schedules.md): Learn how to manage and track PagerDuty on-call schedules across teams and services with dashboards and self-service actions. #### manage-pull-requests Learn how to effectively manage pull requests in Port, streamlining code reviews and collaboration processes. - [Manage GitHub Pull Requests](/guides/all/manage-pull-requests.md): Learn how to effectively manage pull requests in Port, streamlining code reviews and collaboration processes. #### manage-resources-using-k8s-crds Learn how to manage resources using Kubernetes CRDs in Port, enabling customized and efficient resource handling. - [Manage resources using Kubernetes CRDs](/guides/all/manage-resources-using-k8s-crds.md): Learn how to manage resources using Kubernetes CRDs in Port, enabling customized and efficient resource handling. #### manage-your-eks-clusters Learn how to manage your AWS EKS clusters using self-service actions in Port. - [Manage your EKS clusters](/guides/all/manage-your-eks-clusters.md): Learn how to manage your AWS EKS clusters using self-service actions in Port. #### manage-your-kubernetes-deployment Learn how to monitor and manage your Kubernetes deployments and pods using self-service actions in Port. - [Manage your Kubernetes deployments](/guides/all/manage-your-kubernetes-deployment.md): Learn how to monitor and manage your Kubernetes deployments and pods using self-service actions in Port. #### map-git-users-to-port-accounts Automatically map GitHub, GitLab, and Azure DevOps users to their Port user accounts for seamless integration - [Map Git users to Port user accounts](/guides/all/map-git-users-to-port-accounts.md): Automatically map GitHub, GitLab, and Azure DevOps users to their Port user accounts for seamless integration #### map-hibob-users-to-port-accounts Ingest and map HiBob users to their Port user accounts for seamless integration - [Ingest and map HiBob users to Port user accounts](/guides/all/map-hibob-users-to-port-accounts.md): Ingest and map HiBob users to their Port user accounts for seamless integration #### map-jira-users-to-port-accounts Automatically map Jira users to their Port user accounts for seamless integration - [Map Jira users to Port user accounts](/guides/all/map-jira-users-to-port-accounts.md): Automatically map Jira users to their Port user accounts for seamless integration #### map-prs-to-services-in-monorepo Automatically map pull requests to services in a monorepo using file path analysis - [Map PRs to services in a monorepo](/guides/all/map-prs-to-services-in-monorepo.md): Automatically map pull requests to services in a monorepo using file path analysis #### map-servicenow-users-to-port-accounts Ingest and map ServiceNow users to their Port user accounts for seamless integration - [Ingest and map ServiceNow users to Port user accounts](/guides/all/map-servicenow-users-to-port-accounts.md): Ingest and map ServiceNow users to their Port user accounts for seamless integration #### map-slack-users-to-port-accounts Ingest and map Slack users to their Port user accounts for seamless integration - [Ingest and map Slack users to Port user accounts](/guides/all/map-slack-users-to-port-accounts.md): Ingest and map Slack users to their Port user accounts for seamless integration #### measure-ai-feedback Learn how to collect and analyze feedback on AI tools using Port actions, automations, and AI agents to measure effectiveness and guide adoption decisions. - [Measure AI feedback](/guides/all/measure-ai-feedback.md): Learn how to collect and analyze feedback on AI tools using Port actions, automations, and AI agents to measure effectiveness and guide adoption decisions. #### measure-and-track-delivery-performance Learn how to measure and track delivery performance as part of your engineering intelligence framework using key metrics like PR cycle time, PR throughput, deployment frequency, and overdue PRs. - [Gain visibility into delivery performance](/guides/all/measure-and-track-delivery-performance.md): Learn how to measure and track delivery performance as part of your engineering intelligence framework using key metrics like PR cycle time, PR throughput, deployment frequency, and overdue PRs. #### measure-pipeline-reliability Learn how to measure CI/CD pipeline reliability at service and team level, including failure rates, failure trends, and failing pipeline identification, using Port's integrations and dashboards. - [Measure pipeline reliability](/guides/all/measure-pipeline-reliability.md): Learn how to measure CI/CD pipeline reliability at service and team level, including failure rates, failure trends, and failing pipeline identification, using Port's integrations and dashboards. #### measure-pr-delivery-metrics Learn how to measure PR and MR delivery metrics at service and team level, including cycle time, throughput, stale PRs/MRs, and reviewer coverage, using Port's GitHub Ocean or GitLab integration and dashboards. - [Measure PR delivery metrics](/guides/all/measure-pr-delivery-metrics.md): Learn how to measure PR and MR delivery metrics at service and team level, including cycle time, throughput, stale PRs/MRs, and reviewer coverage, using Port's GitHub Ocean or GitLab integration and dashboards. #### measure-pull-request-standards Implement working agreements and measure pull request standards using Port scorecards and aggregation properties, tracking team performance based on PR metrics like review time, approval count, and merge latency. - [Measuring pull request standards](/guides/all/measure-pull-request-standards.md): Implement working agreements and measure pull request standards using Port scorecards and aggregation properties, tracking team performance based on PR metrics like review time, approval count, and merge latency. #### measure-reliability-and-stability Learn how to measure reliability and stability of your delivery pipeline by tracking workflow failure rates and PRs blocked by failing CI/CD using Port's GitHub integration. - [Measure delivery reliability and stability](/guides/all/measure-reliability-and-stability.md): Learn how to measure reliability and stability of your delivery pipeline by tracking workflow failure rates and PRs blocked by failing CI/CD using Port's GitHub integration. #### measure-sprint-health-with-jira Learn how to measure and visualize sprint health at the team level using Jira sprint data, aggregation properties, dashboards, and scorecards in Port. - [Measure sprint health with Jira](/guides/all/measure-sprint-health-with-jira.md): Learn how to measure and visualize sprint health at the team level using Jira sprint data, aggregation properties, dashboards, and scorecards in Port. #### measure-standards Learn how to measure standards compliance across your software delivery, tracking quality, security, and organizational alignment using Port's GitHub integration and scorecards. - [Track standards adherence](/guides/all/measure-standards.md): Learn how to measure standards compliance across your software delivery, tracking quality, security, and organizational alignment using Port's GitHub integration and scorecards. #### migrate-project-from-bibucket-to-github Migrate repositories from Bitbucket to GitHub using Port self-service actions and GitHub Actions - [Migrate repositories from Bitbucket to GitHub using Port self-service actions](/guides/all/migrate-project-from-bibucket-to-github.md): Migrate repositories from Bitbucket to GitHub using Port self-service actions and GitHub Actions #### migrate-project-from-github-to-gitlab Migrate repositories from GitHub to GitLab using Port self-service actions and GitHub Actions - [Migrate repositories from GitHub to GitLab using Port self-service actions](/guides/all/migrate-project-from-github-to-gitlab.md): Migrate repositories from GitHub to GitLab using Port self-service actions and GitHub Actions #### monitor-integrations Learn how to monitor and manage your Port Ocean integrations for improved visibility and performance tracking. - [Monitor integrations](/guides/all/monitor-integrations.md): Learn how to monitor and manage your Port Ocean integrations for improved visibility and performance tracking. #### move-port-configurations-between-environments-with-port-ai-and-github-mcp Back up Port blueprints and actions to GitHub from one environment and import them into another environment using Port AI and GitHub MCP. - [Sync Port configurations between environments using Port AI and MCP](/guides/all/move-port-configurations-between-environments-with-port-ai-and-github-mcp.md): Back up Port blueprints and actions to GitHub from one environment and import them into another environment using Port AI and GitHub MCP. #### notify-users-upon-approval-of-action Learn how to automatically notify users in Slack when their self-service actions in Port are approved or declined - [Notify users upon approval of self-service actions](/guides/all/notify-users-upon-approval-of-action.md): Learn how to automatically notify users in Slack when their self-service actions in Port are approved or declined #### nudge-pr-reviewers Learn how to nudge PR reviewers in Port, ensuring timely code reviews and efficient project progression. - [Nudge Pull Request Reviewers](/guides/all/nudge-pr-reviewers.md): Learn how to nudge PR reviewers in Port, ensuring timely code reviews and efficient project progression. #### onboard-developers-from-internal-docs-using-port-mcp Set up onboarding guidance in Port and Cursor using Port MCP, a connected Notion MCP connector, and a custom onboarding skill. - [Onboard developers using internal docs and Port MCP](/guides/all/onboard-developers-from-internal-docs-using-port-mcp.md): Set up onboarding guidance in Port and Cursor using Port MCP, a connected Notion MCP connector, and a custom onboarding skill. #### open-github-issue Learn how to create a GitHub issue in Port, streamlining issue categorization and tracking. - [Create a GitHub issue](/guides/all/open-github-issue.md): Learn how to create a GitHub issue in Port, streamlining issue categorization and tracking. #### open-jira-issue-with-automatic-label Learn how to open Jira issues with automatic labels in Port, streamlining issue categorization and tracking. - [Open Jira issue with automatic label](/guides/all/open-jira-issue-with-automatic-label.md): Learn how to open Jira issues with automatic labels in Port, streamlining issue categorization and tracking. #### open-linear-issue Learn how to create a Linear issue in Port, streamlining issue categorization and tracking. - [Create a Linear issue](/guides/all/open-linear-issue.md): Learn how to create a Linear issue in Port, streamlining issue categorization and tracking. #### open-slack-channel Learn how to open a Slack channel in Port, enhancing team collaboration and communication with this easy guide. - [Create Slack channel for Incident Management](/guides/all/open-slack-channel.md): Learn how to open a Slack channel in Port, enhancing team collaboration and communication with this easy guide. #### orchestrate-incident-response-with-ai Learn how to implement an AI-powered incident response system that automatically orchestrates Slack channels, Zoom meetings, Jira tickets, and team notifications when incidents occur. - [Orchestrate incident response with AI](/guides/all/orchestrate-incident-response-with-ai.md): Learn how to implement an AI-powered incident response system that automatically orchestrates Slack channels, Zoom meetings, Jira tickets, and team notifications when incidents occur. #### owasp-top-10-scorecard Build an OWASP Top 10 security scorecard in Port using vulnerability data from Snyk. - [Build an OWASP Top 10 Scorecard](/guides/all/owasp-top-10-scorecard.md): Build an OWASP Top 10 security scorecard in Port using vulnerability data from Snyk. #### promote-to-production Create a self-service action that promotes a staging image to production using a GitHub Actions workflow and GitOps pull requests. For the Port Workflows (beta) approach, see the "Promote to production workflow" guide. - [Promote a deployment to production using GitHub Actions](/guides/all/promote-to-production.md): Create a self-service action that promotes a staging image to production using a GitHub Actions workflow and GitOps pull requests. For the Port Workflows (beta) approach, see the "Promote to production workflow" guide. #### promote-to-production-workflow Build a "Promote to production" flow using Port Workflows (beta) and Port AI, with safety checks, deployment tracking, automated PagerDuty incident creation, and team notifications. For the GitHub Actions self-service action approach, see the "Promote a deployment to production using GitHub Actions" guide. - [Promote to production workflow](/guides/all/promote-to-production-workflow.md): Build a "Promote to production" flow using Port Workflows (beta) and Port AI, with safety checks, deployment tracking, automated PagerDuty incident creation, and team notifications. For the GitHub Actions self-service action approach, see the "Promote a deployment to production using GitHub Actions" guide. #### pull-github-metrics-and-build-visualizations Learn how to pull GitHub metrics data and build comprehensive visualizations in Port to track engineering performance. - [Pull GitHub metrics and build visualizations](/guides/all/pull-github-metrics-and-build-visualizations.md): Learn how to pull GitHub metrics data and build comprehensive visualizations in Port to track engineering performance. #### push-image-to-ecr Learn how to push images to ECR in Port, ensuring efficient container management and streamlined deployments. - [Build ECR image](/guides/all/push-image-to-ecr.md): Learn how to push images to ECR in Port, ensuring efficient container management and streamlined deployments. #### query-dora-metrics-using-port-mcp Learn how to query DORA metrics using Port's MCP server with natural language commands in your IDE, enabling data-driven engineering insights without leaving your development environment. - [Query DORA metrics using Port MCP](/guides/all/query-dora-metrics-using-port-mcp.md): Learn how to query DORA metrics using Port's MCP server with natural language commands in your IDE, enabling data-driven engineering insights without leaving your development environment. #### remediate-ci-cd-failures-with-port-cursor-workflow Automatically remediate failed CI workflow runs by orchestrating Port, Cursor automations, and Slack notifications. - [Remediate CI/CD failures with Port AI & Cursor](/guides/all/remediate-ci-cd-failures-with-port-cursor-workflow.md): Automatically remediate failed CI workflow runs by orchestrating Port, Cursor automations, and Slack notifications. #### remediate-vulnerability-with-ai Use Port AI agents with Claude Code to enrich security vulnerabilities and trigger automated fixes - [Remediate vulnerabilities with AI](/guides/all/remediate-vulnerability-with-ai.md): Use Port AI agents with Claude Code to enrich security vulnerabilities and trigger automated fixes #### remediate-vulnerability-with-n8n-and-port Use Port as a context lake for n8n workflows to enrich vulnerability management with service metadata, ownership, and dependencies - [Remediate security vulnerability with n8n and Port AI](/guides/all/remediate-vulnerability-with-n8n-and-port.md): Use Port as a context lake for n8n workflows to enrich vulnerability management with service metadata, ownership, and dependencies #### resolve-incident Learn how to resolve incidents in Port, ensuring quick and effective issue management for seamless operations. - [Resolve an Incident in PagerDuty](/guides/all/resolve-incident.md): Learn how to resolve incidents in Port, ensuring quick and effective issue management for seamless operations. #### restart-argocd-app Learn how to restart an ArgoCD app in Port, ensuring smooth application operations and minimal downtime. - [Restart Argo CD Application](/guides/all/restart-argocd-app.md): Learn how to restart an ArgoCD app in Port, ensuring smooth application operations and minimal downtime. #### rollback-argocd-deployment Create a self-service action in Port that rolls back an ArgoCD deployment using a GitHub Actions workflow, with manual approval for production environments. - [Roll back an ArgoCD deployment via GitHub Actions](/guides/all/rollback-argocd-deployment.md): Create a self-service action in Port that rolls back an ArgoCD deployment using a GitHub Actions workflow, with manual approval for production environments. #### route-scorecard-failures-to-jira-issues Turn failing scorecard rules into routed Jira issues with Port automations and AI agents. - [Route scorecard failures to Jira issues with AI](/guides/all/route-scorecard-failures-to-jira-issues.md): Turn failing scorecard rules into routed Jira issues with Port automations and AI agents. #### s3-bucket Learn how to manage S3 buckets in Port, ensuring efficient cloud storage organization and access management. - [Manage an S3 Bucket Lifecycle](/guides/all/s3-bucket.md): Learn how to manage S3 buckets in Port, ensuring efficient cloud storage organization and access management. #### s3-using-webhook Learn how to manage S3 buckets using webhooks in Port, enabling automated and efficient cloud operations. - [Create an S3 bucket using Self-Service Actions](/guides/all/s3-using-webhook.md): Learn how to manage S3 buckets using webhooks in Port, enabling automated and efficient cloud operations. #### scaffold-a-new-service Learn how to scaffold a new service in Port with this guide, ensuring efficient setup and streamlined development. - [Scaffold a new service](/guides/all/scaffold-a-new-service.md): Learn how to scaffold a new service in Port with this guide, ensuring efficient setup and streamlined development. #### self-heal-scorecards-with-ai Learn how to use Port's AI capabilities to detect scorecard degradation and automatically use a coding agent like GitHub Copilot to fix it. - [Auto-fix services when scorecards degrade](/guides/all/self-heal-scorecards-with-ai.md): Learn how to use Port's AI capabilities to detect scorecard degradation and automatically use a coding agent like GitHub Copilot to fix it. #### send-slack-message-to-user Learn how to send Slack messages to users using Port's Slack app and automations - [Send Slack messages using Port's Slack app and automations](/guides/all/send-slack-message-to-user.md): Learn how to send Slack messages to users using Port's Slack app and automations #### send-typeform-survey-results-to-port Learn how to send TypeForm survey response to Port - [Send TypeForm survey results to Port](/guides/all/send-typeform-survey-results-to-port.md): Learn how to send TypeForm survey response to Port #### set-up-deployments-dora-gitlab Configure DORA metrics using GitLab merge requests or jobs as the deployment source instead of GitHub. - [Set up deployments using GitLab merge requests or jobs](/guides/all/set-up-deployments-dora-gitlab.md): Configure DORA metrics using GitLab merge requests or jobs as the deployment source instead of GitHub. #### setup-branch-protection-rules Learn how to drive DevOps and DevSecOps governance in your organization by enforcing branch protection rules using scorecards - [Enforce branch protection rules with scorecards](/guides/all/setup-branch-protection-rules.md): Learn how to drive DevOps and DevSecOps governance in your organization by enforcing branch protection rules using scorecards #### setup-delivery-performance-scorecard Set up Delivery Performance scorecards in Port to grade services, teams, groups, and organizations on PR/MR throughput, cycle time, and stale PR/MR management using Bronze, Silver, and Gold maturity levels. - [Set up delivery performance scorecards](/guides/all/setup-delivery-performance-scorecard.md): Set up Delivery Performance scorecards in Port to grade services, teams, groups, and organizations on PR/MR throughput, cycle time, and stale PR/MR management using Bronze, Silver, and Gold maturity levels. #### setup-dora-metrics Learn how to measure DORA metrics at service and team level, including deployment frequency, lead time for changes, change failure rate, and mean time to recovery, using Port's GitHub integration and dashboards. - [Track DORA metrics](/guides/all/setup-dora-metrics.md): Learn how to measure DORA metrics at service and team level, including deployment frequency, lead time for changes, change failure rate, and mean time to recovery, using Port's GitHub integration and dashboards. #### setup-dora-metrics-jira Configure DORA metrics using Jira issues as the deployment and incident source instead of GitHub and PagerDuty. - [Set up deployments and incidents using Jira issues](/guides/all/setup-dora-metrics-jira.md): Configure DORA metrics using Jira issues as the deployment and incident source instead of GitHub and PagerDuty. #### setup-dora-scorecards Set up DORA scorecards in Port to grade services and teams on deployment frequency, lead time for changes, change failure rate, and mean time to recovery using Bronze, Silver, and Gold maturity levels aligned with DORA benchmarks. - [Set up DORA scorecards](/guides/all/setup-dora-scorecards.md): Set up DORA scorecards in Port to grade services and teams on deployment frequency, lead time for changes, change failure rate, and mean time to recovery using Bronze, Silver, and Gold maturity levels aligned with DORA benchmarks. #### setup-engineering-intelligence-data-model Set up the foundational data model for Engineering Intelligence in Port. Create blueprints for organizations, teams, services, and repositories across GitHub, GitLab, and Azure DevOps. - [Create foundational Engineering Intelligence data model](/guides/all/setup-engineering-intelligence-data-model.md): Set up the foundational data model for Engineering Intelligence in Port. Create blueprints for organizations, teams, services, and repositories across GitHub, GitLab, and Azure DevOps. #### setup-incident-manager-ai-agent Set up an Incident Manager AI agent to help developers track and manage incidents efficiently - [Set up the Incident Manager AI agent](/guides/all/setup-incident-manager-ai-agent.md): Set up an Incident Manager AI agent to help developers track and manage incidents efficiently #### setup-pci-dss-code-compliance Build a comprehensive PCI DSS Code Security Scorecard in Port - [PCI DSS code security scorecard](/guides/all/setup-pci-dss-code-compliance.md): Build a comprehensive PCI DSS Code Security Scorecard in Port #### setup-pipeline-reliability-scorecard Set up Pipeline Reliability scorecards in Port to grade services, teams, groups, and organizations on CI/CD workflow failure rates and reliability trends using Bronze, Silver, and Gold maturity levels. - [Set up pipeline reliability scorecards](/guides/all/setup-pipeline-reliability-scorecard.md): Set up Pipeline Reliability scorecards in Port to grade services, teams, groups, and organizations on CI/CD workflow failure rates and reliability trends using Bronze, Silver, and Gold maturity levels. #### setup-platform-request-triage-ai-agent Set up a Platform Request Triage AI agent to help developers submit and track requests to the platform team. - [Set up the Platform Request Triage AI agent](/guides/all/setup-platform-request-triage-ai-agent.md): Set up a Platform Request Triage AI agent to help developers submit and track requests to the platform team. #### setup-portal-announcements Learn how to track SLOs and SLIs for your services using Port - [Set up announcements in your portal](/guides/all/setup-portal-announcements.md): Learn how to track SLOs and SLIs for your services using Port #### setup-pr-enricher-ai-agent Set up a Pull Request Enricher AI agent to automatically comment on pull requests with additional context - [Set up the Pull Request Enricher AI agent](/guides/all/setup-pr-enricher-ai-agent.md): Set up a Pull Request Enricher AI agent to automatically comment on pull requests with additional context #### setup-production-readiness-scorecard Set up a Service Production Readiness scorecard in Port to grade services on documentation, ownership, repository hygiene, and activity using Bronze, Silver, and Gold maturity levels. - [Set up a service production readiness scorecard](/guides/all/setup-production-readiness-scorecard.md): Set up a Service Production Readiness scorecard in Port to grade services on documentation, ownership, repository hygiene, and activity using Bronze, Silver, and Gold maturity levels. #### setup-service-explorer-ai-agent Set up a Service Explorer AI agent with MCP to help developers discover services, understand ownership, and access documentation for quick onboarding - [Set up the Service Explorer AI agent](/guides/all/setup-service-explorer-ai-agent.md): Set up a Service Explorer AI agent with MCP to help developers discover services, understand ownership, and access documentation for quick onboarding #### setup-slack-reminders Learn how to set up Slack reminders in Port, ensuring timely notifications and improved team productivity. - [Slack reminders for scorecards](/guides/all/setup-slack-reminders.md): Learn how to set up Slack reminders in Port, ensuring timely notifications and improved team productivity. #### setup-task-manager-ai-agent Set up a Task Manager AI agent to help developers track and manage tasks efficiently - [Set up the Task Manager AI agent](/guides/all/setup-task-manager-ai-agent.md): Set up a Task Manager AI agent to help developers track and manage tasks efficiently #### smart-pr-reviewer-assignment-using-port-ai Automatically assign qualified PR reviewers using Port AI, CODEOWNERS, ownership data, and capacity constraints. - [Smart PR reviewer assignment using AI](/guides/all/smart-pr-reviewer-assignment-using-port-ai.md): Automatically assign qualified PR reviewers using Port AI, CODEOWNERS, ownership data, and capacity constraints. #### streamline-iac-with-ai Use Port AI agents with AI coding assistants to streamline Infrastructure as Code (IaC) by automatically provisioning cloud resources like S3 buckets - [Streamline IaC with AI](/guides/all/streamline-iac-with-ai.md): Use Port AI agents with AI coding assistants to streamline Infrastructure as Code (IaC) by automatically provisioning cloud resources like S3 buckets #### surface-resource-actions-from-jira-with-ai Use Port's AI agent to analyze Jira issues and surface relevant self-service actions for cloud resources and permissions. - [Surface resource actions from Jira with AI](/guides/all/surface-resource-actions-from-jira-with-ai.md): Use Port's AI agent to analyze Jira issues and surface relevant self-service actions for cloud resources and permissions. #### sync-argocd-app Learn how to sync an ArgoCD app in Port, ensuring your deployments are up-to-date and accurately reflected. - [Synchronize Argo CD Application](/guides/all/sync-argocd-app.md): Learn how to sync an ArgoCD app in Port, ensuring your deployments are up-to-date and accurately reflected. #### sync-port-properties-to-github-custom-properties Send Port entity property values to GitHub repository custom properties using automations and a GitHub workflow. - [Sync Port properties to GitHub custom properties](/guides/all/sync-port-properties-to-github-custom-properties.md): Send Port entity property values to GitHub repository custom properties using automations and a GitHub workflow. #### sync-service-entities-to-incident-io Learn how to sync your Port service entities into incident.io catalog for better visibility. - [Sync Port services to incident.io](/guides/all/sync-service-entities-to-incident-io.md): Learn how to sync your Port service entities into incident.io catalog for better visibility. #### terraform-plan-and-apply-aws-resource Learn how to use Terraform to plan and apply AWS resources in Port, ensuring efficient infrastructure management and deployment. - [Provision Cloud Resource using Terraform Plan and Apply](/guides/all/terraform-plan-and-apply-aws-resource.md): Learn how to use Terraform to plan and apply AWS resources in Port, ensuring efficient infrastructure management and deployment. #### track-ai-adoption-and-impact Learn how to track AI adoption across engineering teams and assess the impact of AI usage on delivery metrics like PR throughput and cycle time using Port's GitHub Ocean integration. - [Track AI adoption and impact](/guides/all/track-ai-adoption-and-impact.md): Learn how to track AI adoption across engineering teams and assess the impact of AI usage on delivery metrics like PR throughput and cycle time using Port's GitHub Ocean integration. #### track-ai-coding-assistants-costs Build a unified dashboard to analyze and compare AI coding tool costs across Cursor, Claude, and GitHub Copilot using data already ingested into Port. - [Track AI coding assistants costs](/guides/all/track-ai-coding-assistants-costs.md): Build a unified dashboard to analyze and compare AI coding tool costs across Cursor, Claude, and GitHub Copilot using data already ingested into Port. #### track-ai-driven-pull-requests Learn how to track and monitor AI-driven pull requests in your development workflow using Port's software catalog and automation capabilities. - [Track AI-driven pull requests](/guides/all/track-ai-driven-pull-requests.md): Learn how to track and monitor AI-driven pull requests in your development workflow using Port's software catalog and automation capabilities. #### track-and-show-mtbf-for-services Track Mean Time Between Failures (MTBF) for your Pagerduty services to measure reliability and identify improvement opportunities - [Track and show MTBF for services](/guides/all/track-and-show-mtbf-for-services.md): Track Mean Time Between Failures (MTBF) for your Pagerduty services to measure reliability and identify improvement opportunities #### track-gitlab-project-maturity-with-scorecards Learn how to drive DevOps and DevSecOps governance in your organization by enforcing code maturity standards using scorecards with GitLab file search - [Enforce code maturity with GitLab file search](/guides/all/track-gitlab-project-maturity-with-scorecards.md): Learn how to drive DevOps and DevSecOps governance in your organization by enforcing code maturity standards using scorecards with GitLab file search #### track-health-of-jira-projects Learn how to enforce project maturity and operational readiness by tracking Jira issue hygiene, compliance risks, and incident response with Port scorecards. - [Set up Jira project health scorecards](/guides/all/track-health-of-jira-projects.md): Learn how to enforce project maturity and operational readiness by tracking Jira issue hygiene, compliance risks, and incident response with Port scorecards. #### track-leaked-github-secrets-in-port Learn how to send leaked application secrets from GitHub to Port using Gitleaks - [Track leaked GitHub secrets in Port](/guides/all/track-leaked-github-secrets-in-port.md): Learn how to send leaked application secrets from GitHub to Port using Gitleaks #### track-slos-and-slis-for-services Learn how to track SLOs and SLIs for your services using Port - [Track SLOs and SLIs for your services](/guides/all/track-slos-and-slis-for-services.md): Learn how to track SLOs and SLIs for your services using Port #### track-team-work-allocation-with-jira Learn how to measure and visualize work allocation across Roadmap, Tech Debt, and Support categories at the team level using Jira labels and Port dashboards. - [Track team work allocation with Jira](/guides/all/track-team-work-allocation-with-jira.md): Learn how to measure and visualize work allocation across Roadmap, Tech Debt, and Support categories at the team level using Jira labels and Port dashboards. #### triage-incidents-with-ai Triage incidents with AI for severity, business impact, affected services, and response team recommendations. - [Triage incidents with AI](/guides/all/triage-incidents-with-ai.md): Triage incidents with AI for severity, business impact, affected services, and response team recommendations. #### triage-incidents-with-mcp Triage incidents using AI, Sentry MCP, GitHub MCP, and Slack — fetch live errors, query code context, and post a structured root-cause summary directly from Port AI. - [Triage incidents using external MCP tools](/guides/all/triage-incidents-with-mcp.md): Triage incidents using AI, Sentry MCP, GitHub MCP, and Slack — fetch live errors, query code context, and post a structured root-cause summary directly from Port AI. #### triage-tickets-to-coding-agents Learn how to implement an AI-powered triage system that automatically evaluates Jira tickets, enriches them with missing context, and ensures only well-defined tasks reach your coding agents. - [Improve specifications with Port AI](/guides/all/triage-tickets-to-coding-agents.md): Learn how to implement an AI-powered triage system that automatically evaluates Jira tickets, enriches them with missing context, and ensures only well-defined tasks reach your coding agents. #### trigger-claude-code-from-port Learn how to trigger Claude Code from Port to enable AI-powered coding assistance in your development workflow while tracking its usage. - [Trigger Claude Code from Port](/guides/all/trigger-claude-code-from-port.md): Learn how to trigger Claude Code from Port to enable AI-powered coding assistance in your development workflow while tracking its usage. #### trigger-datadog-incident Learn how to trigger a Datadog incident in Port, ensuring effective monitoring and prompt issue response. - [Trigger Datadog Incident](/guides/all/trigger-datadog-incident.md): Learn how to trigger a Datadog incident in Port, ensuring effective monitoring and prompt issue response. #### trigger-gemini-assistant-from-port Learn how to trigger Google Gemini Assistant from Port to enable AI-powered coding assistance in your development workflow while tracking its execution. - [Trigger Google Gemini Assistant from Port](/guides/all/trigger-gemini-assistant-from-port.md): Learn how to trigger Google Gemini Assistant from Port to enable AI-powered coding assistance in your development workflow while tracking its execution. #### trigger-github-copilot-from-port Learn how to set up GitHub Copilot triggers from Port to enable AI-powered coding assistance in your development workflow. - [Trigger GitHub Copilot from Port](/guides/all/trigger-github-copilot-from-port.md): Learn how to set up GitHub Copilot triggers from Port to enable AI-powered coding assistance in your development workflow. #### trigger-servicenow-incident Learn how to trigger a ServiceNow incident in Port, ensuring prompt issue resolution and effective incident management. - [Trigger ServiceNow Incident](/guides/all/trigger-servicenow-incident.md): Learn how to trigger a ServiceNow incident in Port, ensuring prompt issue resolution and effective incident management. #### trigger-spacelift-stack Learn how to trigger a Spacelift stack in Port to automate infrastructure workflows - [Trigger a Spacelift stack](/guides/all/trigger-spacelift-stack.md): Learn how to trigger a Spacelift stack in Port to automate infrastructure workflows #### verify-service Learn how to keep your service catalog data up to date with Port's automation and self-service features - [Remind service owners to update their catalog data](/guides/all/verify-service.md): Learn how to keep your service catalog data up to date with Port's automation and self-service features #### visualize-and-manage-aws-ec2-instances Learn how to monitor and manage your AWS EC2 instances using dashboards and self-service actions in Port. - [Visualize and manage your EC2 instances](/guides/all/visualize-and-manage-aws-ec2-instances.md): Learn how to monitor and manage your AWS EC2 instances using dashboards and self-service actions in Port. #### visualize-and-manage-azure-devops-deployments Learn how to monitor and manage your Azure DevOps deployments using dashboards and self-service actions in Port. - [Visualize and manage your Azure DevOps deployments](/guides/all/visualize-and-manage-azure-devops-deployments.md): Learn how to monitor and manage your Azure DevOps deployments using dashboards and self-service actions in Port. #### visualize-and-manage-github-deployments Learn how to monitor and manage your GitHub deployments using dashboards and self-service actions in Port. - [Visualize and manage your GitHub deployments](/guides/all/visualize-and-manage-github-deployments.md): Learn how to monitor and manage your GitHub deployments using dashboards and self-service actions in Port. #### visualize-and-manage-gitlab-deployments Learn how to monitor and manage your GitLab deployments using dashboards and self-service actions in Port. - [Visualize and manage your GitLab deployments](/guides/all/visualize-and-manage-gitlab-deployments.md): Learn how to monitor and manage your GitLab deployments using dashboards and self-service actions in Port. #### visualize-and-manage-servicenow-incidents Learn how to monitor and manage your ServiceNow incidents using dashboards and self-service actions in Port. - [Visualize and manage your ServiceNow incidents](/guides/all/visualize-and-manage-servicenow-incidents.md): Learn how to monitor and manage your ServiceNow incidents using dashboards and self-service actions in Port. #### visualize-and-manage-statuspage-incidents Learn how to monitor and manage your Statuspage incidents and components using dashboards and self-service actions in Port. - [Visualize and manage your Statuspage incidents and components](/guides/all/visualize-and-manage-statuspage-incidents.md): Learn how to monitor and manage your Statuspage incidents and components using dashboards and self-service actions in Port. #### visualize-claude-metrics Learn how to create dashboards to monitor Claude API usage, track costs, analyze model performance, and measure workspace-level metrics. - [Visualize Claude metrics](/guides/all/visualize-claude-metrics.md): Learn how to create dashboards to monitor Claude API usage, track costs, analyze model performance, and measure workspace-level metrics. #### visualize-cursor-metrics Learn how to visualize Cursor adoption, suggestion acceptance, and engineering impact at the user, team, and organization level using Port's native Cursor integration and dashboards. - [Visualize Cursor metrics](/guides/all/visualize-cursor-metrics.md): Learn how to visualize Cursor adoption, suggestion acceptance, and engineering impact at the user, team, and organization level using Port's native Cursor integration and dashboards. #### visualize-github-copilot-metrics Learn how to visualize GitHub Copilot adoption, suggestion acceptance, and engineering impact at the user, team, and organization level using Port's GitHub Copilot integration and dashboards. - [Visualize GitHub Copilot metrics](/guides/all/visualize-github-copilot-metrics.md): Learn how to visualize GitHub Copilot adoption, suggestion acceptance, and engineering impact at the user, team, and organization level using Port's GitHub Copilot integration and dashboards. #### visualize-jira-lead-time Track and visualize Jira lead time metrics at the service and team level, including weekly and monthly averages, using Port dashboards. - [Visualize lead time using Jira](/guides/all/visualize-jira-lead-time.md): Track and visualize Jira lead time metrics at the service and team level, including weekly and monthly averages, using Port dashboards. #### visualize-okta-security-insights Learn how to build a security analytics dashboard for Okta identity and access management using Port's integration - [Visualize Okta security insights](/guides/all/visualize-okta-security-insights.md): Learn how to build a security analytics dashboard for Okta identity and access management using Port's integration #### visualize-service-argocd-runtime Learn how to visualize ArgoCD service runtime in Port, enhancing monitoring and management of your Kubernetes applications. - [Visualize your services' Kubernetes runtime using ArgoCD](/guides/all/visualize-service-argocd-runtime.md): Learn how to visualize ArgoCD service runtime in Port, enhancing monitoring and management of your Kubernetes applications. #### visualize-service-k8s-runtime Learn how to visualize Kubernetes service runtime in Port, improving monitoring and management of your cloud-native applications. - [Visualize your services' k8s runtime](/guides/all/visualize-service-k8s-runtime.md): Learn how to visualize Kubernetes service runtime in Port, improving monitoring and management of your cloud-native applications. #### visualize-your-aws-storage-configuration Learn how to monitor and manage your AWS data and storage security, including S3 bucket and RDS configurations using dashboards and self-service actions. - [Manage and visualize your AWS S3 buckets and RDS instances](/guides/all/visualize-your-aws-storage-configuration.md): Learn how to monitor and manage your AWS data and storage security, including S3 bucket and RDS configurations using dashboards and self-service actions. #### visualize-your-github-dependabot-alerts Learn how to monitor GitHub Dependabot alerts and gain security insights using dashboards. - [Visualize your GitHub dependency security alerts](/guides/all/visualize-your-github-dependabot-alerts.md): Learn how to monitor GitHub Dependabot alerts and gain security insights using dashboards. #### visualize-your-github-identity-and-access-management Learn how to gain insights into GitHub identity and access management across your organization - [Visualize your GitHub identity and access management](/guides/all/visualize-your-github-identity-and-access-management.md): Learn how to gain insights into GitHub identity and access management across your organization #### visualize-your-github-repository-activity Learn how to gain insights into GitHub repositories and developer activity by tracking pull requests, issues, and visibility. - [Visualize your GitHub repository and developer activity](/guides/all/visualize-your-github-repository-activity.md): Learn how to gain insights into GitHub repositories and developer activity by tracking pull requests, issues, and visibility. #### visualize-your-wiz-vulnerabilities Learn how to monitor Wiz issues and gain security insights using dashboards. - [Visualize your Wiz security issues](/guides/all/visualize-your-wiz-vulnerabilities.md): Learn how to monitor Wiz issues and gain security insights using dashboards. #### work-item-blueprint Implement the work item blueprint pattern for autonomous ticket resolution. Connect Jira issues to services, teams, PRs, and deployments. - [Implement the work item blueprint pattern](/guides/all/work-item-blueprint.md): Implement the work item blueprint pattern for autonomous ticket resolution. Connect Jira issues to services, teams, PRs, and deployments. ## ai-interfaces ### AGENTS This is a hidden guide for AI agents to understand how to maintain and update the AI interfaces documentation in Port Docs. - [AGENTS.md - AI Documentation Maintenance Guide](/ai-interfaces/AGENTS.md): This is a hidden guide for AI agents to understand how to maintain and update the AI interfaces documentation in Port Docs. ### ai-agents #### build-an-ai-agent Build an AI agent in Port to assist your developers with finding information and completing tasks. - [Build an AI agent](/ai-interfaces/ai-agents/build-an-ai-agent.md): Build an AI agent in Port to assist your developers with finding information and completing tasks. #### interact-with-ai-agents Learn how to invoke and interact with Port AI agents programmatically through API calls, automations, and workflow integrations. - [Interact with AI agents](/ai-interfaces/ai-agents/interact-with-ai-agents.md): Learn how to invoke and interact with Port AI agents programmatically through API calls, automations, and workflow integrations. #### overview Understand Port AI Agents - domain-specific entities built on Port AI for autonomous machine-to-machine operations and intelligent workflows. - [AI agents overview](/ai-interfaces/ai-agents/overview.md): Understand Port AI Agents - domain-specific entities built on Port AI for autonomous machine-to-machine operations and intelligent workflows. ### ai-chat-widget Embed a customizable AI chat interface in your Port dashboards with configurable prompts, conversation starters, and developer tools. - [AI Chat Widget](/ai-interfaces/ai-chat-widget.md): Embed a customizable AI chat interface in your Port dashboards with configurable prompts, conversation starters, and developer tools. ### context-lake #### overview Port's Context Lake is your unified engineering knowledge layer—connecting data from across your entire toolchain into a single, semantically-rich source of truth. - [Context Lake](/ai-interfaces/context-lake/overview.md): Port's Context Lake is your unified engineering knowledge layer—connecting data from across your entire toolchain into a single, semantically-rich source of truth. ### integrations-vs-mcp Port gives you two ways to connect external tools: integrations and MCP connectors. They solve different problems and are designed to complement each other — in many cases, you can benefit from both connected for the same tool. - [Integrations vs. MCP connectors](/ai-interfaces/integrations-vs-mcp.md): Port gives you two ways to connect external tools: integrations and MCP connectors. They solve different problems and are designed to complement each other — in many cases, you can benefit from both connected for the same tool. ### mcp-connectors MCP Connectors turn Port into a unified MCP gateway, routing requests from developers and AI agents to external MCP servers while applying Port's governance, RBAC, and audit controls. Platform engineers configure which MCP servers are available and which tools are exposed. Developers and AI agents access everything through a single interface. - [MCP connectors](/ai-interfaces/mcp-connectors.md): MCP Connectors turn Port into a unified MCP gateway, routing requests from developers and AI agents to external MCP servers while applying Port's governance, RBAC, and audit controls. Platform engineers configure which MCP servers are available and which tools are exposed. Developers and AI agents access everything through a single interface. #### github-mcp-connector Set up the GitHub MCP connector to give Port AI access to GitHub repositories, issues, and pull requests through OAuth authentication. - [GitHub MCP connector](/ai-interfaces/mcp-connectors/github-mcp-connector.md): Set up the GitHub MCP connector to give Port AI access to GitHub repositories, issues, and pull requests through OAuth authentication. ### overview Port's AI interfaces provide intelligent assistance across your entire software development lifecycle. - [AI Interfaces Overview](/ai-interfaces/overview.md): Port's AI interfaces provide intelligent assistance across your entire software development lifecycle. ### port-ai #### api-interaction Port AI can be accessed programmatically through Port's API, enabling integration into custom applications and workflows. - [Port AI API Interaction](/ai-interfaces/port-ai/api-interaction.md): Port AI can be accessed programmatically through Port's API, enabling integration into custom applications and workflows. #### context-engineering Context engineering is the practice of constructing an optimal information environment that provides the right amount of directions, tools, and knowledge for AI systems to successfully solve problems. - [Context Engineering with Port AI](/ai-interfaces/port-ai/context-engineering.md): Context engineering is the practice of constructing an optimal information environment that provides the right amount of directions, tools, and knowledge for AI systems to successfully solve problems. #### llm-providers-management ##### overview Manage and configure LLM providers that power Port AI, including Port's managed infrastructure and bring-your-own-LLM options. - [LLM Provider Management](/ai-interfaces/port-ai/llm-providers-management/overview.md): Manage and configure LLM providers that power Port AI, including Port's managed infrastructure and bring-your-own-LLM options. ##### providers - [Anthropic setup](/ai-interfaces/port-ai/llm-providers-management/providers/anthropic.md): Configure Anthropic as an LLM provider in Port to use Claude models directly through Anthropic's API. - [AWS Bedrock setup](/ai-interfaces/port-ai/llm-providers-management/providers/aws-bedrock.md): Configure AWS Bedrock as an LLM provider in Port using IAM-based authentication to access Claude and other models. - [Azure Anthropic setup](/ai-interfaces/port-ai/llm-providers-management/providers/azure-anthropic.md): Configure Azure Anthropic as an LLM provider in Port to use Claude models hosted in your Azure deployment. - [Azure OpenAI setup](/ai-interfaces/port-ai/llm-providers-management/providers/azure-openai.md): Configure Azure OpenAI as an LLM provider in Port by storing your Azure credentials and registering your OpenAI deployment. - [OpenAI setup](/ai-interfaces/port-ai/llm-providers-management/providers/openai.md): Configure OpenAI as an LLM provider in Port by storing your API key and registering your OpenAI account. - [OpenAI compatible setup](/ai-interfaces/port-ai/llm-providers-management/providers/openai-compatible.md): Configure any OpenAI-compatible endpoint as an LLM provider in Port, including LiteLLM proxies and custom gateways. - [Provider guides overview](/ai-interfaces/port-ai/llm-providers-management/providers/overview.md): Step-by-step setup guides for each LLM provider supported by Port, including OpenAI, Anthropic, Azure, AWS Bedrock, and Vertex AI. - [Vertex Anthropic setup](/ai-interfaces/port-ai/llm-providers-management/providers/vertex-anthropic.md): Configure Vertex Anthropic as an LLM provider in Port to use Claude models hosted on Google Vertex AI. - [Vertex Gemini setup](/ai-interfaces/port-ai/llm-providers-management/providers/vertex-gemini.md): Configure Vertex Gemini as an LLM provider in Port using service account or Express Mode authentication. ##### selecting-llm-provider Learn how to select specific LLM providers and models for Port AI requests, including default provider configuration and validation. - [Selecting LLM Provider](/ai-interfaces/port-ai/llm-providers-management/selecting-llm-provider.md): Learn how to select specific LLM providers and models for Port AI requests, including default provider configuration and validation. ##### setup-and-configuration Technical guide for setting up LLM providers in Port, including permissions, secrets management, validation, and troubleshooting. - [Setup & Configuration](/ai-interfaces/port-ai/llm-providers-management/setup-and-configuration.md): Technical guide for setting up LLM providers in Port, including permissions, secrets management, validation, and troubleshooting. #### memory Learn how Port AI memory learns and remembers your preferences across conversations to provide personalized responses. - [Memory](/ai-interfaces/port-ai/memory.md): Learn how Port AI memory learns and remembers your preferences across conversations to provide personalized responses. #### overview Port AI is the foundational AI system that enables intelligent interaction with your Port data through natural language. - [Port AI](/ai-interfaces/port-ai/overview.md): Port AI is the foundational AI system that enables intelligent interaction with your Port data through natural language. #### security-and-data-controls Learn about Port AI's security practices, data privacy, RBAC enforcement, and controls for responsible AI usage. - [AI Security and Data Controls](/ai-interfaces/port-ai/security-and-data-controls.md): Learn about Port AI's security practices, data privacy, RBAC enforcement, and controls for responsible AI usage. ### port-ai-assistant Use the Port AI Assistant for instant, no-configuration AI chat about your software catalog, actions, and Port capabilities. - [Port AI Assistant](/ai-interfaces/port-ai-assistant.md): Use the Port AI Assistant for instant, no-configuration AI chat about your software catalog, actions, and Port capabilities. ### port-mcp-server #### available-tools Reference for all tools exposed by the Port MCP Server, organized by developer and builder roles with detailed capabilities. - [Available tools](/ai-interfaces/port-mcp-server/available-tools.md): Reference for all tools exposed by the Port MCP Server, organized by developer and builder roles with detailed capabilities. #### installation Install and configure the Port MCP server so AI agents and LLMs can interact with your Port developer portal using natural language. Covers OAuth and client-credentials authentication for local and CI use. - [Installation](/ai-interfaces/port-mcp-server/installation.md): Install and configure the Port MCP server so AI agents and LLMs can interact with your Port developer portal using natural language. Covers OAuth and client-credentials authentication for local and CI use. #### overview Learn how the Port MCP server enables LLMs to interact with your developer portal using natural language, allowing you to query your software catalog, analyze service health, and streamline development workflows. - [Port MCP server](/ai-interfaces/port-mcp-server/overview.md): Learn how the Port MCP server enables LLMs to interact with your developer portal using natural language, allowing you to query your software catalog, analyze service health, and streamline development workflows. #### prompts Prebuilt prompts for the Port MCP server that help AI agents query and act on your Port catalog. - [Prompts](/ai-interfaces/port-mcp-server/prompts.md): Prebuilt prompts for the Port MCP server that help AI agents query and act on your Port catalog. #### token-based-authentication When integrating the Port MCP Server with AI agents in automated environments like CI/CD pipelines, the authentication approach differs from interactive local usage. This guide explains how to establish secure connections between AI agents and the Port MCP Server without requiring user interaction. - [Token-based connection to Port MCP server](/ai-interfaces/port-mcp-server/token-based-authentication.md): When integrating the Port MCP Server with AI agents in automated environments like CI/CD pipelines, the authentication approach differs from interactive local usage. This guide explains how to establish secure connections between AI agents and the Port MCP Server without requiring user interaction. ### port-n8n-node Install and configure Port's custom n8n node to integrate Port AI agents and API into your n8n automation workflows. - [Port n8n node](/ai-interfaces/port-n8n-node.md): Install and configure Port's custom n8n node to integrate Port AI agents and API into your n8n automation workflows. ### skills Skills are domain-specific guidance packages that help Port AI handle specialized tasks more effectively. - [Skills](/ai-interfaces/skills.md): Skills are domain-specific guidance packages that help Port AI handle specialized tasks more effectively. ### slack-app Use Port's Slack app to interact with your developer portal and AI features directly from Slack, including notifications and catalog queries. - [Slack Application](/ai-interfaces/slack-app.md): Use Port's Slack app to interact with your developer portal and AI features directly from Slack, including notifications and catalog queries. ## category ### llm-provider-management Manage and configure the Large Language Model (LLM) providers that power all AI interactions in Port. This feature gives you control over which AI models are used across Port AI Assistant, AI Agents, and other AI-powered features. - [LLM Provider Management](/category/llm-provider-management.md): Manage and configure the Large Language Model (LLM) providers that power all AI interactions in Port. This feature gives you control over which AI models are used across Port AI Assistant, AI Agents, and other AI-powered features. ## customize-pages-dashboards-and-plugins ### customization Customize your portal with organization branding, logos, announcement banners, and accessibility settings like high contrast mode. - [Customization & accessibility](/customize-pages-dashboards-and-plugins/customization.md): Customize your portal with organization branding, logos, announcement banners, and accessibility settings like high contrast mode. ### dashboards #### custom-widgets Add custom widgets including iframes for external content, markdown for formatted text, and action buttons to trigger self-service workflows. - [Custom widgets](/customize-pages-dashboards-and-plugins/dashboards/custom-widgets.md): Add custom widgets including iframes for external content, markdown for formatted text, and action buttons to trigger self-service workflows. #### data-widgets Build data visualizations with number charts, pie charts, line charts, tables, and entity widgets. Supports aggregations, filtering, and conditional formatting. - [Data widgets](/customize-pages-dashboards-and-plugins/dashboards/data-widgets.md): Build data visualizations with number charts, pie charts, line charts, tables, and entity widgets. Supports aggregations, filtering, and conditional formatting. #### overview Overview of Port dashboard widgets including data widgets, custom widgets, and personal widgets. Available on home pages, entity pages, and dashboard pages. - [Overview](/customize-pages-dashboards-and-plugins/dashboards/overview.md): Overview of Port dashboard widgets including data widgets, custom widgets, and personal widgets. Available on home pages, entity pages, and dashboard pages. #### personal-widgets Add personal widgets to your home page showing your assigned entities, recently viewed items, and recently used actions. - [Personal widgets](/customize-pages-dashboards-and-plugins/dashboards/personal-widgets.md): Add personal widgets to your home page showing your assigned entities, recently viewed items, and recently used actions. ### page #### catalog-page Customize Port catalog pages with table views, filters, grouping, sorting, and widgets. Configure initial filters, hide properties, save views, and control page visibility by team or role. - [Catalog page](/customize-pages-dashboards-and-plugins/page/catalog-page.md): Customize Port catalog pages with table views, filters, grouping, sorting, and widgets. Configure initial filters, hide properties, save views, and control page visibility by team or role. #### dashboard-page Create dashboard pages with customizable widgets to display aggregated entity data, charts, and visualizations in your software catalog. - [Dashboard page](/customize-pages-dashboards-and-plugins/page/dashboard-page.md): Create dashboard pages with customizable widgets to display aggregated entity data, charts, and visualizations in your software catalog. #### entity-page Customize entity pages with Overview, Related entities, Runs, and Audit log tabs. Add widgets and configure property visibility. - [Entity page](/customize-pages-dashboards-and-plugins/page/entity-page.md): Customize entity pages with Overview, Related entities, Runs, and Audit log tabs. Add widgets and configure property visibility. #### folders Organize your software catalog by grouping pages into folders. Supports nesting up to 3 levels and drag-and-drop reordering. - [Folders](/customize-pages-dashboards-and-plugins/page/folders.md): Organize your software catalog by grouping pages into folders. Supports nesting up to 3 levels and drag-and-drop reordering. #### page-permissions Control who can view or edit catalog and dashboard pages using role-based permissions for users and teams. - [Page permissions](/customize-pages-dashboards-and-plugins/page/page-permissions.md): Control who can view or edit catalog and dashboard pages using role-based permissions for users and teams. #### private-pages Create personal catalog and dashboard pages in a dedicated Private sidebar section. Configure who can create private pages, change visibility between organization and private, and manage permissions on your own pages. - [Private pages](/customize-pages-dashboards-and-plugins/page/private-pages.md): Create personal catalog and dashboard pages in a dedicated Private sidebar section. Configure who can create private pages, change visibility between organization and private, and manage permissions on your own pages. ### plugins A plugin is a self-contained web UI, built from HTML, JavaScript, or a framework such as React, that you develop locally and upload to Port. Plugins power custom widgets that render inside dashboards and entity pages using the same catalog data and permissions as the rest of the platform. - [Plugins](/customize-pages-dashboards-and-plugins/plugins.md): A plugin is a self-contained web UI, built from HTML, JavaScript, or a framework such as React, that you develop locally and upload to Port. Plugins power custom widgets that render inside dashboards and entity pages using the same catalog data and permissions as the rest of the platform. ## docs-ai-assistant Use Port's AI assistant to ask documentation questions, generate resource definitions, debug JSON/YAML, and get help with blueprints and actions. - [Docs AI assistant](/docs-ai-assistant.md): Use Port's AI assistant to ask documentation questions, generate resource definitions, debug JSON/YAML, and get help with blueprints and actions. ## glossary Definitions of Port-specific terms - Blueprint, Entity, Ocean, Scorecard, Self-service action - and how they differ from standard DevOps terminology. - [Glossary](/glossary.md): Definitions of Port-specific terms - Blueprint, Entity, Ocean, Scorecard, Self-service action - and how they differ from standard DevOps terminology. ## integrations-index Complete index of Port integrations for Git providers, cloud platforms, CI/CD tools, monitoring, security, and project management systems. - [Integrations index](/integrations-index.md): Complete index of Port integrations for Git providers, cloud platforms, CI/CD tools, monitoring, security, and project management systems. ## observability ### audit-log View a complete record of changes in your Port organization. Track entity, blueprint, action, automation, and integration modifications with filtering and export. - [Audit log](/observability/audit-log.md): View a complete record of changes in your Port organization. Track entity, blueprint, action, automation, and integration modifications with filtering and export. ### usage-dashboard Track portal usage metrics including user activity, entity counts, action execution, integration usage, and AI interactions. Updated daily. - [Portal usage dashboard](/observability/usage-dashboard.md): Track portal usage metrics including user activity, entity counts, action execution, integration usage, and AI interactions. Updated daily. ## security Port security practices including SOC2 Type II, ISO 27001, GDPR compliance, data encryption, access controls, and infrastructure security. - [Security & compliance](/security.md): Port security practices including SOC2 Type II, ISO 27001, GDPR compliance, data encryption, access controls, and infrastructure security. ## solutions ### agentic-resource-management #### create-golden-paths Build standardized templates for provisioning services, databases, and infrastructure. Golden paths reduce cognitive load and enforce best practices. - [Create golden paths](/solutions/agentic-resource-management/create-golden-paths.md): Build standardized templates for provisioning services, databases, and infrastructure. Golden paths reduce cognitive load and enforce best practices. #### day-2-resource-lifecycle Manage ongoing cloud resource operations including scaling, patching, tagging, and decommissioning through self-service actions. - [Day 2 - manage resource lifecycle](/solutions/agentic-resource-management/day-2-resource-lifecycle.md): Manage ongoing cloud resource operations including scaling, patching, tagging, and decommissioning through self-service actions. #### overview Self-service resource provisioning for developers and AI agents with golden paths, approval workflows, and unified guardrails across human and automated requests. - [Agentic resource management](/solutions/agentic-resource-management/overview.md): Self-service resource provisioning for developers and AI agents with golden paths, approval workflows, and unified guardrails across human and automated requests. #### self-service-environments Enable developers to provision development environments on-demand. Covers scaffolding apps, ephemeral cloud environments, and Kubernetes namespaces. - [Self-service environments](/solutions/agentic-resource-management/self-service-environments.md): Enable developers to provision development environments on-demand. Covers scaffolding apps, ephemeral cloud environments, and Kubernetes namespaces. #### setup-approval-workflows Configure RBAC, manual approvals, and dynamic permissions for self-service actions. Control access for both human developers and AI agents. - [Set up approval workflows](/solutions/agentic-resource-management/setup-approval-workflows.md): Configure RBAC, manual approvals, and dynamic permissions for self-service actions. Control access for both human developers and AI agents. ### autonomous-security-management #### compliance-as-code Automate compliance with continuous evidence collection, scorecard-based controls, and framework mapping for SOC2, ISO 27001, and custom standards. - [Compliance as code](/solutions/autonomous-security-management/compliance-as-code.md): Automate compliance with continuous evidence collection, scorecard-based controls, and framework mapping for SOC2, ISO 27001, and custom standards. #### overview Enrich security findings with ownership and business context for prioritization. AI agents propose fixes while security teams maintain approval control. - [Autonomous security management](/solutions/autonomous-security-management/overview.md): Enrich security findings with ownership and business context for prioritization. AI agents propose fixes while security teams maintain approval control. #### prioritise-vulnerabilities Prioritize vulnerabilities by business impact using service ownership, environment, and criticality context. Focus remediation on what matters. - [Prioritize vulnerabilities](/solutions/autonomous-security-management/prioritise-vulnerabilities.md): Prioritize vulnerabilities by business impact using service ownership, environment, and criticality context. Focus remediation on what matters. #### security-actions-automations Automate security workflows with self-service remediation, automated triage, exception handling, and AI-assisted vulnerability fixes. - [Security actions & automations](/solutions/autonomous-security-management/security-actions-automations.md): Automate security workflows with self-service remediation, automated triage, exception handling, and AI-assisted vulnerability fixes. #### security-champions-initiatives Scale security culture with security champion programs, gamification, team leaderboards, and measurable secure development standards. - [Security champions & initiatives](/solutions/autonomous-security-management/security-champions-initiatives.md): Scale security culture with security champion programs, gamification, team leaderboards, and measurable secure development standards. #### security-metrics-visualization Build security dashboards with business context showing vulnerability trends, mean time to remediate, and team-level security posture. - [Security metrics visualization](/solutions/autonomous-security-management/security-metrics-visualization.md): Build security dashboards with business context showing vulnerability trends, mean time to remediate, and team-level security posture. ### autonomous-ticket-resolution #### code-review Enrich PRs with service context, assign smart reviewers, send review nudges, and track security review outputs in your catalog. - [Review the results](/solutions/autonomous-ticket-resolution/code-review.md): Enrich PRs with service context, assign smart reviewers, send review nudges, and track security review outputs in your catalog. #### managing-ai-primitives Short map of Port AI building blocks that support autonomous ticket resolution: skills, agents, MCP, context, and controls. - [Managing AI primitives](/solutions/autonomous-ticket-resolution/managing-ai-primitives.md): Short map of Port AI building blocks that support autonomous ticket resolution: skills, agents, MCP, context, and controls. #### overview Automate the software delivery lifecycle from ticket creation to production. AI handles routing and context while humans control decisions that matter. - [Autonomous ticket resolution](/solutions/autonomous-ticket-resolution/overview.md): Automate the software delivery lifecycle from ticket creation to production. AI handles routing and context while humans control decisions that matter. #### roi-dashboard Measure the impact of Autonomous Ticket Resolution (ATR) in Port with an ROI dashboard covering tickets resolved, time saved, and cost impact. - [Measure ATR's impact](/solutions/autonomous-ticket-resolution/roi-dashboard.md): Measure the impact of Autonomous Ticket Resolution (ATR) in Port with an ROI dashboard covering tickets resolved, time saved, and cost impact. #### safe-release Deploy code safely with PR enrichment, smart reviewer assignment, security review tracking, and automated review nudges. - [Release safely with control](/solutions/autonomous-ticket-resolution/safe-release.md): Deploy code safely with PR enrichment, smart reviewer assignment, security review tracking, and automated review nudges. #### turn-tickets-into-actionable-work Enrich Jira tickets with context, evaluate AI delegation eligibility, and produce routing decisions with supporting documentation. - [Turn tickets into actionable work](/solutions/autonomous-ticket-resolution/turn-tickets-into-actionable-work.md): Enrich Jira tickets with context, evaluate AI delegation eligibility, and produce routing decisions with supporting documentation. ##### overview Transform thin tickets into actionable work items with service context, blast radius, PRDs, and AI routing decisions. - [Ticket preparation](/solutions/autonomous-ticket-resolution/turn-tickets-into-actionable-work/overview.md): Transform thin tickets into actionable work items with service context, blast radius, PRDs, and AI routing decisions. ##### routing-decision Determine AI delegation eligibility with deterministic scorecards and LLM confidence scoring. Route work safely between agents and humans. - [Routing decision](/solutions/autonomous-ticket-resolution/turn-tickets-into-actionable-work/routing-decision.md): Determine AI delegation eligibility with deterministic scorecards and LLM confidence scoring. Route work safely between agents and humans. #### why-port Port provides catalog context, deterministic routing scorecards, entity persistence, and measurable outcomes for autonomous ticket resolution workflows. - [Why Port?](/solutions/autonomous-ticket-resolution/why-port.md): Port provides catalog context, deterministic routing scorecards, entity persistence, and measurable outcomes for autonomous ticket resolution workflows. #### work-item-blueprint-pattern Create a dedicated Port entity for AI-assisted development that tracks workflow state separately from Jira/Linear/ADO tickets. - [Work item blueprint pattern](/solutions/autonomous-ticket-resolution/work-item-blueprint-pattern.md): Create a dedicated Port entity for AI-assisted development that tracks workflow state separately from Jira/Linear/ADO tickets. ### engineering-intelligence #### getting-started Set up Engineering Intelligence with core concepts, tool integrations, and a structured rollout plan for measuring engineering effectiveness. - [Getting started](/solutions/engineering-intelligence/getting-started.md): Set up Engineering Intelligence with core concepts, tool integrations, and a structured rollout plan for measuring engineering effectiveness. ##### ei-journey Four-phase Engineering Intelligence journey from baseline metrics through continuous improvement with scorecards, AI agents, and automations. - [Example journey](/solutions/engineering-intelligence/getting-started/ei-journey.md): Four-phase Engineering Intelligence journey from baseline metrics through continuous improvement with scorecards, AI agents, and automations. ##### supported-integrations Connect GitHub, Jira, PagerDuty, and other tools to build a complete engineering context lake for metrics, scorecards, and AI agents. - [Integrations & MCP connectors](/solutions/engineering-intelligence/getting-started/supported-integrations.md): Connect GitHub, Jira, PagerDuty, and other tools to build a complete engineering context lake for metrics, scorecards, and AI agents. #### improve-lead-time Identify bottlenecks in coding, review, and deployment stages. Track lead time breakdowns and target the slowest phases for improvement. - [Improve lead time](/solutions/engineering-intelligence/improve-lead-time.md): Identify bottlenecks in coding, review, and deployment stages. Track lead time breakdowns and target the slowest phases for improvement. #### measure-dora-metrics Calculate deployment frequency, lead time, change failure rate, and MTTR per service and team from connected deployment and incident data. - [Measure DORA metrics](/solutions/engineering-intelligence/measure-dora-metrics.md): Calculate deployment frequency, lead time, change failure rate, and MTTR per service and team from connected deployment and incident data. #### overview Unified engineering metrics platform connecting DORA, delivery performance, developer experience, and reliability data for data-driven improvement. - [Engineering Intelligence](/solutions/engineering-intelligence/overview.md): Unified engineering metrics platform connecting DORA, delivery performance, developer experience, and reliability data for data-driven improvement. #### reduce-mttr Improve incident recovery by tracking detection, diagnosis, and resolution time. Identify slow phases and automate response workflows. - [Reduce MTTR](/solutions/engineering-intelligence/reduce-mttr.md): Improve incident recovery by tracking detection, diagnosis, and resolution time. Identify slow phases and automate response workflows. #### use-cases Engineering Intelligence use cases for DORA metrics, delivery performance, developer experience surveys, reliability, and AI adoption tracking. - [Use cases](/solutions/engineering-intelligence/use-cases.md): Engineering Intelligence use cases for DORA metrics, delivery performance, developer experience surveys, reliability, and AI adoption tracking. ##### ai-adoption Track AI tool adoption rates, measure ROI, and correlate usage with delivery performance improvements across teams. - [AI adoption and impact](/solutions/engineering-intelligence/use-cases/ai-adoption.md): Track AI tool adoption rates, measure ROI, and correlate usage with delivery performance improvements across teams. - [AI impact](/solutions/engineering-intelligence/use-cases/ai-adoption/ai-impact.md): Correlate AI tool adoption with delivery performance, incident frequency, and code quality to measure real engineering outcomes. - [Track AI adoption](/solutions/engineering-intelligence/use-cases/ai-adoption/ai-tools.md): Monitor Copilot, Cursor, and AI tool usage rates, suggestion acceptance, and adoption distribution across teams for ROI analysis. ##### conversational-insights Query your context lake through MCP integration with Claude, Cursor, and Lovable to generate reports and insights using natural language. - [Conversational insights](/solutions/engineering-intelligence/use-cases/conversational-insights.md): Query your context lake through MCP integration with Claude, Cursor, and Lovable to generate reports and insights using natural language. - [AI agents](/solutions/engineering-intelligence/use-cases/conversational-insights/ai-agents.md): Use AI agents to analyze delivery performance, identify bottlenecks, and recommend improvements based on your engineering context lake. - [Chat with your context lake outside of Port](/solutions/engineering-intelligence/use-cases/conversational-insights/chat-with-your-data.md): Query your engineering data in natural language through MCP integration. Ask about services, metrics, incidents, and team performance. - [Insight dashboards](/solutions/engineering-intelligence/use-cases/conversational-insights/generate-reports.md): Create real-time dashboards with built-in widgets, custom visualizations, or AI-generated reports through Claude and Lovable. ##### delivery-performance Measure PR throughput, cycle time, review bottlenecks, and deployment pipeline efficiency to improve delivery flow. - [Delivery performance](/solutions/engineering-intelligence/use-cases/delivery-performance.md): Measure PR throughput, cycle time, review bottlenecks, and deployment pipeline efficiency to improve delivery flow. - [PR delivery metrics](/solutions/engineering-intelligence/use-cases/delivery-performance/pr-metrics.md): Track PR throughput, cycle time breakdown, stale PRs, and standards compliance to identify delivery bottlenecks per team and service. - [Reduce review time](/solutions/engineering-intelligence/use-cases/delivery-performance/review-time.md): Identify review bottlenecks with time-to-first-review and review rounds metrics. Use AI enrichment and automated reminders to speed up reviews. ##### devex-surveys Run developer experience surveys, collect qualitative feedback, and turn developer sentiment into actionable improvement initiatives. - [DevEx surveys](/solutions/engineering-intelligence/use-cases/devex-surveys.md): Run developer experience surveys, collect qualitative feedback, and turn developer sentiment into actionable improvement initiatives. - [Act on survey insights](/solutions/engineering-intelligence/use-cases/devex-surveys/act-on-insights.md): Turn developer feedback into improvement initiatives. Track scorecard compliance progress and follow-up sentiment after changes. - [Promote surveys & share results](/solutions/engineering-intelligence/use-cases/devex-surveys/developer-sentiment.md): Drive survey participation and share results transparently. Track completion rates and sentiment trends across survey rounds. - [Run developer surveys](/solutions/engineering-intelligence/use-cases/devex-surveys/run-surveys.md): Launch developer experience surveys to surface pain points metrics miss. Track participation, satisfaction trends, and segment differences. ##### dora Measure and improve DORA metrics including deployment frequency, lead time, change failure rate, and mean time to recovery. - [DORA metrics](/solutions/engineering-intelligence/use-cases/dora.md): Measure and improve DORA metrics including deployment frequency, lead time, change failure rate, and mean time to recovery. ##### reliability Track CI/CD pipeline health, failure trends, service stability, and mean time between failures to identify reliability issues early. - [Reliability visibility](/solutions/engineering-intelligence/use-cases/reliability.md): Track CI/CD pipeline health, failure trends, service stability, and mean time between failures to identify reliability issues early. - [Pipeline reliability](/solutions/engineering-intelligence/use-cases/reliability/deployment-pipelines.md): Track workflow failure rates, re-run frequency, pipeline duration, and failure concentration to identify and fix CI/CD reliability issues. - [Measure reliability & stability](/solutions/engineering-intelligence/use-cases/reliability/measure-reliability.md): Track SLO compliance, SLI trends, incident frequency, and service stability across your catalog to prioritize reliability investments. - [Mean time between failures (MTBF)](/solutions/engineering-intelligence/use-cases/reliability/mtbf.md): Track MTBF alongside MTTR and CFR for complete stability visibility. Distinguish genuinely stable services from those that just recover quickly. ##### standards-and-scorecards Define and enforce engineering standards with scorecards for production readiness, code quality, security compliance, and working agreements. - [Standards and scorecards](/solutions/engineering-intelligence/use-cases/standards-and-scorecards.md): Define and enforce engineering standards with scorecards for production readiness, code quality, security compliance, and working agreements. - [Delivery performance](/solutions/engineering-intelligence/use-cases/standards-and-scorecards/delivery-performance-scorecards.md): Score teams on PR cycle time, throughput, stale PR rate, and standards compliance with configurable maturity thresholds. - [DORA performance](/solutions/engineering-intelligence/use-cases/standards-and-scorecards/dora-scorecards.md): Grade teams on DORA metrics with Bronze/Silver/Gold scorecards. Set configurable thresholds and track maturity improvements over time. - [Pipeline reliability](/solutions/engineering-intelligence/use-cases/standards-and-scorecards/pipeline-reliability.md): Track CI/CD pipeline success rates, failure frequency, flaky tests, and build duration with scorecards and automated remediation workflows. - [Production readiness](/solutions/engineering-intelligence/use-cases/standards-and-scorecards/production-readiness.md): Score services on ownership, documentation, monitoring, security compliance, and infrastructure hygiene with Bronze/Silver/Gold maturity levels. #### why-port Port combines engineering intelligence with orchestration on a unified catalog. Close the loop from insight to execution to measured impact. - [Why Port?](/solutions/engineering-intelligence/why-port.md): Port combines engineering intelligence with orchestration on a unified catalog. Close the loop from insight to execution to measured impact. ### overview Port solutions for resource management, incident response, security, engineering intelligence, and ticket resolution with human and AI agent collaboration. - [Solutions overview](/solutions/overview.md): Port solutions for resource management, incident response, security, engineering intelligence, and ticket resolution with human and AI agent collaboration. ### self-healing-incidents #### communicate-internally-and-externally Automate incident communication with Slack channels, status page updates, and stakeholder notifications. Keep teams and customers informed. - [Communicate internally & externally](/solutions/self-healing-incidents/communicate-internally-and-externally.md): Automate incident communication with Slack channels, status page updates, and stakeholder notifications. Keep teams and customers informed. #### detect-and-diagnose-incidents Unify alerts from monitoring tools, enrich with service context and ownership, and automate incident creation workflows. - [Detect & diagnose incidents](/solutions/self-healing-incidents/detect-and-diagnose-incidents.md): Unify alerts from monitoring tools, enrich with service context and ownership, and automate incident creation workflows. #### incident-blueprint-pattern Recommended blueprint pattern for AI-assisted incident management. Separates workflow state from origin alerts with staged AI integration and human approval gates. - [Incident blueprint pattern](/solutions/self-healing-incidents/incident-blueprint-pattern.md): Recommended blueprint pattern for AI-assisted incident management. Separates workflow state from origin alerts with staged AI integration and human approval gates. #### operate-and-resolve-incidents Take action during incidents with self-service acknowledgment, escalation, temporary permissions, status updates, and resolution workflows. - [Operate & resolve incidents](/solutions/self-healing-incidents/operate-and-resolve-incidents.md): Take action during incidents with self-service acknowledgment, escalation, temporary permissions, status updates, and resolution workflows. #### overview Unified incident management combining detection, communication, resolution, and post-mortems across PagerDuty, Datadog, AWS, and other tools. - [Self-healing incidents](/solutions/self-healing-incidents/overview.md): Unified incident management combining detection, communication, resolution, and post-mortems across PagerDuty, Datadog, AWS, and other tools. #### prevent-and-minimize-incidents Build resilience through production readiness scorecards, proactive monitoring, automated checks, and continuous learning from past incidents. - [Prevent & minimize incidents](/solutions/self-healing-incidents/prevent-and-minimize-incidents.md): Build resilience through production readiness scorecards, proactive monitoring, automated checks, and continuous learning from past incidents. #### start-the-incident Standardize incident creation with self-service actions or automations. Connect alerts from any source and auto-enrich with service context. - [Start the incident](/solutions/self-healing-incidents/start-the-incident.md): Standardize incident creation with self-service actions or automations. Connect alerts from any source and auto-enrich with service context. #### visualize-and-manage-incidents Dashboard views for incident management across PagerDuty, Statuspage, and ServiceNow. Track current incidents and historical trends. - [Visualize & manage incidents](/solutions/self-healing-incidents/visualize-and-manage-incidents.md): Dashboard views for incident management across PagerDuty, Statuspage, and ServiceNow. Track current incidents and historical trends. ## sso-rbac ### multi-org-sso This page covers how to configure SSO when your Port company has multiple organizations, such as separate environments for development and production. It addresses common questions about IdP application registration, team synchronization, and RBAC across organizations. - [Multi-org SSO setup](/sso-rbac/multi-org-sso.md): This page covers how to configure SSO when your Port company has multiple organizations, such as separate environments for development and production. It addresses common questions about IdP application registration, team synchronization, and RBAC across organizations. ### multi-organization Manage multiple Port organizations with cross-organization access. Create organizations, switch between them, and share users. - [Multiple organization membership](/sso-rbac/multi-organization.md): Manage multiple Port organizations with cross-organization access. Create organizations, switch between them, and share users. ### ownership Assign users and teams as owners of catalog entities. Sync ownership from integrations and visualize who owns what in your portal. - [Manage ownership in Port](/sso-rbac/ownership.md): Assign users and teams as owners of catalog entities. Sync ownership from integrations and visualize who owns what in your portal. ### port-secrets Manage Port API credentials (client ID, client secret) and organization secrets. Use secrets in integrations and automations with the {{ .secrets.SECRET_NAME }} template syntax. - [Credentials & secrets](/sso-rbac/port-secrets.md): Manage Port API credentials (client ID, client secret) and organization secrets. Use secrets in integrations and automations with the {{ .secrets.SECRET_NAME }} template syntax. ### rbac-overview Port RBAC overview covering catalog permissions, action execution controls, and platform administration. Configure who can view, edit, and delete entities, run self-service actions, and manage Port settings. - [Port RBAC capabilities overview](/sso-rbac/rbac-overview.md): Port RBAC overview covering catalog permissions, action execution controls, and platform administration. Configure who can view, edit, and delete entities, run self-service actions, and manage Port settings. ### SCIM SCIM (System for Cross-domain Identity Management) enables automated user provisioning and de-provisioning from Identity Providers (IdP) like Okta, Azure AD, and Google Workspace directly into Port. - [SCIM](/sso-rbac/SCIM.md): SCIM (System for Cross-domain Identity Management) enables automated user provisioning and de-provisioning from Identity Providers (IdP) like Okta, Azure AD, and Google Workspace directly into Port. ### self-serve-sso Set up and manage SSO for your organization directly from the portal - [Manage your SSO connection](/sso-rbac/self-serve-sso.md): Set up and manage SSO for your organization directly from the portal ### sso-providers Port offers several SSO integrations, allowing you to easily assign permissions and roles using your users and teams. - [SSO providers](/sso-rbac/sso-providers.md): Port offers several SSO integrations, allowing you to easily assign permissions and roles using your users and teams. #### ldap Integrate any LDAP system with Port SSO - [LDAP](/sso-rbac/sso-providers/ldap.md): Integrate any LDAP system with Port SSO #### oidc Integrate any SSO with Port using OIDC application - [OIDC](/sso-rbac/sso-providers/oidc.md): Integrate any SSO with Port using OIDC application ##### azure-ad Integrate AzureAD with Port using OIDC - [Entra ID (AzureAD)](/sso-rbac/sso-providers/oidc/azure-ad.md): Integrate AzureAD with Port using OIDC ##### okta Integrate Okta with Port - [Okta](/sso-rbac/sso-providers/oidc/okta.md): Integrate Okta with Port ##### onelogin Integrate Onelogin with Port - [Onelogin](/sso-rbac/sso-providers/oidc/onelogin.md): Integrate Onelogin with Port #### saml Integrate any SSO with Port using SAML application - [SAML](/sso-rbac/sso-providers/saml.md): Integrate any SSO with Port using SAML application ##### azure-ad Integrate Entra ID (AzureAD) with Port using SAML - [Entra ID (AzureAD)](/sso-rbac/sso-providers/saml/azure-ad.md): Integrate Entra ID (AzureAD) with Port using SAML ##### google-workspace Integrate Google Workspace with Port using SAML - [Google Workspace](/sso-rbac/sso-providers/saml/google-workspace.md): Integrate Google Workspace with Port using SAML ##### jumpcloud Integrate JumpCloud with Port using SAML - [JumpCloud](/sso-rbac/sso-providers/saml/jumpcloud.md): Integrate JumpCloud with Port using SAML ##### okta Integrate Okta with Port using SAML - [Okta](/sso-rbac/sso-providers/saml/okta.md): Integrate Okta with Port using SAML ### user-membership-reference A complete reference for how users are added to organizations in Port — SSO, SCIM, invitations, member statuses, and edge cases. - [User membership reference](/sso-rbac/user-membership-reference.md): A complete reference for how users are added to organizations in Port — SSO, SCIM, invitations, member statuses, and edge cases. ### users-and-teams #### manage-users-teams Manage users, teams, roles, and permissions in Port. Invite users, assign roles, create teams, and configure granular access controls. - [Manage users & teams](/sso-rbac/users-and-teams/manage-users-teams.md): Manage users, teams, roles, and permissions in Port. Invite users, assign roles, create teams, and configure granular access controls. #### organization-hierarchy Model your organization hierarchy with team blueprints. Create views showing groups, teams, and services at each tier level. - [Visualize organization hierarchy](/sso-rbac/users-and-teams/organization-hierarchy.md): Model your organization hierarchy with team blueprints. Create views showing groups, teams, and services at each tier level. #### view-as-different-user Test permissions by viewing the portal as a different user. Validate dynamic filters, role-based access, and page visibility without switching accounts. - [View as a different user](/sso-rbac/users-and-teams/view-as-different-user.md): Test permissions by viewing the portal as a different user. Validate dynamic filters, role-based access, and page visibility without switching accounts. ## troubleshooting Answers to common questions and issues when using Port, organized by topic - general usage, Ocean integrations, actions, the Port execution agent, and per-provider integration bugs. - [Troubleshooting](/troubleshooting.md): Answers to common questions and issues when using Port, organized by topic - general usage, Ocean integrations, actions, the Port execution agent, and per-provider integration bugs. ### actions Diagnose self-service actions in Port that are stuck in progress, including action backend configuration and Port execution agent setup for Git providers. - [Actions troubleshooting](/troubleshooting/actions.md): Diagnose self-service actions in Port that are stuck in progress, including action backend configuration and Port execution agent setup for Git providers. ### azure-devops Diagnose Azure DevOps Ocean integration bugs in Port - deleted repositories not reflected, syncs that run with no result, test results not ingesting, and inconsistent file ingestion. - [Azure DevOps integration troubleshooting](/troubleshooting/azure-devops.md): Diagnose Azure DevOps Ocean integration bugs in Port - deleted repositories not reflected, syncs that run with no result, test results not ingesting, and inconsistent file ingestion. ### general Answers to common general questions about Port - account setup, organization management, exporting catalog data, embedding content, and security. - [General troubleshooting](/troubleshooting/general.md): Answers to common general questions about Port - account setup, organization management, exporting catalog data, embedding content, and security. ### github Diagnose GitHub Ocean integration bugs in Port - stale data with live events, entities not deleted, partial PR ingestion, workflow run deletion, missing team relations, and migration from the legacy integration. - [GitHub integration troubleshooting](/troubleshooting/github.md): Diagnose GitHub Ocean integration bugs in Port - stale data with live events, entities not deleted, partial PR ingestion, workflow run deletion, missing team relations, and migration from the legacy integration. ### gitlab Diagnose GitLab Ocean integration bugs in Port - resync failures from missing selector attributes, projects not visible after a group access token, and version compatibility issues. - [GitLab integration troubleshooting](/troubleshooting/gitlab.md): Diagnose GitLab Ocean integration bugs in Port - resync failures from missing selector attributes, projects not visible after a group access token, and version compatibility issues. ### ocean-integrations Diagnose common Ocean integration issues in Port - installation failures, validation errors, mapping problems, and connectivity between the integration and Port's API. - [Ocean integrations troubleshooting](/troubleshooting/ocean-integrations.md): Diagnose common Ocean integration issues in Port - installation failures, validation errors, mapping problems, and connectivity between the integration and Port's API. ### port-agent Diagnose Port execution agent failures - 401 authentication errors, Kafka consumer group authorization, action execution timeouts, and TLS certificate issues on startup. - [Port execution agent troubleshooting](/troubleshooting/port-agent.md): Diagnose Port execution agent failures - 401 authentication errors, Kafka consumer group authorization, action execution timeouts, and TLS certificate issues on startup. ## workflows ### build-workflows #### action-nodes ##### ai Invoke Port AI or AI agents directly from workflows to perform intelligent operations and automated decision-making. - [AI](/workflows/build-workflows/action-nodes/ai.md): Invoke Port AI or AI agents directly from workflows to perform intelligent operations and automated decision-making. ##### configuration-and-outputs Learn common action node configuration fields, outputs, and how to chain action nodes together in workflows. - [Configuration and outputs](/workflows/build-workflows/action-nodes/configuration-and-outputs.md): Learn common action node configuration fields, outputs, and how to chain action nodes together in workflows. ##### cursor-agent Launch Cursor cloud agents from workflows to perform AI-powered coding tasks on GitHub repositories or pull requests. - [Cursor Agent](/workflows/build-workflows/action-nodes/cursor-agent.md): Launch Cursor cloud agents from workflows to perform AI-powered coding tasks on GitHub repositories or pull requests. ##### integration-actions - [Azure DevOps Pipelines](/workflows/build-workflows/action-nodes/integration-actions/azure-devops.md): Trigger Azure DevOps pipelines from Port workflows using your installed Azure DevOps integration (coming soon). - [GitHub integration action](/workflows/build-workflows/action-nodes/integration-actions/github.md): Trigger GitHub Actions workflows directly from Port workflows using your installed GitHub integration. - [GitLab CI/CD Pipelines](/workflows/build-workflows/action-nodes/integration-actions/gitlab.md): Trigger GitLab CI/CD pipelines from Port workflows using your installed GitLab integration (coming soon). - [Overview](/workflows/build-workflows/action-nodes/integration-actions/overview.md): Trigger operations in connected platforms like GitHub directly from workflows using Port's existing integrations. ##### kafka Publish messages to Port's dedicated Kafka topic from workflows to process events with your own consumers. - [Kafka](/workflows/build-workflows/action-nodes/kafka.md): Publish messages to Port's dedicated Kafka topic from workflows to process events with your own consumers. ##### port-execution-agent Execute workflow webhook actions inside your private network without exposing public endpoints using the Port execution agent. - [Port execution agent](/workflows/build-workflows/action-nodes/port-execution-agent.md): Execute workflow webhook actions inside your private network without exposing public endpoints using the Port execution agent. ##### upsert-entity Create or update entities in Port's software catalog from workflows using the upsert entity action node. - [Upsert entity](/workflows/build-workflows/action-nodes/upsert-entity.md): Create or update entities in Port's software catalog from workflows using the upsert entity action node. ##### webhook Send HTTP requests to external endpoints from workflows, supporting synchronous and asynchronous operations with custom headers and payloads. - [Webhook](/workflows/build-workflows/action-nodes/webhook.md): Send HTTP requests to external endpoints from workflows, supporting synchronous and asynchronous operations with custom headers and payloads. #### data-flow Pass data between workflow nodes using outputs and variables, reference trigger inputs, and use JQ expressions for data transformation. - [Data flow](/workflows/build-workflows/data-flow.md): Pass data between workflow nodes using outputs and variables, reference trigger inputs, and use JQ expressions for data transformation. #### event-trigger Configure workflows to run automatically when entities are created, updated, or deleted in your software catalog. - [Event trigger](/workflows/build-workflows/event-trigger.md): Configure workflows to run automatically when entities are created, updated, or deleted in your software catalog. #### flow-nodes ##### condition Add branching logic to workflows using condition nodes that evaluate expressions and route execution to different paths. - [Condition nodes](/workflows/build-workflows/flow-nodes/condition.md): Add branching logic to workflows using condition nodes that evaluate expressions and route execution to different paths. ##### input Add human-in-the-loop steps to workflows using input nodes for approvals, manual gates, and decision points that require user responses. - [Input nodes](/workflows/build-workflows/flow-nodes/input.md): Add human-in-the-loop steps to workflows using input nodes for approvals, manual gates, and decision points that require user responses. #### quickstart Create your first workflow in Port using the visual editor, JSON editor, or AI-assisted builder to send a webhook notification. - [Quickstart](/workflows/build-workflows/quickstart.md): Create your first workflow in Port using the visual editor, JSON editor, or AI-assisted builder to send a webhook notification. #### reusable-workflows Share logic across workflows by triggering child workflows from parent workflows, enabling reusable approval flows and shared provisioning sequences. - [Reusable workflows](/workflows/build-workflows/reusable-workflows.md): Share logic across workflows by triggering child workflows from parent workflows, enabling reusable approval flows and shared provisioning sequences. #### self-service-trigger ##### advanced-input-configurations Configure advanced user input features including visibility controls, input dependencies, and dynamic default values using JQ expressions. - [Advanced input configurations](/workflows/build-workflows/self-service-trigger/advanced-input-configurations.md): Configure advanced user input features including visibility controls, input dependencies, and dynamic default values using JQ expressions. ##### configuration Configure self-service trigger nodes with user inputs, permissions, and UI contexts to create on-demand workflow executions. - [Configuration](/workflows/build-workflows/self-service-trigger/configuration.md): Configure self-service trigger nodes with user inputs, permissions, and UI contexts to create on-demand workflow executions. ##### contexts Surface self-service triggers in additional UI locations like entity creation flows and action menus using the contexts configuration. - [Contexts](/workflows/build-workflows/self-service-trigger/contexts.md): Surface self-service triggers in additional UI locations like entity creation flows and action menus using the contexts configuration. ##### permissions Control who can see and execute workflows using team-based, role-based, or dynamic permission rules on self-service triggers. - [Permissions](/workflows/build-workflows/self-service-trigger/permissions.md): Control who can see and execute workflows using team-based, role-based, or dynamic permission rules on self-service triggers. ##### user-inputs - [Array](/workflows/build-workflows/self-service-trigger/user-inputs/array.md): Configure array inputs for workflow forms to accept lists of values like tags, services to deploy, or email recipients. - [Datetime](/workflows/build-workflows/self-service-trigger/user-inputs/datetime.md): Configure datetime inputs for workflow forms to accept date and time values for scheduling, expiration, or maintenance windows. - [Email](/workflows/build-workflows/self-service-trigger/user-inputs/email.md): Configure email inputs for workflow forms to accept and validate email addresses for contacts or notifications. - [Entity](/workflows/build-workflows/self-service-trigger/user-inputs/entity.md): Configure entity inputs for workflow forms to let users select entities from your software catalog like services or environments. - [Number](/workflows/build-workflows/self-service-trigger/user-inputs/number.md): Configure number inputs for workflow forms to accept numeric values like replica counts, port numbers, or resource limits. - [Object](/workflows/build-workflows/self-service-trigger/user-inputs/object.md): Configure object inputs for workflow forms to accept JSON objects for configuration data, metadata, or key-value pairs. - [Structure and fields](/workflows/build-workflows/self-service-trigger/user-inputs/structure-and-fields.md): Define user inputs for self-service workflows including input structure, common fields, and required vs optional configurations. - [Team](/workflows/build-workflows/self-service-trigger/user-inputs/team.md): Configure team inputs for workflow forms to let users select Port teams for ownership assignment or notifications. - [Text](/workflows/build-workflows/self-service-trigger/user-inputs/text.md): Configure text inputs for workflow forms to accept string values like service names, version tags, or commit SHAs. - [Toggle](/workflows/build-workflows/self-service-trigger/user-inputs/toggle.md): Configure toggle inputs for workflow forms to accept boolean true/false values for feature flags or operation modes. - [URL](/workflows/build-workflows/self-service-trigger/user-inputs/url.md): Configure URL inputs for workflow forms to accept and validate URL strings for repository links, API endpoints, or documentation. - [User](/workflows/build-workflows/self-service-trigger/user-inputs/user.md): Configure user inputs for workflow forms to let users select Port users for ownership, reviewers, or on-call assignment. - [YAML](/workflows/build-workflows/self-service-trigger/user-inputs/yaml.md): Configure YAML inputs for workflow forms to accept YAML-formatted content like Kubernetes manifests or configuration files. #### test-workflows Test your workflow directly from the builder by running the entire workflow or individual nodes with mock data before publishing. - [Test workflows](/workflows/build-workflows/test-workflows.md): Test your workflow directly from the builder by running the entire workflow or individual nodes with mock data before publishing. ### concepts Learn the core building blocks of workflows including nodes (triggers, actions, conditions), edges, and how multiple triggers work together. - [Concepts and structure](/workflows/concepts.md): Learn the core building blocks of workflows including nodes (triggers, actions, conditions), edges, and how multiple triggers work together. ### examples Real-world workflow examples for common use cases including scaffolding microservices, deployments, and automated catalog updates. - [Workflow examples](/workflows/examples.md): Real-world workflow examples for common use cases including scaffolding microservices, deployments, and automated catalog updates. ### overview Build visual, node-based automations in Port using workflows. Chain operations, add conditional logic, and create complex automation flows triggered manually or by catalog events. - [Workflows (Beta)](/workflows/overview.md): Build visual, node-based automations in Port using workflows. Chain operations, add conditional logic, and create complex automation flows triggered manually or by catalog events. ### runs Monitor workflow executions, view run status and logs, cancel running workflows, and interact with workflow runs through the API. - [Interact with workflow runs](/workflows/runs.md): Monitor workflow executions, view run status and logs, cancel running workflows, and interact with workflow runs through the API. ### workflow-run-page View and debug individual workflow executions with visual status indicators showing node success, failure, and data flow through the graph. - [Workflow run page](/workflows/workflow-run-page.md): View and debug individual workflow executions with visual status indicators showing node success, failure, and data flow through the graph. ## Optional - [Port agent skill: API authentication, endpoints, and terminology for building with Port](https://docs.port.io/AGENTS.md): Quick-reference for agents: authentication, regional base URLs, common API request patterns (upsert entity, search, trigger action), and correct Port terminology. - [Port REST API reference (all endpoints)](https://docs.port.io/api-reference/port-api): Full Port REST API: authentication, base URLs, and every endpoint (entities, blueprints, actions, scorecards, workflows). Individual endpoints are omitted from this index to keep it concise; browse them at this page, or use the machine-readable OpenAPI spec at https://docs.port.io/apispec-port-api.yaml.