io.fabric8.maven.core.util

Class KubernetesResourceUtil

java.lang.Object

io.fabric8.maven.core.util.KubernetesResourceUtil

public class KubernetesResourceUtil
extends Object

Utility class for handling Kubernetes resource descriptors

Since:

02/05/16

Author:

roland

Field Summary

Fields

Modifier and Type	Field and Description
static String	API_EXTENSIONS_VERSION
static String	API_VERSION

Constructor Summary

Constructors

Constructor and Description
KubernetesResourceUtil()

Method Summary

Modifier and Type	Method and Description
static boolean	addPort(List<io.fabric8.kubernetes.api.model.ContainerPort> ports, String portNumberText, String portName, io.fabric8.maven.docker.util.Logger log)
static boolean	checkForKind(io.fabric8.kubernetes.api.model.KubernetesListBuilder builder, String... kinds)
static String	extractContainerName(org.apache.maven.project.MavenProject project, io.fabric8.maven.docker.config.ImageConfiguration imageConfig)
static <T> T	findResourceByName(Iterable<io.fabric8.kubernetes.api.model.HasMetadata> entities, Class<T> clazz, String name) Returns the resource of the given kind and name from the collection or null
static String	getBuildStatusPhase(io.fabric8.openshift.api.model.Build build)
static String	getBuildStatusReason(io.fabric8.openshift.api.model.Build build)
static Date	getCreationTimestamp(io.fabric8.kubernetes.api.model.HasMetadata hasMetadata)
static String	getDockerContainerID(io.fabric8.kubernetes.api.model.Pod pod)
static String	getEnvVar(List<io.fabric8.kubernetes.api.model.EnvVar> envVarList, String name, String defaultValue)
static String	getNameWithSuffix(String name, String kind)
static io.fabric8.kubernetes.api.model.Pod	getNewestPod(Collection<io.fabric8.kubernetes.api.model.Pod> pods)
static io.fabric8.kubernetes.api.model.HasMetadata	getResource(String defaultApiVersion, String apiExtensionsVersion, File file, String appName) Read a Kubernetes resource fragment and add meta information extracted from the filename to the resource descriptor.
static void	handleKubernetesClientException(io.fabric8.kubernetes.client.KubernetesClientException e, io.fabric8.maven.docker.util.Logger logger)
static boolean	isNewerResource(io.fabric8.kubernetes.api.model.HasMetadata newer, io.fabric8.kubernetes.api.model.HasMetadata older)
static File[]	listResourceFragments(File resourceDir)
static boolean	podHasContainerImage(io.fabric8.kubernetes.api.model.Pod pod, String imageName)
static io.fabric8.kubernetes.api.model.KubernetesListBuilder	readResourceFragmentsFrom(String apiVersion, String apiExtensionsVersion, String defaultName, File[] resourceFiles) Read all Kubernetes resource fragments from a directory and create a KubernetesListBuilder which can be adapted later.
static Map<String,String>	removeVersionSelector(Map<String,String> selector)
static boolean	setEnvVar(List<io.fabric8.kubernetes.api.model.EnvVar> envVarList, String name, String value)
static String	toJson(Object resource)
static String	toYaml(Object resource)
static void	validateKubernetesMasterUrl(URL masterUrl)
static void	watchLogInThread(io.fabric8.kubernetes.client.dsl.LogWatch logWatcher, String failureMessage, CountDownLatch terminateLatch, io.fabric8.maven.docker.util.Logger log)
static File	writeResource(Object resource, File target, ResourceFileType resourceFileType)
static File	writeResourceFile(Object resource, File outputFile, ResourceFileType resourceFileType)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

API_VERSION

public static final String API_VERSION

See Also:

Constant Field Values

API_EXTENSIONS_VERSION

public static final String API_EXTENSIONS_VERSION

See Also:

Constant Field Values

Constructor Detail

KubernetesResourceUtil

public KubernetesResourceUtil()

Method Detail

readResourceFragmentsFrom

public static io.fabric8.kubernetes.api.model.KubernetesListBuilder readResourceFragmentsFrom(String apiVersion,
                                                                                              String apiExtensionsVersion,
                                                                                              String defaultName,
                                                                                              File[] resourceFiles)
                                                                                       throws IOException

Read all Kubernetes resource fragments from a directory and create a KubernetesListBuilder which can be adapted later.

Parameters:

apiVersion - the api version to use

apiExtensionsVersion - the extension version to use

defaultName - the default name to use when none is given

appResourcesOnly - if only resource with the defaultName should be returned ?

resourceFiles - files to add.

Returns:

the list builder

Throws:

IOException

getResource

public static io.fabric8.kubernetes.api.model.HasMetadata getResource(String defaultApiVersion,
                                                                      String apiExtensionsVersion,
                                                                      File file,
                                                                      String appName)
                                                               throws IOException

Read a Kubernetes resource fragment and add meta information extracted from the filename to the resource descriptor. I.e. the following elements are added if not provided in the fragment:

• name - Name of the resource added to metadata
• kind - Resource's kind
• apiVersion - API version (given as parameter to this method)

Parameters:

defaultApiVersion - the API version to add if not given.

apiExtensionsVersion - the API version for extensions

file - file to read, whose name must match FILENAME_PATTERN. @return map holding the fragment

appName - resource name specifying resources belonging to this application

Throws:

IOException

toYaml

public static String toYaml(Object resource)
                     throws com.fasterxml.jackson.core.JsonProcessingException

Throws:

com.fasterxml.jackson.core.JsonProcessingException

toJson

public static String toJson(Object resource)
                     throws com.fasterxml.jackson.core.JsonProcessingException

Throws:

com.fasterxml.jackson.core.JsonProcessingException

writeResource

public static File writeResource(Object resource,
                                 File target,
                                 ResourceFileType resourceFileType)
                          throws IOException

Throws:

IOException

writeResourceFile

public static File writeResourceFile(Object resource,
                                     File outputFile,
                                     ResourceFileType resourceFileType)
                              throws IOException

Throws:

IOException

listResourceFragments

public static File[] listResourceFragments(File resourceDir)

getNameWithSuffix

public static String getNameWithSuffix(String name,
                                       String kind)

extractContainerName

public static String extractContainerName(org.apache.maven.project.MavenProject project,
                                          io.fabric8.maven.docker.config.ImageConfiguration imageConfig)

removeVersionSelector

public static Map<String,String> removeVersionSelector(Map<String,String> selector)

checkForKind

public static boolean checkForKind(io.fabric8.kubernetes.api.model.KubernetesListBuilder builder,
                                   String... kinds)

addPort

public static boolean addPort(List<io.fabric8.kubernetes.api.model.ContainerPort> ports,
                              String portNumberText,
                              String portName,
                              io.fabric8.maven.docker.util.Logger log)

setEnvVar

public static boolean setEnvVar(List<io.fabric8.kubernetes.api.model.EnvVar> envVarList,
                                String name,
                                String value)

getEnvVar

public static String getEnvVar(List<io.fabric8.kubernetes.api.model.EnvVar> envVarList,
                               String name,
                               String defaultValue)

validateKubernetesMasterUrl

public static void validateKubernetesMasterUrl(URL masterUrl)
                                        throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

handleKubernetesClientException

public static void handleKubernetesClientException(io.fabric8.kubernetes.client.KubernetesClientException e,
                                                   io.fabric8.maven.docker.util.Logger logger)
                                            throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

findResourceByName

public static <T> T findResourceByName(Iterable<io.fabric8.kubernetes.api.model.HasMetadata> entities,
                                       Class<T> clazz,
                                       String name)

Returns the resource of the given kind and name from the collection or null

getBuildStatusPhase

public static String getBuildStatusPhase(io.fabric8.openshift.api.model.Build build)

getBuildStatusReason

public static String getBuildStatusReason(io.fabric8.openshift.api.model.Build build)

watchLogInThread

public static void watchLogInThread(io.fabric8.kubernetes.client.dsl.LogWatch logWatcher,
                                    String failureMessage,
                                    CountDownLatch terminateLatch,
                                    io.fabric8.maven.docker.util.Logger log)

getNewestPod

public static io.fabric8.kubernetes.api.model.Pod getNewestPod(Collection<io.fabric8.kubernetes.api.model.Pod> pods)

getCreationTimestamp

public static Date getCreationTimestamp(io.fabric8.kubernetes.api.model.HasMetadata hasMetadata)

podHasContainerImage

public static boolean podHasContainerImage(io.fabric8.kubernetes.api.model.Pod pod,
                                           String imageName)

getDockerContainerID

public static String getDockerContainerID(io.fabric8.kubernetes.api.model.Pod pod)

isNewerResource

public static boolean isNewerResource(io.fabric8.kubernetes.api.model.HasMetadata newer,
                                      io.fabric8.kubernetes.api.model.HasMetadata older)