Skip to main content
logoTetrate Service BridgeVersion: 1.13.x

Publishing Services with the Tetrate Hosted Agent

The Tetrate Hosted Agent is a configuration agent that is optionally provided with the Tetrate Hosted Management Plane. The Agent simplifies the process of publishing applications through Tier2 and Tier1 gateways:

  • Users can declare their desired configuration using annotations on the services they want to publish
  • The Tetrate-Hosted Agent processes these annotations and generates the required configuration to expose the services

The Tetrate Hosted Agent provides comprehensive traffic management for both north-south (ingress) and east-west (service mesh) patterns:

  • North-South: Use gateway.tetrate.io/* annotations on services for external exposure
  • East-West: Opt-in model with traffic.tetrate.io/global: "true" namespace annotation required; customize with additional traffic.tetrate.io/* annotations

The opt-in model for east-west traffic provides better resource control while maintaining full customization options. Start with minimal configurations and progressively add advanced features as needed. The system handles the complexity while providing clear feedback through status annotations and debug endpoints.

Key Capabilities​

  • Zero-Config Gateway Creation: Automatic gateway setup with minimal configuration
  • Multi-Protocol Support: HTTP and HTTPS protocols (TCP and TLS currently disabled)
  • Global Multi-Cluster Exposure: Dual gateway creation (local + edge) with weighted traffic distribution
  • Advanced Security: JWT authentication, OIDC, rate limiting, and WAF protection
  • Intelligent Path Routing: Automatic collision detection and resolution
  • Real-time Status Feedback: Immediate feedback on gateway configuration status

Learn how to use the Tetrate Hosted Agent​

  1. Quick Start​

    Three quick examples which illustrate how to use the Tetrate Hosted Agent to expose a service

  2. Configuring the Tetrate Hosted Agent​

    Configure the Agent's installation and operations to fine-tune its behavior

  3. Basic Usage​

    Learn the various ways to use the Tetrate Hosted Agent to expose services

  4. Security Use Cases​

    Discover the ways in which you can protect or limit access to your services

  5. Traffic Management Use Cases​

    Control how traffic to your service is managed

  6. East-West Traffic Management​

    Use the Tetrate Hosted Agent to expose services between Kubernetes clusters

  7. Advanced Configuration​

    Understand the full power of the Hosted Agent to support a range of scenarios

  8. Best Practices​

    Best Practices when configuring services with the Tetrate Hosted Agent

  9. Troubleshooting your Configuration​

    Use the troubleshooting steps to understand the configuration generated by the Tetrate Hosted Agent, and diagnose problems that might occur

  10. Migrating from other Gateway solutions​

    Learn how to easily migrate from other Gateway solutions to Tetrate Hosted Agent

  11. Configuration Traceability​

    Understand how configuration generated by Tetrate Hosted Agent can be identified and traced

  12. Annotation Reference​

    Complete reference of all the annotations and the Kubernetes objects that they can be attached to