Skip to content

Document --service-uri on 'devtunnel create' for choosing the cluster #643

@joetossell

Description

@joetossell

Ask

devtunnel create selects the cluster by nearest-by-latency, and there's no documented way
to override it. In practice --service-uri does exactly that, but it isn't listed in
devtunnel create --help or the CLI command reference, so it's undiscoverable:

# nearest cluster was euw at the time; this still created in uks1:
devtunnel create my-tunnel --service-uri https://uks1.rel.tunnels.api.visualstudio.com
devtunnel list | grep my-tunnel   # -> my-tunnel.uks1

The relay hostnames come from the URI column of devtunnel clusters.

Please surface --service-uri (or whatever the supported create-time cluster selector is)
in devtunnel create --help and the command-line reference. Choosing the cluster matters
because the tunnel's public URL encodes it, so anyone registering that URL with an external
service (webhook, OIDC redirect) needs it to be deterministic.

Environment

  • devtunnel CLI 1.0.1824+9e602bae78, Linux x64, Microsoft Entra ID auth.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions