README
¶
Pipeline Kubernetes Engine - PKE
PKE is an extremely simple CNCF certifed Kubernetes installer and distribution, designed to work on any cloud, VM or bare metal. The pke tool supports cloud provider integrations, multi-phased installs (requires only an OS), pre-warmed machine image builds, and more. PKE is the preferred Kubernetes run-time of the Banzai Cloud Pipeline platform, which supercharges the development, deployment and scaling of container-based applications with native support for multi-, hybrid-, and edge-cloud environments.
If you would like to supercharge your Kubernetes experience using Banzai Cloud Pipeline, check out the free developer beta:
Create clusters
Please review the requirements before creating Kubernetes clusters. Note that the pke tool will install all required dependencies (like CRI, CNI, etc).
Single-node PKE
Creating a single-node Kubernetes cluster is as simple as running the following command as root:
pke install single
Multi-node PKE
To create the Kubernetes API server:
export MASTER_IP_ADDRESS=""
pke install master --kubernetes-api-server=$MASTER_IP_ADDRESS:6443
Please get the token and certhash from the logs or issue the
pke token listcommand to print the token and cert hash needed by workers to join the cluster.
Once the API server is up and running you can add as many nodes as needed:
export TOKEN=""
export CERTHASH=""
export MASTER_IP_ADDRESS=""
pke install worker --kubernetes-node-token $TOKEN --kubernetes-api-server-ca-cert-hash $CERTHASH --kubernetes-api-server $MASTER_IP_ADDRESS:6443
Using kubectl
To use kubectl and other command line tools on the master node, set up its config:
mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config
kubectl get nodes
Other options
You can create PKE clusters on any of the cloud providers, Vagrant, virtual machines, etc using the pke tool or let the Pipeline platform do it for you using all the complementary features, such as: centralized log collection, federated monitoring, autoscaling, Vault based secret management, disaster recovery, security scans and a lot more.
Contributing
Thank you for your contribution and being part of our community. Please read CONTRIBUTING.md for details on the code of conduct, and the process for submitting pull requests. When you are opening a PR to PKE for the first time we will require you to sign a standard CLA.
Community
If you have any questions about PKE, and would like to talk to us and the other members of the Banzai Cloud community, please join our Slack.
License
Copyright (c) 2017-2019 Banzai Cloud, Inc.
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.
Directories