Supporting HTTP or HTTPS ingress for services deployed to the Agent - Precisely Data Integrity Suite

Data Integrity Suite
Product
Spatial_Analytics
Data_Integration
Data_Enrichment
Data_Governance
Precisely_Data_Integrity_Suite
geo_addressing_1
Data_Observability
Data_Quality
dis_core_foundation
Services
Spatial Analytics
Data Integration
Data Enrichment
Data Governance
Geo Addressing
Data Observability
Data Quality
Core Foundation
ft:title
Data Integrity Suite
ft:locale
en-US
PublicationType
pt_product_guide
copyrightfirst
2000
copyrightlast
2026

Enable secure, browser-friendly access to services that run on the Precisely Agent by creating HTTP or HTTPS ingress rules. You'll use simple discli commands to preview, apply, and optionally secure ingress with TLS certificates.

Note: It is important that the operator version is updated to the latest version. The command to update the operator version is: ./discli agent applyOperatorVersion --version=<latest version>. After this, you can manually update the other services on the agent.

Prerequisites:

  1. Agent is fully installed and healthy (status is green).
  2. Ensure your terminal can download and run the CLI: 
    wget https://cdn.cloud.precisely.com/agent-cli/discli && chmod +x ./dis
  3. Optional: A valid TLS certificate and private key file if you plan to enable HTTPS.

Steps to configure HTTP or HTTPS ingress:

  1. Ingress preview command: Runs a dry-run of the ingress configuration for the specified hostname. This shows what ingress rules will be created without making any changes. Use this to validate the hostname and planned routing before applying. -h is reserved for command help, so use the long hostname flag in ingress commands.
    ./discli ingress preview --ingress-hostname=<hostname> -t=<tls-certificate> -p=<private-key>
  2. Ingress apply command: Creates ingress rules for the specified hostname, making services accessible via HTTP. Run this after confirming the Agent is installed and healthy.
    ./discli ingress apply --ingress-hostname=<hostname> -t=<tls-certificate> -p=<private-key>
  3. TLS apply command: Enables HTTPS by applying the provided TLS certificate and private key. This secures traffic to the hostname with SSL or TLS encryption.
    ./discli ingress tls-apply --hostname=<hostname> --tls-certificate=<tls-certificate> --private-key=<private-key>

By completing these steps, you have successfully configured ingress for Agent-hosted services. The preview command helps you validate the configuration before changes, the apply command enables HTTP access, and the TLS apply command secures traffic with HTTPS. This approach keeps connectivity consistent and secure across environments and separates ingress configuration from installation, making it easier to manage and maintain.