Package com.yahoo.vespa.hosted.controller.api.integration.zone

Interface ZoneRegistry

public interface ZoneRegistry
Provides information about zones in a hosted Vespa system, and about the system.
Author:
mpolden

  • Method Summary

    Modifier and Type
    Method
    Description
    com.yahoo.config.provision.AthenzDomain
    accessControlDomain()
    Return the system Athenz domain
    URI
    apiUrl()
    Returns a URL to the controller's api endpoint
    Optional<com.yahoo.config.provision.AthenzDomain>
    cloudAccountAthenzDomain(com.yahoo.config.provision.CloudAccount cloudAccount)
    Returns athenz domain tied to the given cloud account, if any
    URI
    dashboardUrl()
    Returns a URL where an informative dashboard can be found.
    URI
    dashboardUrl(com.yahoo.config.provision.ApplicationId id)
    Returns a URL which displays information about the given application instance.
    URI
    dashboardUrl(com.yahoo.config.provision.TenantName id)
    Returns a URL which displays information about the given tenant.
    URI
    dashboardUrl(com.yahoo.config.provision.TenantName tenantName, com.yahoo.config.provision.ApplicationName applicationName)
    Returns a URL which displays information about the given application.
    URI
    dashboardUrl(RunId id)
    Returns a URL which displays information about the given job run.
    com.yahoo.vespa.athenz.api.AthenzIdentity
    getConfigServerHttpsIdentity(com.yahoo.config.provision.zone.ZoneId zoneId)
    Return the configserver's Athenz service identity
    URI
    getConfigServerVipUri(com.yahoo.config.provision.zone.ZoneId zoneId)
    Returns the URI for the config server VIP in the given zone
    Optional<com.yahoo.config.provision.RegionName>
    getDefaultRegion(com.yahoo.config.provision.Environment environment)
    Returns the default region for the given environment, if one is configured
    Optional<Duration>
    getDeploymentTimeToLive(com.yahoo.config.provision.zone.ZoneId zoneId)
    Returns the time to live for deployments in the given zone, or empty if this is infinite
    URI
    getMonitoringSystemUri(DeploymentId deploymentId)
    Returns the monitoring system URL for the given deployment
    com.yahoo.vespa.athenz.api.AthenzIdentity
    getNodeAthenzIdentity(com.yahoo.config.provision.zone.ZoneId zoneId, com.yahoo.config.provision.NodeType nodeType)
    Return the Athenz service identity for a given node type
    Optional<String>
    getVipHostname(com.yahoo.config.provision.zone.ZoneId zoneId)
    Returns the VIP hostname for the shared routing layer in given zone, if any
    boolean
    hasZone(com.yahoo.config.provision.zone.ZoneId zoneId)
    Returns whether the system of this registry contains the given zone
    boolean
    hasZone(com.yahoo.config.provision.zone.ZoneId zoneId, com.yahoo.config.provision.CloudAccount cloudAccount)
    Returns whether cloudAccount in this system supports given zone
    List<com.yahoo.config.provision.zone.UpgradePolicy>
    osUpgradePolicies()
    Returns all OS upgrade policies
    com.yahoo.config.provision.zone.UpgradePolicy
    osUpgradePolicy(com.yahoo.config.provision.CloudName cloud)
    Returns the OS upgrade policy to use for zones belonging to given cloud, in this registry
    com.yahoo.config.provision.zone.RoutingMethod
    routingMethod(com.yahoo.config.provision.zone.ZoneId zone)
    Returns the routing method used by given zone
    URI
    supportUrl()
    Returns a URL used to request support from the Vespa team.
    com.yahoo.config.provision.SystemName
    system()
    Returns the system of this registry
    com.yahoo.config.provision.zone.ZoneApi
    systemZone()
    Returns the system of this registry as a zone
    Optional<String>
    tenantDeveloperRoleArn(com.yahoo.config.provision.TenantName tenant)
    IAM tenant developer role ARN
    com.yahoo.config.provision.zone.UpgradePolicy
    upgradePolicy()
    Returns the Vespa upgrade policy to use for zones in this registry
    com.yahoo.config.provision.zone.ZoneFilter
    zones()
    Returns a list containing the id of all zones in this registry
    com.yahoo.config.provision.zone.ZoneFilter
    zonesIncludingSystem()
    Returns a list containing the id of all zones in this registry, including the system.

  • Method Details

    • hasZone

      boolean hasZone(com.yahoo.config.provision.zone.ZoneId zoneId)
      Returns whether the system of this registry contains the given zone

    • hasZone

      boolean hasZone(com.yahoo.config.provision.zone.ZoneId zoneId, com.yahoo.config.provision.CloudAccount cloudAccount)
      Returns whether cloudAccount in this system supports given zone

    • zones

      com.yahoo.config.provision.zone.ZoneFilter zones()
      Returns a list containing the id of all zones in this registry

    • zonesIncludingSystem

      com.yahoo.config.provision.zone.ZoneFilter zonesIncludingSystem()
      Returns a list containing the id of all zones in this registry, including the system.

    • getDefaultRegion

      Optional<com.yahoo.config.provision.RegionName> getDefaultRegion(com.yahoo.config.provision.Environment environment)
      Returns the default region for the given environment, if one is configured

    • getConfigServerVipUri

      URI getConfigServerVipUri(com.yahoo.config.provision.zone.ZoneId zoneId)
      Returns the URI for the config server VIP in the given zone

    • getVipHostname

      Optional<String> getVipHostname(com.yahoo.config.provision.zone.ZoneId zoneId)
      Returns the VIP hostname for the shared routing layer in given zone, if any

    • getDeploymentTimeToLive

      Optional<Duration> getDeploymentTimeToLive(com.yahoo.config.provision.zone.ZoneId zoneId)
      Returns the time to live for deployments in the given zone, or empty if this is infinite

    • getMonitoringSystemUri

      URI getMonitoringSystemUri(DeploymentId deploymentId)
      Returns the monitoring system URL for the given deployment

    • system

      com.yahoo.config.provision.SystemName system()
      Returns the system of this registry

    • systemZone

      com.yahoo.config.provision.zone.ZoneApi systemZone()
      Returns the system of this registry as a zone

    • getConfigServerHttpsIdentity

      com.yahoo.vespa.athenz.api.AthenzIdentity getConfigServerHttpsIdentity(com.yahoo.config.provision.zone.ZoneId zoneId)
      Return the configserver's Athenz service identity

    • getNodeAthenzIdentity

      com.yahoo.vespa.athenz.api.AthenzIdentity getNodeAthenzIdentity(com.yahoo.config.provision.zone.ZoneId zoneId, com.yahoo.config.provision.NodeType nodeType)
      Return the Athenz service identity for a given node type

    • accessControlDomain

      com.yahoo.config.provision.AthenzDomain accessControlDomain()
      Return the system Athenz domain

    • upgradePolicy

      com.yahoo.config.provision.zone.UpgradePolicy upgradePolicy()
      Returns the Vespa upgrade policy to use for zones in this registry

    • osUpgradePolicy

      com.yahoo.config.provision.zone.UpgradePolicy osUpgradePolicy(com.yahoo.config.provision.CloudName cloud)
      Returns the OS upgrade policy to use for zones belonging to given cloud, in this registry

    • osUpgradePolicies

      List<com.yahoo.config.provision.zone.UpgradePolicy> osUpgradePolicies()
      Returns all OS upgrade policies

    • routingMethod

      com.yahoo.config.provision.zone.RoutingMethod routingMethod(com.yahoo.config.provision.zone.ZoneId zone)
      Returns the routing method used by given zone

    • dashboardUrl

      URI dashboardUrl()
      Returns a URL where an informative dashboard can be found.

    • dashboardUrl

      URI dashboardUrl(com.yahoo.config.provision.TenantName id)
      Returns a URL which displays information about the given tenant.

    • dashboardUrl

      URI dashboardUrl(com.yahoo.config.provision.TenantName tenantName, com.yahoo.config.provision.ApplicationName applicationName)
      Returns a URL which displays information about the given application.

    • dashboardUrl

      URI dashboardUrl(com.yahoo.config.provision.ApplicationId id)
      Returns a URL which displays information about the given application instance.

    • dashboardUrl

      URI dashboardUrl(RunId id)
      Returns a URL which displays information about the given job run.

    • supportUrl

      URI supportUrl()
      Returns a URL used to request support from the Vespa team.

    • apiUrl

      URI apiUrl()
      Returns a URL to the controller's api endpoint

    • tenantDeveloperRoleArn

      Optional<String> tenantDeveloperRoleArn(com.yahoo.config.provision.TenantName tenant)
      IAM tenant developer role ARN

    • cloudAccountAthenzDomain

      Optional<com.yahoo.config.provision.AthenzDomain> cloudAccountAthenzDomain(com.yahoo.config.provision.CloudAccount cloudAccount)
      Returns athenz domain tied to the given cloud account, if any