Fix Kind extension to generate manifests

annotations/kind-annotations/pom.xml

@@ -43,7 +43,12 @@ limitations under the License.
       <artifactId>docker-annotations</artifactId>
       <version>${project.version}</version>
     </dependency>
-   <dependency>
+    <dependency>
+      <groupId>io.dekorate</groupId>
+      <artifactId>kubernetes-annotations</artifactId>
+      <version>${project.version}</version>
+    </dependency>
+    <dependency>
       <groupId>io.sundr</groupId>
       <artifactId>builder-annotations</artifactId>
       <scope>compile</scope>
@@ -60,7 +65,7 @@ limitations under the License.
       <artifactId>sundr-codegen-velocity</artifactId>
       <scope>compile</scope>
       <optional>true</optional>
-    </dependency> 
+    </dependency>
     <dependency>
       <groupId>io.dekorate</groupId>
       <artifactId>dekorate-templates</artifactId>
@@ -115,7 +120,7 @@ limitations under the License.
           </annotationProcessors>
         </configuration>
       </plugin>
-       <plugin>
+      <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-shade-plugin</artifactId>
         <version>${version.maven-shade-plugin}</version>
@@ -138,7 +143,7 @@ limitations under the License.
                 <filter>
                   <artifact>*:*</artifact>
                   <includes>
-                    <include>io/dekorate/kubernetes/annotation/**</include>
+                    <include>io/dekorate/kind/annotation/**</include>
                     <include>META-INF/MANIFEST.MF</include>
                   </includes>
                 </filter>
@@ -158,14 +163,14 @@ limitations under the License.
                 <filter>
                   <artifact>*:*</artifact>
                   <includes>
-                    <include>io/dekorate/kubernetes/adapter/**</include>
-                    <include>io/dekorate/kubernetes/apt/**</include>
-                    <include>io/dekorate/kubernetes/config/**</include>
-                    <include>io/dekorate/kubernetes/configurator/**</include>
-                    <include>io/dekorate/kubernetes/decorator/**</include>
-                    <include>io/dekorate/kubernetes/manifest/**</include>
-                    <include>io/dekorate/kubernetes/hook/**</include>
-                    <include>io/dekorate/kubernetes/listener/**</include>
+                    <include>io/dekorate/kind/adapter/**</include>
+                    <include>io/dekorate/kind/apt/**</include>
+                    <include>io/dekorate/kind/config/**</include>
+                    <include>io/dekorate/kind/configurator/**</include>
+                    <include>io/dekorate/kind/decorator/**</include>
+                    <include>io/dekorate/kind/manifest/**</include>
+                    <include>io/dekorate/kind/hook/**</include>
+                    <include>io/dekorate/kind/listener/**</include>
                     <include>META-INF/services/*</include>
                     <include>META-INF/MANIFEST.MF</include>
                   </includes>
@@ -186,14 +191,14 @@ limitations under the License.
                 <filter>
                   <artifact>*:*</artifact>
                   <includes>
-                    <include>io/dekorate/kubernetes/adapter/**</include>
-                    <include>io/dekorate/kubernetes/annotation/**</include>
-                    <include>io/dekorate/kubernetes/config/**</include>
-                    <include>io/dekorate/kubernetes/configurator/**</include>
-                    <include>io/dekorate/kubernetes/decorator/**</include>
-                    <include>io/dekorate/kubernetes/manifest/**</include>
-                    <include>io/dekorate/kubernetes/hook/**</include>
-                    <include>io/dekorate/kubernetes/listener/**</include>
+                    <include>io/dekorate/kind/adapter/**</include>
+                    <include>io/dekorate/kind/annotation/**</include>
+                    <include>io/dekorate/kind/config/**</include>
+                    <include>io/dekorate/kind/configurator/**</include>
+                    <include>io/dekorate/kind/decorator/**</include>
+                    <include>io/dekorate/kind/manifest/**</include>
+                    <include>io/dekorate/kind/hook/**</include>
+                    <include>io/dekorate/kind/listener/**</include>
                     <include>META-INF/services/io.dekorate.*</include>
                     <include>META-INF/MANIFEST.MF</include>
                   </includes>
@@ -203,6 +208,6 @@ limitations under the License.
           </execution>
         </executions>
       </plugin>
-   </plugins>
+    </plugins>
   </build>
 </project>

annotations/kind-annotations/src/main/java/io/dekorate/kind/annotation/Kind.java

@@ -20,17 +20,25 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import io.dekorate.kubernetes.annotation.ImagePullPolicy;
 import io.dekorate.kubernetes.config.BaseConfig;
 import io.sundr.builder.annotations.Adapter;
 import io.sundr.builder.annotations.Buildable;
 import io.sundr.builder.annotations.Pojo;
 
 @Buildable(builderPackage = "io.fabric8.kubernetes.api.builder")
-@Pojo(name = "KindLoadConfig", relativePath = "../config", autobox = true, mutable = true, superClass = BaseConfig.class, withStaticBuilderMethod = true, withStaticAdapterMethod = false, adapter = @Adapter(name = "KindLoadConfigAdapter", relativePath = "../adapter", withMapAdapterMethod = true))
+@Pojo(name = "KindConfig", relativePath = "../config", autobox = true, mutable = true, superClass = BaseConfig.class, withStaticBuilderMethod = true, withStaticAdapterMethod = false, adapter = @Adapter(name = "KindConfigAdapter", relativePath = "../adapter", withMapAdapterMethod = true))
 @Target({ ElementType.CONSTRUCTOR, ElementType.TYPE })
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Kind {
 
   boolean enabled() default true;
 
+  /**
+   * Image pull policy.
+   *
+   * @return The image pull policy.
+   */
+  ImagePullPolicy imagePullPolicy() default ImagePullPolicy.IfNotPresent;
+
 }

