1"use strict";(self.webpackChunkfluvio_docs=self.webpackChunkfluvio_docs||[]).push([[2413],{54487:(e,n,s)=>{s.r(n),s.d(n,{assets:()=>c,contentTitle:()=>r,default:()=>u,frontMatter:()=>o,metadata:()=>l,toc:()=>a});var t=s(74848),i=s(28453);const o={sidebar_position:800,title:"Kubernetes",description:"Fluvio and Kubernetes"},r=void 0,l={id:"fluvio/installation/kubernetes",title:"Kubernetes",description:"Fluvio and Kubernetes",source:"@site/versioned_docs/version-0.12.0/fluvio/installation/kubernetes.mdx",sourceDirName:"fluvio/installation",slug:"/fluvio/installation/kubernetes",permalink:"/docs/0.12.0/fluvio/installation/kubernetes",draft:!1,unlisted:!1,editUrl:"https://github.com/infinyon/fluvio-docs/tree/main/versioned_docs/version-0.12.0/fluvio/installation/kubernetes.mdx",tags:[],version:"0.12.0",lastUpdatedBy:"Felipe Cardozo",lastUpdatedAt:1752028303e3,sidebarPosition:800,frontMatter:{sidebar_position:800,title:"Kubernetes",description:"Fluvio and Kubernetes"},sidebar:"fluvio",previous:{title:"Docker",permalink:"/docs/0.12.0/fluvio/installation/docker"},next:{title:"Docker: Custom App Container",permalink:"/docs/0.12.0/fluvio/installation/advanced/docker-custom-clients"}},c={},a=[{value:"Install Rancher Desktop",id:"install-rancher-desktop",level:2},{value:"Start Fluvio cluster",id:"start-fluvio-cluster",level:2},{value:"Verify cluster is running",id:"verify-cluster-is-running",level:3},{value:"Hello, Fluvio!",id:"hello-fluvio",level:2}];function d(e){const n={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsxs)(n.p,{children:["Fluvio runs with many kubernetes installations. If you are comfortable with kubernetes already, install with your current context using the ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/cli/fluvio/cluster#kubernetes",children:(0,t.jsx)(n.code,{children:"fluvio cluster"})})," command."]}),"\n",(0,t.jsxs)(n.p,{children:["We have a more detailed tutorial to install and run with ",(0,t.jsx)(n.strong,{children:"Rancher Desktop Kubernetes"})," below, but we have fluvio users who use fluvio with:"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"https://minikube.sigs.k8s.io/docs/",children:"minikube"})," (linux + others)"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"https://github.com/abiosoft/colima",children:"colima"})," (macos)"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"https://orbstack.dev/",children:"orbstack"})," (macos + linux)"]}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://aws.amazon.com/eks/",children:"AWS EKS"})}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["If you have any questions, feel free to ask on our ",(0,t.jsx)(n.a,{href:"https://discordapp.com/invite/bBG2dTz",children:"Discord channel"}),", our ",(0,t.jsx)(n.a,{href:"https://github.com/infinyon/fluvio",children:"Fluvio github repository"})]}),"\n",(0,t.jsx)(n.h2,{id:"install-rancher-desktop",children:"Install Rancher Desktop"}),"\n",(0,t.jsx)(n.admonition,{type:"note",children:(0,t.jsxs)(n.p,{children:["First ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/quickstart",children:"install Fluvio"})," to go through this tutorial."]})}),"\n",(0,t.jsxs)(n.p,{children:["Navigate to the Rancher Desktop ",(0,t.jsx)(n.a,{href:"https://docs.rancherdesktop.io/getting-started/installation/",children:"installation page"})," and follow the instructions. Rancher Desktop will provide access to other utilities needed to run Fluvio such as ",(0,t.jsx)(n.code,{children:"kubectl"})," and ",(0,t.jsx)(n.code,{children:"helm"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Please make sure that the container runtime is ",(0,t.jsx)(n.code,{children:"dockerd (moby)"}),". That configuration can be changed in the ",(0,t.jsx)(n.code,{children:"Kubernetes Settings"})," section on the sidebar."]}),"\n",(0,t.jsx)("img",{src:"/img/docs/concepts/advanced/install-on-rancher/rancher-dockerd.png",alt:"A screenshot of the Rancher Desktop using dockerd as container",style:{justify:"center",maxWidth:"800px"}}),"\n",(0,t.jsx)(n.h2,{id:"start-fluvio-cluster",children:"Start Fluvio cluster"}),"\n",(0,t.jsxs)(n.p,{children:["You can start a Fluvio cluster by running ",(0,t.jsx)(n.code,{children:"fluvio cluster start"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",metastring:'copy="fl"',children:"$ fluvio cluster start --k8 --use-k8-port-forwarding\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If rancher desktop is configured to manage a kubernetes cluster on a non-local host or ip, the ",(0,t.jsx)(n.code,{children:"--proxy-addr"})," argument needs to provide that host dns name, or ip of that cluster."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",metastring:'copy="fl"',children:"$ fluvio cluster start --k8 --proxy-addr HOSTNAME_OR_IP\n"})}),"\n",(0,t.jsx)(n.h3,{id:"verify-cluster-is-running",children:"Verify cluster is running"}),"\n",(0,t.jsx)(n.p,{children:"We can check the fluvio cluster by checking version and status with the following command:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"$ fluvio version\n"})}),"\n",(0,t.jsx)(n.h2,{id:"hello-fluvio",children:"Hello, Fluvio!"}),"\n",(0,t.jsx)(n.p,{children:"Congratulations, you've successfully installed Fluvio on your local machine!"}),"\n",(0,t.jsx)(n.p,{children:"Let's use the Fluvio CLI to play with some basic functionality."}),"\n",(0,t.jsxs)(n.p,{children:["The first thing we need to do is create a ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/concepts/architecture/sc#topics",children:"topic"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",metastring:'copy="fl"',children:"$ fluvio topic create greetings\ntopic greetings created\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Now that we have a topic, we can ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/concepts/produce-consume#producer",children:"produce"})," some messages!"]}),"\n",(0,t.jsxs)(n.p,{children:["Use the following command to send a message to the ",(0,t.jsx)(n.code,{children:"greetings"})," topic:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",metastring:'copy="fl"',children:"$ echo Hello, Fluvio | fluvio produce greetings\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Finally, we can ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/concepts/produce-consume#consumer",children:"consume"})," messages back from the topic"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",metastring:'copy="fl"',children:"$ fluvio consume greetings -B -d\nConsuming records from the beginning of topic 'greetings'\nHello, Fluvio\n"})}),"\n",(0,t.jsx)(n.p,{children:"Way to go! You're well on your way to writing real-time distributed a
1pps with Fluvio!"}),"\n",(0,t.jsxs)(n.p,{children:["If you run into any problems along the way, make sure to check out our ",(0,t.jsx)(n.a,{href:"/docs/0.12.0/fluvio/troubleshooting",children:"troubleshooting"})," page to find a fix."]})]})}function u(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},28453:(e,n,s)=>{s.d(n,{R:()=>r,x:()=>l});var t=s(96540);const i={},o=t.createContext(i);function r(e){const n=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:r(e.components),t.createElement(o.Provider,{value:n},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.