| {"componentChunkName":"component---src-templates-main-jsx","path":"/docs/migration-guide/","result":{"data":{"markdownRemark":{"html":"<div class=\"hero\">\n<div class=\"hero-content\">\n<h1 id=\"documentation\" style=\"position:relative;\"><a href=\"#documentation\" aria-label=\"documentation permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Documentation</h1>\n</div>\n</div>\n<h2 id=\"migration-guide-for-projects-using-fabric8-maven-plugin-to-eclipse-jkube\" style=\"position:relative;\"><a href=\"#migration-guide-for-projects-using-fabric8-maven-plugin-to-eclipse-jkube\" aria-label=\"migration guide for projects using fabric8 maven plugin to eclipse jkube permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Migration Guide for projects using Fabric8 Maven Plugin to Eclipse JKube</h2>\n<p>For any project currently using <a href=\"https://github.com/fabric8io/fabric8-maven-plugin\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Fabric8 Maven Plugin (FMP)</a>,\nmigrating to Eclipse JKube is as simple as running a Maven command.</p>\n<p>FMP used to handle both Kubernetes and OpenShift clusters but Eclipse JKube has separate plugins for these two different\nenvironments.</p>\n<h3 id=\"projects-targeting-kubernetes-clusters\" style=\"position:relative;\"><a href=\"#projects-targeting-kubernetes-clusters\" aria-label=\"projects targeting kubernetes clusters permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Projects targeting Kubernetes Clusters</h3>\n<p>Run the following command in you project's root directory:</p>\n<div class=\"gatsby-highlight\" data-language=\"shellscript\"><pre class=\"language-shellscript\"><code class=\"language-shellscript\">mvn org.eclipse.jkube:kubernetes-maven-plugin:migrate</code></pre></div>\n<p>Maven coordinates in your <code class=\"language-text\">pom.xml</code> will change from <code class=\"language-text\">io.fabric8:fabric8-maven-plugin</code> to\n<code class=\"language-text\">org.eclipse.jkube:kubernetes-maven-plugin</code> for every <code class=\"language-text\"><plugin></code> entry.</p>\n<h3 id=\"projects-targeting-openshift-clusters\" style=\"position:relative;\"><a href=\"#projects-targeting-openshift-clusters\" aria-label=\"projects targeting openshift clusters permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Projects targeting OpenShift Clusters</h3>\n<p>Run the following command in you project's root directory:</p>\n<div class=\"gatsby-highlight\" data-language=\"shellscript\"><pre class=\"language-shellscript\"><code class=\"language-shellscript\">mvn org.eclipse.jkube:openshift-maven-plugin:migrate</code></pre></div>\n<p>Maven coordinates in your <code class=\"language-text\">pom.xml</code> will change from <code class=\"language-text\">io.fabric8:fabric8-maven-plugin</code> to\n<code class=\"language-text\">org.eclipse.jkube:openshift-maven-plugin</code> for every <code class=\"language-text\"><plugin></code> entry.</p>\n<h3 id=\"xml-configuration-and-maven-properties\" style=\"position:relative;\"><a href=\"#xml-configuration-and-maven-properties\" aria-label=\"xml configuration and maven properties permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>XML configuration and Maven properties</h3>\n<p>FMP specific Maven properties <code class=\"language-text\"><fabric8.*</code> will be automatically renamed to Eclipse JKube analogous\nproperties <code class=\"language-text\"><jkube.*</code>.</p>\n<p>Mojo XML configuration element tag names will also be automatically renamed to the Eclipse JKube\nequivalent.</p>\n<h3 id=\"resource-fragments\" style=\"position:relative;\"><a href=\"#resource-fragments\" aria-label=\"resource fragments permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Resource Fragments</h3>\n<p>If you want to customize Kubernetes manifests added by FMP by means other than XML configuration,\nyou usually add your resources to <code class=\"language-text\">src/main/fabric8</code> directory and FMP picks these up during enrichment\nprocess and merges them along with the default generated resources.</p>\n<p>Eclipse JKube's <code class=\"language-text\">migrate</code> Maven goal will also take care of renaming your project's <code class=\"language-text\">src/main/fabric8</code>\nfragment directory to <code class=\"language-text\">src/main/jkube</code></p>\n<h3 id=\"image-configuration-for-docker-builds\" style=\"position:relative;\"><a href=\"#image-configuration-for-docker-builds\" aria-label=\"image configuration for docker builds permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Image Configuration for Docker builds</h3>\n<p>Projects relying on FMP's <code class=\"language-text\">ImageConfiguration</code> model for building docker images don't need any change in\nEclipse JKube's XML configuration.</p>\n<p>For example, let's consider this simple project's plugin configuration:</p>\n<h5 id=\"fabric8-maven-plugin-image-configuration\" style=\"position:relative;\"><a href=\"#fabric8-maven-plugin-image-configuration\" aria-label=\"fabric8 maven plugin image configuration permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Fabric8 Maven Plugin Image Configuration</h5>\n<div class=\"gatsby-highlight\" data-language=\"xml\"><pre class=\"language-xml\"><code class=\"language-xml\"><span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>plugin</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>groupId</span><span class=\"token punctuation\">></span></span>io.fabric8<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>groupId</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>artifactId</span><span class=\"token punctuation\">></span></span>fabric8-maven-plugin<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>artifactId</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>configuration</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>images</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>image</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>name</span><span class=\"token punctuation\">></span></span>%g/helloworld-java:%l<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>name</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>alias</span><span class=\"token punctuation\">></span></span>hello-world<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>alias</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>build</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>from</span><span class=\"token punctuation\">></span></span>openjdk:latest<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>from</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>assembly</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>descriptorRef</span><span class=\"token punctuation\">></span></span>artifact<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>descriptorRef</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>assembly</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>cmd</span><span class=\"token punctuation\">></span></span>java -jar maven/${project.name}-${project.version}.jar<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>cmd</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>build</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>run</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>wait</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>log</span><span class=\"token punctuation\">></span></span>Hello World!<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>log</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>wait</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>run</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>image</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>images</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>configuration</span><span class=\"token punctuation\">></span></span>\n<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>plugin</span><span class=\"token punctuation\">></span></span></code></pre></div>\n<h5 id=\"eclipse-jkube-image-configuration\" style=\"position:relative;\"><a href=\"#eclipse-jkube-image-configuration\" aria-label=\"eclipse jkube image configuration permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Eclipse JKube Image Configuration</h5>\n<div class=\"gatsby-highlight\" data-language=\"xml\"><pre class=\"language-xml\"><code class=\"language-xml\"><span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>plugin</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>groupId</span><span class=\"token punctuation\">></span></span>org.eclipse.jkube<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>groupId</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>artifactId</span><span class=\"token punctuation\">></span></span>kubernetes-maven-plugin<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>artifactId</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>configuration</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>images</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>image</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>name</span><span class=\"token punctuation\">></span></span>%g/helloworld-java:%l<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>name</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>alias</span><span class=\"token punctuation\">></span></span>hello-world<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>alias</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>build</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>from</span><span class=\"token punctuation\">></span></span>openjdk:latest<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>from</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>assembly</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>descriptorRef</span><span class=\"token punctuation\">></span></span>artifact<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>descriptorRef</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>assembly</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>cmd</span><span class=\"token punctuation\">></span></span>java -jar maven/${project.name}-${project.version}.jar<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>cmd</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>build</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>run</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>wait</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"><</span>log</span><span class=\"token punctuation\">></span></span>Hello World!<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>log</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>wait</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>run</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>image</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>images</span><span class=\"token punctuation\">></span></span>\n <span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>configuration</span><span class=\"token punctuation\">></span></span>\n<span class=\"token tag\"><span class=\"token tag\"><span class=\"token punctuation\"></</span>plugin</span><span class=\"token punctuation\">></span></span></code></pre></div>","frontmatter":{"date":"February 24, 2020","path":"/docs/migration-guide","title":"Eclipse JKube Migration Guide","description":"Eclipse JKube migration guide from Fabric8 Maven Plugin (FMP)"}}},"pageContext":{"langKey":"en","slug":"/docs/migration-guide/"}},"staticQueryHashes":[]} |