summaryrefslogtreecommitdiffstats
path: root/controller-server/src/main/java/com/yahoo/vespa/hosted/controller/persistence/RoutingPolicySerializer.java
blob: 17337f823c0005f01c3fe80368de7d55bb3e0e5b (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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.vespa.hosted.controller.persistence;

import com.yahoo.config.provision.ApplicationId;
import com.yahoo.config.provision.ClusterSpec;
import com.yahoo.config.provision.HostName;
import com.yahoo.config.provision.zone.ZoneId;
import com.yahoo.slime.ArrayTraverser;
import com.yahoo.slime.Cursor;
import com.yahoo.slime.Inspector;
import com.yahoo.slime.Slime;
import com.yahoo.slime.SlimeUtils;
import com.yahoo.vespa.hosted.controller.application.EndpointId;
import com.yahoo.vespa.hosted.controller.routing.RoutingPolicy;
import com.yahoo.vespa.hosted.controller.routing.RoutingPolicyId;
import com.yahoo.vespa.hosted.controller.routing.RoutingStatus;

import java.time.Instant;
import java.util.ArrayList;
import java.util.Collections;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;

/**
 * Serializer and deserializer for a {@link RoutingPolicy}.
 *
 * @author mortent
 * @author mpolden
 */
public class RoutingPolicySerializer {

    // WARNING: Since there are multiple servers in a ZooKeeper cluster and they upgrade one by one
    //          (and rewrite all nodes on startup), changes to the serialized format must be made
    //          such that what is serialized on version N+1 can be read by version N:
    //          - ADDING FIELDS: Always ok
    //          - REMOVING FIELDS: Stop reading the field first. Stop writing it on a later version.
    //          - CHANGING THE FORMAT OF A FIELD: Don't do it bro.

    private static final String routingPoliciesField = "routingPolicies";
    private static final String clusterField = "cluster";
    private static final String canonicalNameField = "canonicalName";
    private static final String zoneField = "zone";
    private static final String dnsZoneField = "dnsZone";
    private static final String instanceEndpointsField = "rotations";
    private static final String applicationEndpointsField = "applicationEndpoints";
    private static final String loadBalancerActiveField = "active";
    private static final String globalRoutingField = "globalRouting";
    private static final String agentField = "agent";
    private static final String changedAtField = "changedAt";
    private static final String statusField = "status";

    public Slime toSlime(List<RoutingPolicy> routingPolicies) {
        var slime = new Slime();
        var root = slime.setObject();
        var policyArray = root.setArray(routingPoliciesField);
        routingPolicies.forEach(policy -> {
            var policyObject = policyArray.addObject();
            policyObject.setString(clusterField, policy.id().cluster().value());
            policyObject.setString(zoneField, policy.id().zone().value());
            policyObject.setString(canonicalNameField, policy.canonicalName().value());
            policy.dnsZone().ifPresent(dnsZone -> policyObject.setString(dnsZoneField, dnsZone));
            var instanceEndpointsArray = policyObject.setArray(instanceEndpointsField);
            policy.instanceEndpoints().forEach(endpointId -> instanceEndpointsArray.addString(endpointId.id()));
            var applicationEndpointsArray = policyObject.setArray(applicationEndpointsField);
            policy.applicationEndpoints().forEach(endpointId -> applicationEndpointsArray.addString(endpointId.id()));
            policyObject.setBool(loadBalancerActiveField, policy.status().isActive());
            globalRoutingToSlime(policy.status().routingStatus(), policyObject.setObject(globalRoutingField));
        });
        return slime;
    }

    public List<RoutingPolicy> fromSlime(ApplicationId owner, Slime slime) {
        List<RoutingPolicy> policies = new ArrayList<>();
        var root = slime.get();
        var field = root.field(routingPoliciesField);
        field.traverse((ArrayTraverser) (i, inspect) -> {
            Set<EndpointId> instanceEndpoints = new LinkedHashSet<>();
            inspect.field(instanceEndpointsField).traverse((ArrayTraverser) (j, endpointId) -> instanceEndpoints.add(EndpointId.of(endpointId.asString())));
            Set<EndpointId> applicationEndpoints = new LinkedHashSet<>();
            inspect.field(applicationEndpointsField).traverse((ArrayTraverser) (idx, endpointId) -> applicationEndpoints.add(EndpointId.of(endpointId.asString())));
            RoutingPolicyId id = new RoutingPolicyId(owner,
                                                     ClusterSpec.Id.from(inspect.field(clusterField).asString()),
                                                     ZoneId.from(inspect.field(zoneField).asString()));
            policies.add(new RoutingPolicy(id,
                                           HostName.from(inspect.field(canonicalNameField).asString()),
                                           SlimeUtils.optionalString(inspect.field(dnsZoneField)),
                                           instanceEndpoints,
                                           applicationEndpoints,
                                           new RoutingPolicy.Status(inspect.field(loadBalancerActiveField).asBool(),
                                                                    globalRoutingFromSlime(inspect.field(globalRoutingField)))));
        });
        return Collections.unmodifiableList(policies);
    }

    public void globalRoutingToSlime(RoutingStatus routingStatus, Cursor object) {
        object.setString(statusField, routingStatus.value().name());
        object.setString(agentField, routingStatus.agent().name());
        object.setLong(changedAtField, routingStatus.changedAt().toEpochMilli());
    }

    public RoutingStatus globalRoutingFromSlime(Inspector object) {
        var status = RoutingStatus.Value.valueOf(object.field(statusField).asString());
        var agent = RoutingStatus.Agent.valueOf(object.field(agentField).asString());
        var changedAt = SlimeUtils.optionalInstant(object.field(changedAtField)).orElse(Instant.EPOCH);
        return new RoutingStatus(status, agent, changedAt);
    }

}