io.strimzi.api.annotations.KubeVersion Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of crd-annotations Show documentation
There is a newer version: 0.45.0
/*
 * Copyright Strimzi authors.
 * License: Apache License 2.0 (see the file LICENSE or http://apache.org/licenses/LICENSE-2.0.html).
 */
package io.strimzi.api.annotations;

import java.util.Objects;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import static java.lang.Short.parseShort;

/**
 * Represents a Kubernetes version number and embeds some knowledge of the features available in
 * different Kubernetes versions.
 */
public class KubeVersion implements Comparable {

    public static final KubeVersion V1_11 = new KubeVersion((short) 1, (short) 11);
    public static final KubeVersion V1_12 = new KubeVersion((short) 1, (short) 12);
    public static final KubeVersion V1_13 = new KubeVersion((short) 1, (short) 13);
    public static final KubeVersion V1_14 = new KubeVersion((short) 1, (short) 14);
    public static final KubeVersion V1_15 = new KubeVersion((short) 1, (short) 15);
    public static final KubeVersion V1_16 = new KubeVersion((short) 1, (short) 16);
    public static final KubeVersion V1_17 = new KubeVersion((short) 1, (short) 17);
    public static final KubeVersion V1_18 = new KubeVersion((short) 1, (short) 18);
    public static final KubeVersion V1_19 = new KubeVersion((short) 1, (short) 19);

    public static final VersionRange V1_11_PLUS = KubeVersion.parseRange("1.11+");
    public static final VersionRange V1_16_PLUS = KubeVersion.parseRange("1.16+");

    private final short major;
    private final short minor;

    private KubeVersion(short major, short minor) {
        this.major = major;
        this.minor = minor;
    }

    public static KubeVersion parse(String version) {
        Pattern pattern = Pattern.compile("([0-9]+).([0-9]+)");
        Matcher matcher = pattern.matcher(version);
        if (!matcher.matches()) {
            throw new IllegalArgumentException("Invalid kube version");
        }
        return new KubeVersion(parseShort(matcher.group(1)), parseShort(matcher.group(2)));
    }

    public static VersionRange parseRange(String range) {
        return VersionRange.parse(range, KubeVersion::parse);
    }

    @Override
    public int compareTo(KubeVersion o) {
        int cmp = Short.compare(major, o.major);
        if (cmp == 0) {
            cmp = Short.compare(minor, o.minor);
        }
        return cmp;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        KubeVersion that = (KubeVersion) o;
        return major == that.major &&
                minor == that.minor;
    }

    @Override
    public int hashCode() {
        return Objects.hash(major, minor);
    }

    @Override
    public String toString() {
        return major + "." + minor;
    }

    public boolean supportsSchemaPerVersion() {
        return this.compareTo(V1_16) >= 0;
    }

    public static boolean supportsSchemaPerVersion(VersionRange versionRange) {
        if (versionRange.isEmpty() || versionRange.isAll()) {
            return false;
        } else {
            return versionRange.lower().supportsSchemaPerVersion()
                    && (versionRange.upper() == null
                    || versionRange.upper().supportsSchemaPerVersion());
        }
    }

    /**
     * Does this version of Kubernetes support the given API version of CustomResourceDefinition?
     * @param crdApiVersion The CustomResourceDefinition API version
     * @return Whether this version of Kube has support
     */
    public boolean supportsCrdApiVersion(ApiVersion crdApiVersion) {
        return crdApiVersion.equals(ApiVersion.V1) ? this.compareTo(V1_16) >= 0 : this.compareTo(V1_11) >= 0;
    }
}