renaming kargo-cli to kubespray-cli
parent
bae5ce0bfa
commit
83265b7f75
14
README.md
14
README.md
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
## Deploy a production ready kubernetes cluster
|
## Deploy a production ready kubernetes cluster
|
||||||
|
|
||||||
If you have questions, join us on the [kubernetes slack](https://slack.k8s.io), channel **#kargo**.
|
If you have questions, join us on the [kubernetes slack](https://slack.k8s.io), channel **#kubespray**.
|
||||||
|
|
||||||
- Can be deployed on **AWS, GCE, Azure, OpenStack or Baremetal**
|
- Can be deployed on **AWS, GCE, Azure, OpenStack or Baremetal**
|
||||||
- **High available** cluster
|
- **High available** cluster
|
||||||
|
@ -13,7 +13,7 @@ If you have questions, join us on the [kubernetes slack](https://slack.k8s.io),
|
||||||
|
|
||||||
To deploy the cluster you can use :
|
To deploy the cluster you can use :
|
||||||
|
|
||||||
[**kargo-cli**](https://github.com/kubespray/kargo-cli) <br>
|
[**kubespray-cli**](https://github.com/kubespray/kubespray-cli) <br>
|
||||||
**Ansible** usual commands and [**inventory builder**](https://github.com/kubernetes-incubator/kubespray/blob/master/contrib/inventory_builder/inventory.py) <br>
|
**Ansible** usual commands and [**inventory builder**](https://github.com/kubernetes-incubator/kubespray/blob/master/contrib/inventory_builder/inventory.py) <br>
|
||||||
**vagrant** by simply running `vagrant up` (for tests purposes) <br>
|
**vagrant** by simply running `vagrant up` (for tests purposes) <br>
|
||||||
|
|
||||||
|
@ -97,14 +97,14 @@ option to leverage built-in cloud provider networking instead.
|
||||||
See also [Network checker](docs/netcheck.md).
|
See also [Network checker](docs/netcheck.md).
|
||||||
|
|
||||||
## Community docs and resources
|
## Community docs and resources
|
||||||
- [kubernetes.io/docs/getting-started-guides/kargo/](https://kubernetes.io/docs/getting-started-guides/kargo/)
|
- [kubernetes.io/docs/getting-started-guides/kubespray/](https://kubernetes.io/docs/getting-started-guides/kubespray/)
|
||||||
- [kargo, monitoring and logging](https://github.com/gregbkr/kubernetes-kargo-logging-monitoring) by @gregbkr
|
- [kubespray, monitoring and logging](https://github.com/gregbkr/kubernetes-kargo-logging-monitoring) by @gregbkr
|
||||||
- [Deploy Kubernetes w/ Ansible & Terraform](https://rsmitty.github.io/Terraform-Ansible-Kubernetes/) by @rsmitty
|
- [Deploy Kubernetes w/ Ansible & Terraform](https://rsmitty.github.io/Terraform-Ansible-Kubernetes/) by @rsmitty
|
||||||
- [Deploy a Kubernetes Cluster with Kargo (video)](https://www.youtube.com/watch?v=N9q51JgbWu8)
|
- [Deploy a Kubernetes Cluster with Kubespray (video)](https://www.youtube.com/watch?v=N9q51JgbWu8)
|
||||||
|
|
||||||
## Tools and projects on top of Kubespray
|
## Tools and projects on top of Kubespray
|
||||||
- [Digital Rebar](https://github.com/digitalrebar/digitalrebar)
|
- [Digital Rebar](https://github.com/digitalrebar/digitalrebar)
|
||||||
- [Kargo-cli](https://github.com/kubespray/kargo-cli)
|
- [Kubespray-cli](https://github.com/kubespray/kubespray-cli)
|
||||||
- [Fuel-ccp-installer](https://github.com/openstack/fuel-ccp-installer)
|
- [Fuel-ccp-installer](https://github.com/openstack/fuel-ccp-installer)
|
||||||
- [Terraform Contrib](https://github.com/kubernetes-incubator/kubespray/tree/master/contrib/terraform)
|
- [Terraform Contrib](https://github.com/kubernetes-incubator/kubespray/tree/master/contrib/terraform)
|
||||||
|
|
||||||
|
@ -112,7 +112,7 @@ See also [Network checker](docs/netcheck.md).
|
||||||
|
|
||||||
![Gitlab Logo](https://s27.postimg.org/wmtaig1wz/gitlabci.png)
|
![Gitlab Logo](https://s27.postimg.org/wmtaig1wz/gitlabci.png)
|
||||||
|
|
||||||
[![Build graphs](https://gitlab.com/kargo-ci/kubernetes-incubator__kargo/badges/master/build.svg)](https://gitlab.com/kargo-ci/kubernetes-incubator__kargo/pipelines) </br>
|
[![Build graphs](https://gitlab.com/kubespray-ci/kubernetes-incubator__kubespray/badges/master/build.svg)](https://gitlab.com/kubespray-ci/kubernetes-incubator__kubespray/pipelines) </br>
|
||||||
|
|
||||||
CI/end-to-end tests sponsored by Google (GCE), DigitalOcean, [teuto.net](https://teuto.net/) (openstack).
|
CI/end-to-end tests sponsored by Google (GCE), DigitalOcean, [teuto.net](https://teuto.net/) (openstack).
|
||||||
See the [test matrix](docs/test_cases.md) for details.
|
See the [test matrix](docs/test_cases.md) for details.
|
||||||
|
|
|
@ -65,7 +65,7 @@ HOST_PREFIX = os.environ.get("HOST_PREFIX", "node")
|
||||||
# Configurable as shell vars end
|
# Configurable as shell vars end
|
||||||
|
|
||||||
|
|
||||||
class KargoInventory(object):
|
class KubesprayInventory(object):
|
||||||
|
|
||||||
def __init__(self, changed_hosts=None, config_file=None):
|
def __init__(self, changed_hosts=None, config_file=None):
|
||||||
self.config = configparser.ConfigParser(allow_no_value=True,
|
self.config = configparser.ConfigParser(allow_no_value=True,
|
||||||
|
@ -337,7 +337,7 @@ MASSIVE_SCALE_THRESHOLD Separate K8s master and ETCD if # of nodes >= 200
|
||||||
def main(argv=None):
|
def main(argv=None):
|
||||||
if not argv:
|
if not argv:
|
||||||
argv = sys.argv[1:]
|
argv = sys.argv[1:]
|
||||||
KargoInventory(argv, CONFIG_FILE)
|
KubesprayInventory(argv, CONFIG_FILE)
|
||||||
|
|
||||||
if __name__ == "__main__":
|
if __name__ == "__main__":
|
||||||
sys.exit(main())
|
sys.exit(main())
|
||||||
|
|
|
@ -1,3 +1,3 @@
|
||||||
[metadata]
|
[metadata]
|
||||||
name = kargo-inventory-builder
|
name = kubespray-inventory-builder
|
||||||
version = 0.1
|
version = 0.1
|
||||||
|
|
|
@ -31,7 +31,7 @@ class TestInventory(unittest.TestCase):
|
||||||
sys_mock.exit = mock.Mock()
|
sys_mock.exit = mock.Mock()
|
||||||
super(TestInventory, self).setUp()
|
super(TestInventory, self).setUp()
|
||||||
self.data = ['10.90.3.2', '10.90.3.3', '10.90.3.4']
|
self.data = ['10.90.3.2', '10.90.3.3', '10.90.3.4']
|
||||||
self.inv = inventory.KargoInventory()
|
self.inv = inventory.KubesprayInventory()
|
||||||
|
|
||||||
def test_get_ip_from_opts(self):
|
def test_get_ip_from_opts(self):
|
||||||
optstring = "ansible_host=10.90.3.2 ip=10.90.3.2"
|
optstring = "ansible_host=10.90.3.2 ip=10.90.3.2"
|
||||||
|
|
|
@ -1,11 +1,11 @@
|
||||||
# Kargo on KVM Virtual Machines hypervisor preparation
|
# Kubespray on KVM Virtual Machines hypervisor preparation
|
||||||
|
|
||||||
A simple playbook to ensure your system has the right settings to enable Kargo
|
A simple playbook to ensure your system has the right settings to enable Kubespray
|
||||||
deployment on VMs.
|
deployment on VMs.
|
||||||
|
|
||||||
This playbook does not create Virtual Machines, nor does it run Kargo itself.
|
This playbook does not create Virtual Machines, nor does it run Kubespray itself.
|
||||||
|
|
||||||
### User creation
|
### User creation
|
||||||
|
|
||||||
If you want to create a user for running Kargo deployment, you should specify
|
If you want to create a user for running Kubespray deployment, you should specify
|
||||||
both `k8s_deployment_user` and `k8s_deployment_user_pkey_path`.
|
both `k8s_deployment_user` and `k8s_deployment_user_pkey_path`.
|
||||||
|
|
|
@ -1,3 +1,3 @@
|
||||||
#k8s_deployment_user: kargo
|
#k8s_deployment_user: kubespray
|
||||||
#k8s_deployment_user_pkey_path: /tmp/ssh_rsa
|
#k8s_deployment_user_pkey_path: /tmp/ssh_rsa
|
||||||
|
|
||||||
|
|
|
@ -12,9 +12,9 @@
|
||||||
line: 'br_netfilter'
|
line: 'br_netfilter'
|
||||||
when: br_netfilter is defined and ansible_os_family == 'Debian'
|
when: br_netfilter is defined and ansible_os_family == 'Debian'
|
||||||
|
|
||||||
- name: Add br_netfilter into /etc/modules-load.d/kargo.conf
|
- name: Add br_netfilter into /etc/modules-load.d/kubespray.conf
|
||||||
copy:
|
copy:
|
||||||
dest: /etc/modules-load.d/kargo.conf
|
dest: /etc/modules-load.d/kubespray.conf
|
||||||
content: |-
|
content: |-
|
||||||
### This file is managed by Ansible
|
### This file is managed by Ansible
|
||||||
br-netfilter
|
br-netfilter
|
||||||
|
|
|
@ -3,17 +3,17 @@ Cloud providers
|
||||||
|
|
||||||
#### Provisioning
|
#### Provisioning
|
||||||
|
|
||||||
You can use kargo-cli to start new instances on cloud providers
|
You can use kubespray-cli to start new instances on cloud providers
|
||||||
here's an example
|
here's an example
|
||||||
```
|
```
|
||||||
kargo [aws|gce] --nodes 2 --etcd 3 --cluster-name test-smana
|
kubespray [aws|gce] --nodes 2 --etcd 3 --cluster-name test-smana
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Deploy kubernetes
|
#### Deploy kubernetes
|
||||||
|
|
||||||
With kargo-cli
|
With kubespray-cli
|
||||||
```
|
```
|
||||||
kargo deploy [--aws|--gce] -u admin
|
kubespray deploy [--aws|--gce] -u admin
|
||||||
```
|
```
|
||||||
|
|
||||||
Or ansible-playbook command
|
Or ansible-playbook command
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
CoreOS bootstrap
|
CoreOS bootstrap
|
||||||
===============
|
===============
|
||||||
|
|
||||||
Example with **kargo-cli**:
|
Example with **kubespray-cli**:
|
||||||
|
|
||||||
```
|
```
|
||||||
kargo deploy --gce --coreos
|
kubespray deploy --gce --coreos
|
||||||
```
|
```
|
||||||
|
|
||||||
Or with Ansible:
|
Or with Ansible:
|
||||||
|
|
|
@ -1,21 +1,21 @@
|
||||||
Getting started
|
Getting started
|
||||||
===============
|
===============
|
||||||
|
|
||||||
The easiest way to run the deployement is to use the **kargo-cli** tool.
|
The easiest way to run the deployement is to use the **kubespray-cli** tool.
|
||||||
A complete documentation can be found in its [github repository](https://github.com/kubespray/kargo-cli).
|
A complete documentation can be found in its [github repository](https://github.com/kubespray/kubespray-cli).
|
||||||
|
|
||||||
Here is a simple example on AWS:
|
Here is a simple example on AWS:
|
||||||
|
|
||||||
* Create instances and generate the inventory
|
* Create instances and generate the inventory
|
||||||
|
|
||||||
```
|
```
|
||||||
kargo aws --instances 3
|
kubespray aws --instances 3
|
||||||
```
|
```
|
||||||
|
|
||||||
* Run the deployment
|
* Run the deployment
|
||||||
|
|
||||||
```
|
```
|
||||||
kargo deploy --aws -u centos -n calico
|
kubespray deploy --aws -u centos -n calico
|
||||||
```
|
```
|
||||||
|
|
||||||
Building your own inventory
|
Building your own inventory
|
||||||
|
|
|
@ -8,7 +8,7 @@ That would probably improve deployment speed and certs management [#553](https:/
|
||||||
### Self deployment (pull-mode) [#320](https://github.com/kubespray/kubespray/issues/320)
|
### Self deployment (pull-mode) [#320](https://github.com/kubespray/kubespray/issues/320)
|
||||||
- the playbook would install and configure docker/rkt and the etcd cluster
|
- the playbook would install and configure docker/rkt and the etcd cluster
|
||||||
- the following data would be inserted into etcd: certs,tokens,users,inventory,group_vars.
|
- the following data would be inserted into etcd: certs,tokens,users,inventory,group_vars.
|
||||||
- a "kubespray" container would be deployed (kargo-cli, ansible-playbook, kpm)
|
- a "kubespray" container would be deployed (kubespray-cli, ansible-playbook, kpm)
|
||||||
- to be discussed, a way to provide the inventory
|
- to be discussed, a way to provide the inventory
|
||||||
- **self deployment** of the node from inside a container [#321](https://github.com/kubespray/kubespray/issues/321)
|
- **self deployment** of the node from inside a container [#321](https://github.com/kubespray/kubespray/issues/321)
|
||||||
|
|
||||||
|
@ -53,10 +53,10 @@ That would probably improve deployment speed and certs management [#553](https:/
|
||||||
- (to be discussed) option to set a loadbalancer for the apiservers like ucarp/packemaker/keepalived
|
- (to be discussed) option to set a loadbalancer for the apiservers like ucarp/packemaker/keepalived
|
||||||
While waiting for the issue [kubernetes/kubernetes#18174](https://github.com/kubernetes/kubernetes/issues/18174) to be fixed.
|
While waiting for the issue [kubernetes/kubernetes#18174](https://github.com/kubernetes/kubernetes/issues/18174) to be fixed.
|
||||||
|
|
||||||
### Kargo-cli
|
### Kubespray-cli
|
||||||
- Delete instances
|
- Delete instances
|
||||||
- `kargo vagrant` to setup a test cluster locally
|
- `kubespray vagrant` to setup a test cluster locally
|
||||||
- `kargo azure` for Microsoft Azure support
|
- `kubespray azure` for Microsoft Azure support
|
||||||
- switch to Terraform instead of Ansible for provisionning
|
- switch to Terraform instead of Ansible for provisionning
|
||||||
- update $HOME/.kube/config when a cluster is deployed. Optionally switch to this context
|
- update $HOME/.kube/config when a cluster is deployed. Optionally switch to this context
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue