harbormaster

Environment: preprod
harbormaster.dev.worthwhilek8s.com

Harbormaster provides access to services running in Kubernetes clusters from your local machine. No kubectl access or cluster credentials are required. Connect to databases, APIs, and other services using standard local tools (database clients, IDEs, etc.).

Harbormaster handles Kubernetes networking, authentication, and service discovery. You authenticate through this web interface, then use the command-line client to establish connections to services by their FQDN.

Getting Started:

  1. Install the client 0.1.104 package
    pip install https://harbormaster.dev.worthwhilek8s.com/static/hm_client.gz
  2. Login to this harbormaster instance:
    hm login harbormaster.dev.worthwhilek8s.com
  3. List all Kubernetes namespaces and check your access:
    hm namespaces
  4. List the services available in a namespace:
    hm list <namespace>
  5. Connect to a service using its FQDN:
    hm connect <fqdn>[<:port>] <local_port>
    Examples: hm connect postgres.default.svc.cluster.local 5432
    hm connect smtp-svc.features-pawb.svc.cluster.local:8000 8080
    Note: The port in the FQDN is optional. Use it when a service has multiple ports.

Additional Commands:

  • Show client version:
    hm version
  • List all clusters you're logged in to:
    hm clusters
  • Logout from a harbormaster instance:
    hm logout <env>
    Example: hm logout dev