blob: 8617c3084b9ab65f87096f948415a2d08a330719 [file] [log] [blame]
/*! For license information please see 1c72b387.8af435ff.js.LICENSE.txt */
(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[6800],{4137:function(e,t,n){"use strict";n.d(t,{Zo:function(){return u},kt:function(){return m}});var l=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);t&&(l=l.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,l)}return n}function o(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){a(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function i(e,t){if(null==e)return{};var n,l,a=function(e,t){if(null==e)return{};var n,l,a={},r=Object.keys(e);for(l=0;l<r.length;l++)n=r[l],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(l=0;l<r.length;l++)n=r[l],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var s=l.createContext({}),c=function(e){var t=l.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},u=function(e){var t=c(e.components);return l.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return l.createElement(l.Fragment,{},t)}},d=l.forwardRef((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,s=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),d=c(n),m=a,k=d["".concat(s,".").concat(m)]||d[m]||p[m]||r;return n?l.createElement(k,o(o({ref:t},u),{},{components:n})):l.createElement(k,o({ref:t},u))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,o=new Array(r);o[0]=d;var i={};for(var s in t)hasOwnProperty.call(t,s)&&(i[s]=t[s]);i.originalType=e,i.mdxType="string"==typeof e?e:a,o[1]=i;for(var c=2;c<r;c++)o[c]=n[c];return l.createElement.apply(null,o)}return l.createElement.apply(null,n)}d.displayName="MDXCreateElement"},6261:function(e,t,n){"use strict";var l=n(7294),a=n(4184),r=n.n(a);t.Z=function(e){var t=e.children,n=e.classNames,a=e.fill,o=e.icon,i=e.type,s=null;switch(i){case"danger":case"warning":s="alert-triangle";break;case"success":s="check-circle";break;default:s="info"}return l.createElement("div",{className:r()(n,"alert","alert--"+i,{"alert--fill":a,"alert--icon":!1!==o}),role:"alert"},!1!==o&&l.createElement("i",{className:r()("feather","icon-"+(o||s))}),t)}},9342:function(e,t,n){"use strict";var l=n(7294),a=n(3699),r=n(4184),o=n.n(r);t.Z=function(e){var t=e.children,n=e.className,r=e.badge,i=e.icon,s=e.size,c=e.target,u=e.to,p=o()("jump-to","jump-to--"+s,n),d=l.createElement("div",{className:"jump-to--inner"},l.createElement("div",{className:"jump-to--inner-2"},l.createElement("div",{className:"jump-to--main"},r?l.createElement("span",{className:"badge badge--primary badge--right"},r):"",t),l.createElement("div",{className:"jump-to--right"},l.createElement("i",{className:"feather icon-"+(i||"chevron-right")+" arrow"}))));return c?l.createElement("a",{href:u,target:c,className:p},d):l.createElement(a.Z,{to:u,className:p},d)}},8560:function(e,t,n){"use strict";n.r(t),n.d(t,{frontMatter:function(){return c},contentTitle:function(){return u},metadata:function(){return p},toc:function(){return d},default:function(){return k}});var l=n(7462),a=n(3366),r=(n(7294),n(4137)),o=n(6261),i=n(9342),s=["components"],c={title:"GCP Quickstart",sidebar_label:"GCP",description:"Run Pinot on GCP",draft:!0},u=void 0,p={unversionedId:"administration/installation/cloud/gcp",id:"administration/installation/cloud/gcp",title:"GCP Quickstart",description:"Run Pinot on GCP",source:"@site/docs/administration/installation/cloud/gcp.md",sourceDirName:"administration/installation/cloud",slug:"/administration/installation/cloud/gcp",permalink:"/docs/administration/installation/cloud/gcp",editUrl:"https://github.com/apache/pinot/edit/master/website/docs/administration/installation/cloud/gcp.md",tags:[],version:"current",frontMatter:{title:"GCP Quickstart",sidebar_label:"GCP",description:"Run Pinot on GCP",draft:!0},sidebar:"docs",previous:{title:"AWS",permalink:"/docs/administration/installation/cloud/aws"},next:{title:"Azure",permalink:"/docs/administration/installation/cloud/azure"}},d=[{value:"Tooling Installation",id:"tooling-installation",children:[{value:"Install Kubectl",id:"install-kubectl",children:[],level:3},{value:"Install Helm",id:"install-helm",children:[],level:3}],level:2},{value:"Install Google Cloud SDK",id:"install-google-cloud-sdk",children:[{value:"For Mac User",id:"for-mac-user",children:[],level:3},{value:"(Optional) Initialize Google Cloud Environment",id:"optional-initialize-google-cloud-environment",children:[],level:3},{value:"(Optional) Create a Kubernetes cluster(GKE) in Google Cloud",id:"optional-create-a-kubernetes-clustergke-in-google-cloud",children:[],level:3},{value:"Connect to an existing cluster",id:"connect-to-an-existing-cluster",children:[],level:3},{value:"Pinot Quickstart",id:"pinot-quickstart",children:[],level:3},{value:"Delete a Kubernetes Cluster",id:"delete-a-kubernetes-cluster",children:[],level:3}],level:2}],m={toc:d};function k(e){var t=e.components,n=(0,a.Z)(e,s);return(0,r.kt)("wrapper",(0,l.Z)({},m,n,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"To have basic set with ",(0,r.kt)("a",{parentName:"p",href:"https://cloud.google.com/kubernetes-engine"},"Google Kubernetes Engine(GKE)")," on GCP:"),(0,r.kt)("h2",{id:"tooling-installation"},"Tooling Installation"),(0,r.kt)("h3",{id:"install-kubectl"},"Install Kubectl"),(0,r.kt)("p",null,"Please follow this link (",(0,r.kt)("a",{parentName:"p",href:"https://kubernetes.io/docs/tasks/tools/install-kubectl"},"https://kubernetes.io/docs/tasks/tools/install-kubectl"),") to install kubectl."),(0,r.kt)("p",null,"For Mac User"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"brew install kubernetes-cli\n")),(0,r.kt)("p",null,"Please check kubectl version after installation."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"kubectl version\n")),(0,r.kt)("p",null,"QuickStart scripts are tested under kubectl client version v1.16.3 and server version v1.13.12"),(0,r.kt)("h3",{id:"install-helm"},"Install Helm"),(0,r.kt)("p",null,"Please follow this ",(0,r.kt)("a",{parentName:"p",href:"https://helm.sh/docs/using_helm/#installing-helm"},"link to install helm")),(0,r.kt)("p",null,"For Mac User"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"brew install kubernetes-helm\n")),(0,r.kt)("p",null,"Please check helm version after installation."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"helm version\n")),(0,r.kt)(o.Z,{icon:!1,type:"info",mdxType:"Alert"},"This QuickStart provides helm supports for helm v3.0.0 and v2.12.1. Please pick the script based on your helm version."),(0,r.kt)("h2",{id:"install-google-cloud-sdk"},"Install Google Cloud SDK"),(0,r.kt)("p",null,"Please follow this link to ",(0,r.kt)("a",{parentName:"p",href:"https://cloud.google.com/sdk/install"},"install Google Cloud SDK")),(0,r.kt)("h3",{id:"for-mac-user"},"For Mac User"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Install Google Cloud SDK")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"curl https://sdk.cloud.google.com | bash\n")),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Restart your shell")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"exec -l $SHELL\n")),(0,r.kt)("h3",{id:"optional-initialize-google-cloud-environment"},"(Optional) Initialize Google Cloud Environment"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"gcloud init\n")),(0,r.kt)("h3",{id:"optional-create-a-kubernetes-clustergke-in-google-cloud"},"(Optional) Create a Kubernetes cluster(GKE) in Google Cloud"),(0,r.kt)("p",null,"Below script will create a 3 nodes cluster named pinot-quickstart in ",(0,r.kt)("inlineCode",{parentName:"p"},"us-west1-b")," with ",(0,r.kt)("inlineCode",{parentName:"p"},"n1-standard-2")," machines for demo purposes."),(0,r.kt)("p",null,"Please modify the parameters in the example command below:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"GCLOUD_PROJECT=[your gcloud project name]\nGCLOUD_ZONE=us-west1-b\nGCLOUD_CLUSTER=pinot-quickstart\nGCLOUD_MACHINE_TYPE=n1-standard-2\nGCLOUD_NUM_NODES=3\ngcloud container clusters create ${GCLOUD_CLUSTER} \\\n --num-nodes=${GCLOUD_NUM_NODES} \\\n --machine-type=${GCLOUD_MACHINE_TYPE} \\\n --zone=${GCLOUD_ZONE} \\\n --project=${GCLOUD_PROJECT}\n")),(0,r.kt)("p",null,"You can monitor cluster status by command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"gcloud compute instances list\n")),(0,r.kt)("p",null,"Once the cluster is in RUNNING status, it's ready to be used."),(0,r.kt)("h3",{id:"connect-to-an-existing-cluster"},"Connect to an existing cluster"),(0,r.kt)("p",null,"Simply run below command to get the credential for the cluster pinot-quickstart that you just created or your existing cluster."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"GCLOUD_PROJECT=[your gcloud project name]\nGCLOUD_ZONE=us-west1-b\nGCLOUD_CLUSTER=pinot-quickstart\ngcloud container clusters get-credentials ${GCLOUD_CLUSTER} --zone ${GCLOUD_ZONE} --project ${GCLOUD_PROJECT}\n")),(0,r.kt)("p",null,"To verify the connection, you can run:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"kubectl get nodes\n")),(0,r.kt)("h3",{id:"pinot-quickstart"},"Pinot Quickstart"),(0,r.kt)("p",null,"Please follow this ",(0,r.kt)("a",{parentName:"p",href:"/docs/administration/installation/cloud/on-premises"},"Kubernetes QuickStart")," to deploy your Pinot Demo."),(0,r.kt)(i.Z,{to:"/docs/administration/installation/cloud/on-premises",mdxType:"Jump"},"Kubernetes Quickstart"),(0,r.kt)("h3",{id:"delete-a-kubernetes-cluster"},"Delete a Kubernetes Cluster"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"GCLOUD_ZONE=us-west1-b\ngcloud container clusters delete pinot-quickstart --zone=${GCLOUD_ZONE}\n")))}k.isMDXComponent=!0},4184:function(e,t){var n;!function(){"use strict";var l={}.hasOwnProperty;function a(){for(var e=[],t=0;t<arguments.length;t++){var n=arguments[t];if(n){var r=typeof n;if("string"===r||"number"===r)e.push(n);else if(Array.isArray(n)){if(n.length){var o=a.apply(null,n);o&&e.push(o)}}else if("object"===r)if(n.toString===Object.prototype.toString)for(var i in n)l.call(n,i)&&n[i]&&e.push(i);else e.push(n.toString())}}return e.join(" ")}e.exports?(a.default=a,e.exports=a):void 0===(n=function(){return a}.apply(t,[]))||(e.exports=n)}()}}]);