clustercontroller-core/src/main/java/com/yahoo/vespa/clustercontroller/core/ClusterStateDeriver.java


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.vespa.clustercontroller.core;

/**
 * Bucket-space aware transformation factory to "derive" new cluster states from an
 * existing state.
 */
public interface ClusterStateDeriver {
    /**
     * @param state Baseline cluster state used as a source for deriving a new state.
     *              MUST NOT be modified explicitly or implicitly.
     * @param bucketSpace The name of the bucket space for which the state should be derived
     * @return A cluster state instance representing the derived state, or <em>state</em> unchanged.
     */
    AnnotatedClusterState derivedFrom(AnnotatedClusterState state, String bucketSpace);
}