annotations/kind-annotations/src/main/java/io/dekorate/kind/apt/KindAnnotationProcessor.java

@@ -15,36 +15,37 @@
  */
 package io.dekorate.kind.apt;
 
+import static io.dekorate.kind.config.KindConfigGenerator.KIND;
+
+import java.util.HashSet;
 import java.util.Set;
 
 import javax.annotation.processing.RoundEnvironment;
 import javax.annotation.processing.SupportedAnnotationTypes;
 import javax.lang.model.element.Element;
 import javax.lang.model.element.TypeElement;
 
-import io.dekorate.Logger;
-import io.dekorate.LoggerFactory;
-import io.dekorate.doc.Description;
 import io.dekorate.kind.annotation.Kind;
 import io.dekorate.processor.AbstractAnnotationProcessor;
 
-@Description("Generates kubernetes manifests.")
 @SupportedAnnotationTypes("io.dekorate.kind.annotation.Kind")
 public class KindAnnotationProcessor extends AbstractAnnotationProcessor {
 
-  private final Logger LOGGER = LoggerFactory.getLogger();
-
   public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
     if (roundEnv.processingOver()) {
       getSession().close();
       return true;
     }
+    Set<Element> mainClasses = new HashSet<>();
     for (TypeElement typeElement : annotations) {
       for (Element mainClass : roundEnv.getElementsAnnotatedWith(typeElement)) {
-        LOGGER.info("Found @Kind on: " + mainClass.toString());
-        process("kind", mainClass, Kind.class);
+        mainClasses.add(mainClass);
       }
     }
+
+    for (Element mainClass : mainClasses) {
+      process(KIND, mainClass, Kind.class);
+    }
     return false;
   }
 }

annotations/kind-annotations/src/main/java/io/dekorate/kind/config/DefaultKindConfigGenerator.java

@@ -25,7 +25,7 @@ public class DefaultKindConfigGenerator implements KindConfigGenerator {
   public DefaultKindConfigGenerator(ConfigurationRegistry configurationRegistry) {
     this.configurationRegistry = configurationRegistry;
     this.configurationRegistry.add(new ApplyKindImageAutoloadConfiguration());
-    add(new DefaultConfiguration<KindLoadConfig>(KindLoadConfig.newKindLoadConfigBuilderFromDefaults()));
+    add(new DefaultConfiguration<KindConfig>(KindConfig.newKindConfigBuilderFromDefaults()));
   }
 
   @Override

annotations/kind-annotations/src/main/java/io/dekorate/kind/config/KindConfigGenerator.java

@@ -22,7 +22,7 @@
 import io.dekorate.config.AnnotationConfiguration;
 import io.dekorate.config.ConfigurationSupplier;
 import io.dekorate.config.PropertyConfiguration;
-import io.dekorate.kind.adapter.KindLoadConfigAdapter;
+import io.dekorate.kind.adapter.KindConfigAdapter;
 import io.dekorate.kubernetes.config.Configuration;
 
 public interface KindConfigGenerator extends ConfigurationGenerator, WithProject {
@@ -34,20 +34,20 @@ default String getKey() {
   }
 
   default Class<? extends Configuration> getConfigType() {
-    return KindLoadConfig.class;
+    return KindConfig.class;
   }
 
   @Override
   default void addAnnotationConfiguration(Map map) {
-    add(new AnnotationConfiguration<>(KindLoadConfigAdapter.newBuilder(propertiesMap(map, KindLoadConfig.class))));
+    add(new AnnotationConfiguration<>(KindConfigAdapter.newBuilder(propertiesMap(map, KindConfig.class))));
   }
 
   @Override
   default void addPropertyConfiguration(Map map) {
-    add(new PropertyConfiguration<>(KindLoadConfigAdapter.newBuilder(propertiesMap(map, KindLoadConfig.class))));
+    add(new PropertyConfiguration<>(KindConfigAdapter.newBuilder(propertiesMap(map, KindConfig.class))));
   }
 
-  default void add(ConfigurationSupplier<KindLoadConfig> config) {
+  default void add(ConfigurationSupplier<KindConfig> config) {
     getConfigurationRegistry().add(config);
   }
 }

annotations/kind-annotations/src/main/java/io/dekorate/kind/manifest/KindManifestGenerator.java

@@ -0,0 +1,50 @@
+package io.dekorate.kind.manifest;
+
+import io.dekorate.ConfigurationRegistry;
+import io.dekorate.ResourceRegistry;
+import io.dekorate.kind.config.KindConfig;
+import io.dekorate.kubernetes.config.KubernetesConfig;
+import io.dekorate.kubernetes.decorator.AddServiceResourceDecorator;
+import io.dekorate.kubernetes.decorator.ApplyImagePullPolicyDecorator;
+import io.dekorate.kubernetes.manifest.KubernetesManifestGenerator;
+
+public class KindManifestGenerator extends KubernetesManifestGenerator {
+
+  private static final String KIND = "kind";
+
+  public KindManifestGenerator() {
+    this(new ResourceRegistry(), new ConfigurationRegistry());
+  }
+
+  public KindManifestGenerator(ResourceRegistry resourceRegistry, ConfigurationRegistry configurationRegistry) {
+    super(resourceRegistry, configurationRegistry);
+  }
+
+  @Override
+  public int order() {
+    return 400;
+  }
+
+  @Override
+  public String getKey() {
+    return KIND;
+  }
+
+  @Override
+  protected void addDecorators(String group, KubernetesConfig config) {
+    super.addDecorators(group, config);
+    if (config.getPorts().length > 0) {
+      resourceRegistry.decorate(group, new AddServiceResourceDecorator(config));
+    }
+  }
+
+  @Override
+  public void generate(KubernetesConfig kubernetesConfig) {
+    initializeRegistry(kubernetesConfig);
+    addDecorators(KIND, kubernetesConfig);
+
+    configurationRegistry.get(KindConfig.class).ifPresent(c -> {
+      resourceRegistry.decorate(KIND, new ApplyImagePullPolicyDecorator(kubernetesConfig.getName(), c.getImagePullPolicy()));
+    });
+  }
+}

annotations/kind-annotations/src/main/java/io/dekorate/kind/manifest/KindManifestGeneratorFactory.java

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2018 The original authors.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * 
+**/
+
+package io.dekorate.kind.manifest;
+
+import io.dekorate.ConfigurationRegistry;
+import io.dekorate.ManifestGeneratorFactory;
+import io.dekorate.ResourceRegistry;
+
+public class KindManifestGeneratorFactory implements ManifestGeneratorFactory {
+
+  public KindManifestGenerator create(ResourceRegistry resourceRegistry, ConfigurationRegistry configurationRegistry) {
+    return new KindManifestGenerator(resourceRegistry, configurationRegistry);
+  }
+}

annotations/kind-annotations/src/main/resources/META-INF/services/io.dekorate.ManifestGeneratorFactory

@@ -0,0 +1 @@
+io.dekorate.kind.manifest.KindManifestGeneratorFactory

docs/_data/sidebar.yml

@@ -21,6 +21,8 @@
         url: /docs/openshift
       - title: Minikube
         url: /docs/minikube
+      - title: Kind
+        url: /docs/kind
       - title: Tekton
         url: /docs/tekton
       - title: Helm

docs/documentation/kind.md

@@ -0,0 +1,45 @@
+---
+title: Kind
+description: Kind
+layout: docs
+permalink: /docs/kind
+---
+
+### Kind
+
+[@Kind](https://raw.githubusercontent.com/dekorateio/dekorate/main/annotations/kind-annotations/src/main/java/io/dekorate/kind/annotation/Kind.java) is a more specialized form of [@KubernetesApplication](https://raw.githubusercontent.com/dekorateio/dekorate/main/annotations/kubernetes-annotations/src/main/java/io/dekorate/kubernetes/annotation/KubernetesApplication.java).
+It can be added to your project like:
+
+```java
+import io.dekorate.kind.annotation.Kind;
+
+@Kind
+public class Main {
+
+    public static void main(String[] args) {
+      //Your application code goes here.
+    }
+}
+```
+
+When the project gets compiled, the annotation will trigger the generation of a `Deployment` in both `kind.json` and `kind.yml` that
+will end up under 'target/classes/META-INF/dekorate'. Also, if the deployment is enabled, it will automate the process of loading images to the cluster
+when performing container image builds.
+
+#### Adding the kind annotation processor to the classpath
+
+This module can be added to the project using:
+
+```xml
+<dependency>
+  <groupId>io.dekorate</groupId>
+  <artifactId>kind-annotations</artifactId>
+  <version>{{site.data.project.release.current-version}}</version>
+</dependency>
+```
+
+The `@Kind` annotation can be used in combination with `@KubernetesApplication`. In that case the `@Kind` configuration will be replaced by the one specified using `@KubernetesApplication`.
+
+**REMINDER**: A complete reference on all the supported properties can be found in the [configuration options guide]({{site.baseurl}}/configuration-guide).
+
+Check the Kind example [here](https://github.com/dekorateio/dekorate/tree/main/examples/kind-example).

examples/kind-example/Dockerfile

@@ -0,0 +1,4 @@
+FROM openjdk:8u171-alpine3.7
+RUN apk --no-cache add curl
+COPY target/*.jar kind-example.jar
+CMD java ${JAVA_OPTS} -jar kind-example.jar