summaryrefslogtreecommitdiffstats
path: root/controller-api/src/main/java/com/yahoo/vespa/hosted/controller/api/integration/zone/ZoneRegistry.java
blob: af7c464b8d70338c6eb00761adf2071835e5d7bf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
// Copyright 2017 Yahoo Holdings. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.vespa.hosted.controller.api.integration.zone;

import com.yahoo.config.provision.ApplicationId;
import com.yahoo.config.provision.Environment;
import com.yahoo.config.provision.RegionName;
import com.yahoo.config.provision.SystemName;
import com.yahoo.config.provision.ZoneId;
import com.yahoo.vespa.hosted.controller.api.identifiers.DeploymentId;

import java.net.URI;
import java.time.Duration;
import java.util.List;
import java.util.Optional;

/**
 * Provides information about zones in a hosted Vespa system.
 *
 * @author mpolden
 */
public interface ZoneRegistry {

    /** Returns whether the system of this registry contains the given zone. */
    boolean hasZone(ZoneId zoneId);

    /** Returns a list containing the id of all zones in this registry. */
    List<ZoneId> zones();

    /** Returns the default region for the given environment, if one is configured. */
    Optional<RegionName> getDefaultRegion(Environment environment);

    /** Returns a list with all known config servers in the given zone.
     *
     * @deprecated Use {@link #getConfigServerSecureUris(ZoneId)} instead (requires that client trusts Athenz CA)
     */
    @Deprecated
    List<URI> getConfigServerUris(ZoneId zoneId);

    /** Returns a list with all known config servers in the given zone, with a secure connection URL. */
    List<URI> getConfigServerSecureUris(ZoneId zoneId);

    /** Returns a URL with the logs for the given deployment, if loggin is configured for its zone. */
    Optional<URI> getLogServerUri(DeploymentId deploymentId);

    /** Returns the time to live for deployments in the given zone, or empty if this is infinite. */
    Optional<Duration> getDeploymentTimeToLive(ZoneId zoneId);

    /** Returns a URL pointing at monitoring resources for the given deployment. */
    URI getMonitoringSystemUri(DeploymentId deploymentId);

    /** Returns the URL of the dashboard for the system of this registry. */
    URI getDashboardUri();

    /** Returns the system of this registry. */
    SystemName system();

}