https://github.com/suse/caasp-salt

A collection of salt states used to provision a kubernetes cluster
https://github.com/suse/caasp-salt

caasp docker kubernetes opensuse saltstack

Last synced: 3 months ago
JSON representation

A collection of salt states used to provision a kubernetes cluster

• Host: GitHub
• URL: https://github.com/suse/caasp-salt
• Owner: SUSE
• License: apache-2.0
• Archived: true
• Created: 2017-03-01T14:04:14.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-03-14T17:16:28.000Z (almost 4 years ago)
• Last Synced: 2024-09-27T05:40:11.394Z (3 months ago)
• Topics: caasp, docker, kubernetes, opensuse, saltstack
• Language: Python
• Size: 3.12 MB
• Stars: 64
• Watchers: 33
• Forks: 29
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Description

A collection of Salt states used to provision a kubernetes cluster

in the context of CaaSP/MicroOS.

# Running Tests

First of all, you have to install tox:

    % zypper in python-tox

After that, from the root of the project you can run style checks:

    $ tox -e flake8

And unit tests:

    $ tox -e tests-salt-2018.3.0-py27

If you want to run everything simply perform:

    $ tox

# Salt states and CaaSP architecture

The Salt state creates an architecture that depends on some (already existing) elements. This is the expected setup before running the orchestration:

![](docs/k8s-before-orchestration.png)

The _salt master_ is installed in the _Admin Dashboard_ and is reponsible for

orchestrating the deployment and controlling all the minions in the cluster,

including a local minion that is used for generating the CA certificate.

An _etcd_ instance is also used for bootstrapping the other etcd instances in

the cluster. It will be configured from Salt with the number of etcd masters

set in the pillar.

After running the orchestration, the architecture will look like this:

![](docs/k8s-after-orchestration.png)

Some notes:

* the _etcd discovery_ server is **not** a member of the etcd cluster: it is

  only used as a _rendezvous_ for bootstrapping the etcd cluster.

* for the systems that need to talk to _etcd_, they connect to the local _etcd_

  instance. This local server will be either a full member of the _etcd_

  cluster or an instance that works in `rw`-proxy mode.

# License

This project is licensed under the Apache License, Version 2.0. See

[LICENSE](https://github.com/kubic-project/salt/blob/master/LICENSE) for the full

license text.