Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scaleway/scaleway-cloud-controller-manager
Kubernetes Cloud Controller Manager for Scaleway
https://github.com/scaleway/scaleway-cloud-controller-manager
ccm cloud-controller-manager instance k8s kapsule kubernetes loadbalancer scaleway
Last synced: 3 months ago
JSON representation
Kubernetes Cloud Controller Manager for Scaleway
- Host: GitHub
- URL: https://github.com/scaleway/scaleway-cloud-controller-manager
- Owner: scaleway
- License: apache-2.0
- Created: 2019-06-15T17:34:33.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-19T12:50:16.000Z (7 months ago)
- Last Synced: 2024-06-19T00:18:24.768Z (5 months ago)
- Topics: ccm, cloud-controller-manager, instance, k8s, kapsule, kubernetes, loadbalancer, scaleway
- Language: Go
- Homepage:
- Size: 470 KB
- Stars: 53
- Watchers: 8
- Forks: 18
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Kubernetes Cloud Controller Manager for Scaleway
`scaleway-cloud-controller-manager` is the Kubernetes cloud controller manager implementation
(or out-of-tree cloud-provider) for Scaleway.
External cloud providers were introduced as an _Alpha_ feature in Kubernetes 1.6.
They are Kubernetes (master) controllers that implement the
cloud-provider specific control loops required for Kubernetes to function.
Read more about kubernetes cloud controller managers in the
[kubernetes documentation](https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/).
**WARNING**: this project is under active development and should be considered alpha.
## Features
Currently `scaleway-cloud-controller-manager` currently implements:
- Instances interface - updates nodes with cloud provider specific labels and
addresses, also deletes kubernetes nodes when deleted from the
cloud-provider.
- LoadBalancer interface - responsible for creating load balancers when a service
of `type: LoadBalancer` is created in Kubernetes.
- Zone interface - makes Kubernetes aware of the failure domain of each node.
## Branches and releases
There are two types of branches:
- `master` which is the main branch
- `release-x.y` which are the release branches. Each branch is built against Kubernetes 1.y
Most of the PRs on `master` will be backported to the supported `release-x.y` branches.
Each release will be cut from the `release-x.y` branch, and will be in the form of `x.y.z` where `z` will be the Scaleway Cloud Controller patch version.
## Getting Started
Learn more about running `scaleway-cloud-controller-manager` [here](docs/getting-started.md)!
**WARNING**: This cloud controller manager is installed by default on [Scaleway Kapsule](https://www.scaleway.com/en/kubernetes-kapsule) (Scaleway Managed Kubernetes), you don't have to do it yourself or it might cause conflicts.
### Quick start
## Build
You can build the CCM executable using the following commands:
```bash
make build
```
You can build a local docker image named scaleway-cloud-controller for your current architecture using the following command:
```bash
make docker-build
```
## Test
You need to have a kubernetes cluster that is NOT a Kapsule cluster to launch the tests.
If you want to follow a tutorial about bootstrapping your own Kubernetes cluster on Scaleway follow the getting starting documentation [here](docs/getting-started.md)
Once this is done, run the tests using
```bash
make test
```
## Development
If you are looking for a way to contribute please read [CONTRIBUTING](CONTRIBUTING.md).
### Code of conduct
Participation in the Kubernetes community is governed by the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/master/code-of-conduct.md).
## Reach us
We love feedback. Feel free to reach us on [Scaleway Slack community](https://slack.scaleway.com), we are waiting for you on #k8s.
You can also join the official Kubernetes slack on #scaleway-k8s channel
You can also [raise an issue](https://github.com/scaleway/scaleway-cloud-controller-manager/issues/new) if you think you've found a bug.