-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathcomponent---src-templates-main-jsx-content-file-path-src-content-docs-migration-guide-mdx-f2bfca3c19c54ad9f1d7.js
2 lines (2 loc) · 14 KB
/
component---src-templates-main-jsx-content-file-path-src-content-docs-migration-guide-mdx-f2bfca3c19c54ad9f1d7.js
1
2
"use strict";(self.webpackChunkjkube_website=self.webpackChunkjkube_website||[]).push([[141],{8250:function(e,n,t){t.r(n),t.d(n,{Head:function(){return u},default:function(){return m}});var a=t(1151),r=t(7294),l=t(2721);function i(e){const n=Object.assign({h1:"h1",a:"a",span:"span",h2:"h2",p:"p",h3:"h3",pre:"pre",code:"code",h5:"h5"},(0,a.ah)(),e.components);return r.createElement(r.Fragment,null,r.createElement(l.VM,null,r.createElement(n.h1,{id:"documentation",style:{position:"relative"}},r.createElement(n.a,{href:"#documentation","aria-label":"documentation permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Documentation"),r.createElement(n.h2,{id:"migration-guide",style:{position:"relative"}},r.createElement(n.a,{href:"#migration-guide","aria-label":"migration guide permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Migration Guide")),"\n",r.createElement(n.h2,{id:"migration-guide-for-projects-using-fabric8-maven-plugin-to-eclipse-jkube",style:{position:"relative"}},r.createElement(n.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",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Migration Guide for projects using Fabric8 Maven Plugin to Eclipse JKube"),"\n",r.createElement(n.p,null,"For any project currently using ",r.createElement(n.a,{href:"https://github.com/fabric8io/fabric8-maven-plugin",target:"_blank",rel:"nofollow noopener noreferrer"},"Fabric8 Maven Plugin (FMP)"),",\nmigrating to Eclipse JKube is as simple as running a Maven command."),"\n",r.createElement(n.p,null,"FMP used to handle both Kubernetes and OpenShift clusters but Eclipse JKube has separate plugins for these two different\nenvironments."),"\n",r.createElement(n.h3,{id:"projects-targeting-kubernetes-clusters",style:{position:"relative"}},r.createElement(n.a,{href:"#projects-targeting-kubernetes-clusters","aria-label":"projects targeting kubernetes clusters permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Projects targeting Kubernetes Clusters"),"\n",r.createElement(n.p,null,"Run the following command in you project's root directory:"),"\n",r.createElement(n.pre,null,r.createElement(n.code,{className:"language-bash"},"mvn org.eclipse.jkube:kubernetes-maven-plugin:migrate\n")),"\n",r.createElement(n.p,null,"Maven coordinates in your ",r.createElement(n.code,null,"pom.xml")," will change from ",r.createElement(n.code,null,"io.fabric8:fabric8-maven-plugin")," to\n",r.createElement(n.code,null,"org.eclipse.jkube:kubernetes-maven-plugin")," for every ",r.createElement(n.code,null,"<plugin>")," entry."),"\n",r.createElement(n.h3,{id:"projects-targeting-openshift-clusters",style:{position:"relative"}},r.createElement(n.a,{href:"#projects-targeting-openshift-clusters","aria-label":"projects targeting openshift clusters permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Projects targeting OpenShift Clusters"),"\n",r.createElement(n.p,null,"Run the following command in your project's root directory:"),"\n",r.createElement(n.pre,null,r.createElement(n.code,{className:"language-bash"},"mvn org.eclipse.jkube:openshift-maven-plugin:migrate\n")),"\n",r.createElement(n.p,null,"Maven coordinates in your ",r.createElement(n.code,null,"pom.xml")," will change from ",r.createElement(n.code,null,"io.fabric8:fabric8-maven-plugin")," to\n",r.createElement(n.code,null,"org.eclipse.jkube:openshift-maven-plugin")," for every ",r.createElement(n.code,null,"<plugin>")," entry."),"\n",r.createElement(n.h3,{id:"xml-configuration-and-maven-properties",style:{position:"relative"}},r.createElement(n.a,{href:"#xml-configuration-and-maven-properties","aria-label":"xml configuration and maven properties permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"XML configuration and Maven properties"),"\n",r.createElement(n.p,null,"FMP specific Maven properties ",r.createElement(n.code,null,"<fabric8.*")," will be automatically renamed to Eclipse JKube analogous\nproperties ",r.createElement(n.code,null,"<jkube.*"),"."),"\n",r.createElement(n.p,null,"Mojo XML configuration element tag names will also be automatically renamed to the Eclipse JKube\nequivalent."),"\n",r.createElement(n.h3,{id:"resource-fragments",style:{position:"relative"}},r.createElement(n.a,{href:"#resource-fragments","aria-label":"resource fragments permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Resource Fragments"),"\n",r.createElement(n.p,null,"If you want to customize Kubernetes manifests added by FMP by means other than XML configuration,\nyou usually add your resources to ",r.createElement(n.code,null,"src/main/fabric8")," directory and FMP picks these up during enrichment\nprocess and merges them along with the default generated resources."),"\n",r.createElement(n.p,null,"Eclipse JKube's ",r.createElement(n.code,null,"migrate")," Maven goal will also take care of renaming your project's ",r.createElement(n.code,null,"src/main/fabric8"),"\nfragment directory to ",r.createElement(n.code,null,"src/main/jkube")),"\n",r.createElement(n.h3,{id:"image-configuration-for-docker-builds",style:{position:"relative"}},r.createElement(n.a,{href:"#image-configuration-for-docker-builds","aria-label":"image configuration for docker builds permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Image Configuration for Docker builds"),"\n",r.createElement(n.p,null,"Projects relying on FMP's ",r.createElement(n.code,null,"ImageConfiguration")," model for building docker images don't need any change in\nEclipse JKube's XML configuration."),"\n",r.createElement(n.p,null,"For example, let's consider this simple project's plugin configuration:"),"\n",r.createElement(n.h5,{id:"fabric8-maven-plugin-image-configuration",style:{position:"relative"}},r.createElement(n.a,{href:"#fabric8-maven-plugin-image-configuration","aria-label":"fabric8 maven plugin image configuration permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Fabric8 Maven Plugin Image Configuration"),"\n",r.createElement(n.pre,null,r.createElement(n.code,{className:"language-xml"},"<plugin>\n <groupId>io.fabric8</groupId>\n <artifactId>fabric8-maven-plugin</artifactId>\n <configuration>\n <images>\n <image>\n <name>%g/helloworld-java:%l</name>\n <alias>hello-world</alias>\n <build>\n <from>openjdk:latest</from>\n <assembly>\n <descriptorRef>artifact</descriptorRef>\n </assembly>\n <cmd>java -jar maven/${project.name}-${project.version}.jar</cmd>\n </build>\n <run>\n <wait>\n <log>Hello World!</log>\n </wait>\n </run>\n </image>\n </images>\n </configuration>\n</plugin>\n")),"\n",r.createElement(n.h5,{id:"eclipse-jkube-image-configuration",style:{position:"relative"}},r.createElement(n.a,{href:"#eclipse-jkube-image-configuration","aria-label":"eclipse jkube image configuration permalink",className:"anchor before"},r.createElement(n.span,{dangerouslySetInnerHTML:{__html:'<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>'}})),"Eclipse JKube Image Configuration"),"\n",r.createElement(n.pre,null,r.createElement(n.code,{className:"language-xml"},"<plugin>\n <groupId>org.eclipse.jkube</groupId>\n <artifactId>kubernetes-maven-plugin</artifactId>\n <configuration>\n <images>\n <image>\n <name>%g/helloworld-java:%l</name>\n <alias>hello-world</alias>\n <build>\n <from>openjdk:latest</from>\n <assembly>\n <descriptorRef>artifact</descriptorRef>\n </assembly>\n <cmd>java -jar maven/${project.name}-${project.version}.jar</cmd>\n </build>\n <run>\n <wait>\n <log>Hello World!</log>\n </wait>\n </run>\n </image>\n </images>\n </configuration>\n</plugin>\n")))}var c=function(e){void 0===e&&(e={});const{wrapper:n}=Object.assign({},(0,a.ah)(),e.components);return n?r.createElement(n,e,r.createElement(i,e)):i(e)};const o=e=>({pre:e=>{var n,t;let{className:a="",...i}=e;return"code"===(null==i||null===(n=i.children)||void 0===n||null===(t=n.type)||void 0===t?void 0:t.name)?r.createElement(l.dn,i):r.createElement("pre",Object.assign({className:a},i))},code:n=>r.createElement(l.EK,Object.assign({pageContext:e},n))}),s=e=>{let{children:n,pageContext:t}=e;const{locale:i}=t;return r.createElement(a.Zo,{components:o(t)},r.createElement(l.Zn,{locale:i},r.createElement("div",{className:"eclipse-jkube__content"},n)))},u=e=>{let{data:{mdx:{frontmatter:{title:n,description:t}}}}=e;return r.createElement(l.pQ,{title:n,description:t})};function m(e){return r.createElement(s,e,r.createElement(c,e))}},1151:function(e,n,t){t.d(n,{Zo:function(){return c},ah:function(){return l}});var a=t(7294);const r=a.createContext({});function l(e){const n=a.useContext(r);return a.useMemo((()=>"function"==typeof e?e(n):{...n,...e}),[n,e])}const i={};function c({components:e,children:n,disableParentContext:t}){let c;return c=t?"function"==typeof e?e({}):e||i:l(e),a.createElement(r.Provider,{value:c},n)}}}]);
//# sourceMappingURL=component---src-templates-main-jsx-content-file-path-src-content-docs-migration-guide-mdx-f2bfca3c19c54ad9f1d7.js.map