k8s-boshrelease

KO | EN

gitlite — search

#javascript #hacktoberfest #react #golang #machine-learning #nodejs #java #windows #awesome #cli #vue #pytorch #mcp #open-source

k8s-boshrelease

(★ 13)

A BOSH Release for deploying Kubernetes clusters

k8s-boshrelease Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

k8s BOSH Release
================

This is a BOSH release for spinning Kubernetes, using BOSH
to orchestrate the "physical" nodes that comprise the various
roles of a Kubernetes cluster (control and worker).

Rationale
---------

I am aware of other efforts to BOSH-ify Kubernetes, like
[kubo][kubo].  This project does not aim to replace those other
projects in any way, and if you find joy in using those projects,
please continue using them.

Deployments
-----------

If you are looking for production-worthy deployment manifests that
follow the same pattern as bosh-deployment and cf-deployment,.
check out [k8s-deployment][k8s-d]!

This repository comes with some sample manifests to illustrate how
one might configure a k8s deployment in the wild.

- **tinynetes** - A single-VM instance, all-in-one k8s
    "cluster", suitable for experimentation or CI/CD.

- **labernetes** - A multi-node cluster of combined
    control+worker nodes, suitable for shared lab exercises.

- **prodernetes** - A proper cluster with control and worker
    nodes on separate VMs, allowing one to scale the workers
    separately from the control plane.  All aspects of the control
    plane are co-located (etcd, api, scheduler, and cmgr).
    Suitable for (possibly) some real-world prod use.

- **hugernetes** - A REALLY BIG CLUSTER that splits the etcd
    component out onto its own multi-node cluster, leaving the
    control plane VMs to run api, scheduler, and the controller
    manager.  Suitable for (possibly) some real-world prod use.

These are found in the `manifests/` directory, and can be deployed
without further pre-processing.

Deployment Dependency
---------------------

In order to perform activites on the pods which require DNS
lookups, such as `kubectl exec` or `kubectl pods`, BOSH DNS must
be deployed.  The easiest way of doing this is by adding BOSH DNS
to your Runtime Config. An example of a Runtime Config with BOSH
DNS can be found [here at bosh.io][dns].

Post Deployment
---------------

Once Kubernetes is deployed you will likely want to connect to it
with `kubectl` from a jumpbox or laptop but you need a
configuration for that.  Fortunately there is a jumpbox script
which generates the configuration.  From one of the `control`
instances run the following as `root`:

```
. /var/vcap/jobs/jumpbox/envrc
```

This will generate a long-lived cluster cert, user client cert and
client key and make these available in a kubeconfig.  You are now
authenticated and `kubectl` is in your `$PATH`.

Get the contents of the config, while still logged into the BOSH
SSH session, run:

```
cat $KUBECONFIG
```

On your jumpbox or anywhere else you need a `kubectl`
configuration file, write out the contents to a file (such as
`my-bosh-deployed-k8s`) and then source the file:

```
export KUBECONFIG=$PWD/my-bosh-deployed-k8s
```

Contributing
------------

If you find this, and manage to get it to work for you, great!
I'd love to hear from you, of your successes and struggles.

If you find a bug, or something doesn't work quite right, please
open an issue in the GitHub tracker!  Remember, we have a
[code of conduct](CONDUCT.md).

If you are thinking of contributing code, please read the
[Contribution Guidelines](CONTRIBUTING.md) and follow them.
Particularly, please _open GitHub isssues and allow your change to
be discussed before submitting a pull request_.  "Drive-by" PRs
may be closed without much discussion.

[k8s-d]: https://github.com/jhunt/k8s-deployment
[kubo]:  https://github.com/cloudfoundry-incubator/kubo-release
[dns]:   https://github.com/cloudfoundry/bosh-deployment/blob/master/runtime-configs/dns.yml

k8s-boshrelease

k8s-boshrelease Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

k8s-boshrelease

k8s-boshrelease Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README