Compare commits

..

No commits in common. "master" and "7.0.0" have entirely different histories.

20 changed files with 264 additions and 247 deletions

56
.github/stale.yml vendored Normal file
View File

@ -0,0 +1,56 @@
# Configuration for probot-stale - https://github.com/probot/stale
# Number of days of inactivity before an Issue or Pull Request becomes stale
daysUntilStale: 90
# Number of days of inactivity before an Issue or Pull Request with the stale label is closed.
# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.
daysUntilClose: 30
# Only issues or pull requests with all of these labels are check if stale. Defaults to `[]` (disabled)
onlyLabels: []
# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
exemptLabels:
- pinned
- security
- planned
# Set to true to ignore issues in a project (defaults to false)
exemptProjects: false
# Set to true to ignore issues in a milestone (defaults to false)
exemptMilestones: false
# Set to true to ignore issues with an assignee (defaults to false)
exemptAssignees: false
# Label to use when marking as stale
staleLabel: stale
# Limit the number of actions per hour, from 1-30. Default is 30
limitPerRun: 30
pulls:
markComment: |-
This pull request has been marked 'stale' due to lack of recent activity. If there is no further activity, the PR will be closed in another 30 days. Thank you for your contribution!
Please read [this blog post](https://www.jeffgeerling.com/blog/2020/enabling-stale-issue-bot-on-my-github-repositories) to see the reasons why I mark pull requests as stale.
unmarkComment: >-
This pull request is no longer marked for closure.
closeComment: >-
This pull request has been closed due to inactivity. If you feel this is in error, please reopen the pull request or file a new PR with the relevant details.
issues:
markComment: |-
This issue has been marked 'stale' due to lack of recent activity. If there is no further activity, the issue will be closed in another 30 days. Thank you for your contribution!
Please read [this blog post](https://www.jeffgeerling.com/blog/2020/enabling-stale-issue-bot-on-my-github-repositories) to see the reasons why I mark issues as stale.
unmarkComment: >-
This issue is no longer marked for closure.
closeComment: >-
This issue has been closed due to inactivity. If you feel this is in error, please reopen the issue or file a new issue with the relevant details.

View File

@ -19,12 +19,12 @@ jobs:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Check out the codebase. - name: Check out the codebase.
uses: actions/checkout@v4 uses: actions/checkout@v2
with: with:
path: 'geerlingguy.kubernetes' path: 'geerlingguy.kubernetes'
- name: Set up Python 3. - name: Set up Python 3.
uses: actions/setup-python@v5 uses: actions/setup-python@v2
with: with:
python-version: '3.x' python-version: '3.x'
@ -41,29 +41,31 @@ jobs:
strategy: strategy:
matrix: matrix:
include: include:
- distro: rockylinux9 - distro: centos8
playbook: converge.yml playbook: converge.yml
- distro: ubuntu2004 - distro: centos7
playbook: converge.yml playbook: converge.yml
- distro: debian11 - distro: ubuntu1804
playbook: converge.yml
- distro: debian10
playbook: converge.yml playbook: converge.yml
- distro: debian11 - distro: debian10
playbook: calico.yml playbook: calico.yml
steps: steps:
- name: Check out the codebase. - name: Check out the codebase.
uses: actions/checkout@v4 uses: actions/checkout@v2
with: with:
path: 'geerlingguy.kubernetes' path: 'geerlingguy.kubernetes'
- name: Set up Python 3. - name: Set up Python 3.
uses: actions/setup-python@v5 uses: actions/setup-python@v2
with: with:
python-version: '3.x' python-version: '3.x'
- name: Install test dependencies. - name: Install test dependencies.
run: pip3 install ansible molecule molecule-plugins[docker] docker run: pip3 install ansible molecule[docker] docker
- name: Run Molecule tests. - name: Run Molecule tests.
run: molecule test run: molecule test

View File

@ -22,19 +22,17 @@ jobs:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Check out the codebase. - name: Check out the codebase.
uses: actions/checkout@v4 uses: actions/checkout@v2
with: with:
path: 'geerlingguy.kubernetes' path: 'geerlingguy.kubernetes'
- name: Set up Python 3. - name: Set up Python 3.
uses: actions/setup-python@v5 uses: actions/setup-python@v2
with: with:
python-version: '3.x' python-version: '3.x'
- name: Install Ansible. - name: Install Ansible.
run: pip3 install ansible-core run: pip3 install ansible-base
- name: Trigger a new import on Galaxy. - name: Trigger a new import on Galaxy.
run: >- run: ansible-galaxy role import --api-key ${{ secrets.GALAXY_API_KEY }} $(echo ${{ github.repository }} | cut -d/ -f1) $(echo ${{ github.repository }} | cut -d/ -f2)
ansible-galaxy role import --api-key ${{ secrets.GALAXY_API_KEY }}
$(echo ${{ github.repository }} | cut -d/ -f1) $(echo ${{ github.repository }} | cut -d/ -f2)

View File

@ -1,34 +0,0 @@
---
name: Close inactive issues
'on':
schedule:
- cron: "55 3 * * 0" # semi-random time
jobs:
close-issues:
runs-on: ubuntu-latest
permissions:
issues: write
pull-requests: write
steps:
- uses: actions/stale@v8
with:
days-before-stale: 120
days-before-close: 60
exempt-issue-labels: bug,pinned,security,planned
exempt-pr-labels: bug,pinned,security,planned
stale-issue-label: "stale"
stale-pr-label: "stale"
stale-issue-message: |
This issue has been marked 'stale' due to lack of recent activity. If there is no further activity, the issue will be closed in another 30 days. Thank you for your contribution!
Please read [this blog post](https://www.jeffgeerling.com/blog/2020/enabling-stale-issue-bot-on-my-github-repositories) to see the reasons why I mark issues as stale.
close-issue-message: |
This issue has been closed due to inactivity. If you feel this is in error, please reopen the issue or file a new issue with the relevant details.
stale-pr-message: |
This pr has been marked 'stale' due to lack of recent activity. If there is no further activity, the issue will be closed in another 30 days. Thank you for your contribution!
Please read [this blog post](https://www.jeffgeerling.com/blog/2020/enabling-stale-issue-bot-on-my-github-repositories) to see the reasons why I mark issues as stale.
close-pr-message: |
This pr has been closed due to inactivity. If you feel this is in error, please reopen the issue or file a new issue with the relevant details.
repo-token: ${{ secrets.GITHUB_TOKEN }}

36
.travis.yml Normal file
View File

@ -0,0 +1,36 @@
---
language: python
services: docker
env:
global:
- ROLE_NAME: kubernetes
matrix:
- MOLECULE_DISTRO: centos8
- MOLECULE_DISTRO: centos7
- MOLECULE_DISTRO: ubuntu1804
- MOLECULE_DISTRO: debian10
- MOLECULE_DISTRO: debian10
MOLECULE_PLAYBOOK: playbook-calico.yml
before_install:
# Upgrade Docker to work with docker-py.
- curl https://gist.githubusercontent.com/geerlingguy/ce883ad4aec6a5f1187ef93bd338511e/raw/36612d28981d92863f839c5aefe5b7dd7193d6c6/travis-ci-docker-upgrade.sh | sudo bash
install:
# Install test dependencies.
- pip install molecule[docker] yamllint ansible-lint docker
before_script:
# Use actual Ansible Galaxy role name for the project directory.
- cd ../
- mv ansible-role-$ROLE_NAME geerlingguy.$ROLE_NAME
- cd geerlingguy.$ROLE_NAME
script:
# Run tests.
- molecule test
notifications:
webhooks: https://galaxy.ansible.com/api/v1/notifications/

View File

@ -7,4 +7,5 @@ rules:
level: warning level: warning
ignore: | ignore: |
.github/workflows/stale.yml .github/stale.yml
.travis.yml

177
README.md
View File

@ -1,171 +1,134 @@
# Ansible Role: Kubernetes # Ansible Role: Kubernetes
[![CI](https://github.com/geerlingguy/ansible-role-kubernetes/actions/workflows/ci.yml/badge.svg)](https://github.com/geerlingguy/ansible-role-kubernetes/actions/workflows/ci.yml) [![CI](https://github.com/geerlingguy/ansible-role-kubernetes/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-kubernetes/actions?query=workflow%3ACI)
An Ansible Role that installs [Kubernetes](https://kubernetes.io) on Linux. An Ansible Role that installs [Kubernetes](https://kubernetes.io) on Linux.
## Requirements ## Requirements
Requires a compatible [Container Runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes); recommended role for CRI installation: `geerlingguy.containerd`. Requires Docker or another [Container Runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes) ; recommended role for Docker installation: `geerlingguy.docker`.
## Role Variables ## Role Variables
Available variables are listed below, along with default values (see `defaults/main.yml`): Available variables are listed below, along with default values (see `defaults/main.yml`):
```yaml kubernetes_packages:
kubernetes_packages: - name: kubelet
- name: kubelet state: present
state: present - name: kubectl
- name: kubectl state: present
state: present - name: kubeadm
- name: kubeadm state: present
state: present - name: kubernetes-cni
- name: kubernetes-cni state: present
state: present
```
Kubernetes packages to be installed on the server. You can either provide a list of package names, or set `name` and `state` to have more control over whether the package is `present`, `absent`, `latest`, etc. Kubernetes packages to be installed on the server. You can either provide a list of package names, or set `name` and `state` to have more control over whether the package is `present`, `absent`, `latest`, etc.
```yaml kubernetes_version: '1.20'
kubernetes_version: '1.32' kubernetes_version_rhel_package: '1.20.4'
kubernetes_version_rhel_package: '1.32'
```
The minor version of Kubernetes to install. The plain `kubernetes_version` is used to pin an apt package version on Debian, and as the Kubernetes version passed into the `kubeadm init` command (see `kubernetes_version_kubeadm`). The `kubernetes_version_rhel_package` variable must be a specific Kubernetes release, and is used to pin the version on Red Hat / CentOS servers. The minor version of Kubernetes to install. The plain `kubernetes_version` is used to pin an apt package version on Debian, and as the Kubernetes version passed into the `kubeadm init` command (see `kubernetes_version_kubeadm`). The `kubernetes_version_rhel_package` variable must be a specific Kubernetes release, and is used to pin the version on Red Hat / CentOS servers.
```yaml kubernetes_role: master
kubernetes_role: control_plane
```
Whether the particular server will serve as a Kubernetes `control_plane` (default) or `node`. The control plane will have `kubeadm init` run on it to intialize the entire K8s control plane, while `node`s will have `kubeadm join` run on them to join them to the `control_plane`. Whether the particular server will serve as a Kubernetes `master` (default) or `node`. The master will have `kubeadm init` run on it to intialize the entire K8s control plane, while `node`s will have `kubeadm join` run on them to join them to the `master`.
### Variables to configure kubeadm and kubelet with `kubeadm init` through a config file (recommended) ### Variables to configure kubeadm and kubelet with `kubeadm init` through a config file (recommended)
With this role, `kubeadm init` will be run with `--config <FILE>`. With this role, `kubeadm init` will be run with `--config <FILE>`.
```yaml kubernetes_kubeadm_kubelet_config_file_path: '/etc/kubernetes/kubeadm-kubelet-config.yaml'
kubernetes_kubeadm_kubelet_config_file_path: '/etc/kubernetes/kubeadm-kubelet-config.yaml'
```
Path for `<FILE>`. If the directory does not exist, this role will create it. Path for `<FILE>`. If the directory does not exist, this role will create it.
The following variables are parsed as options to <FILE>. To understand its syntax, see [kubelet-integration](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/kubelet-integration) and [kubeadm-config-file](https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm-init/#config-file) . The skeleton (`apiVersion`, `kind`) of the config file will be created by this role, so do not define them within the variables. (See `templates/kubeadm-kubelet-config.j2`). The following variables are parsed as options to <FILE>. To understand its syntax, see https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/kubelet-integration and https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm-init/#config-file . The skeleton (`apiVersion`, `kind`) of the config file will be created by this role, so do not define them within the variables. (See `templates/kubeadm-kubelet-config.yaml`).
```yaml kubernetes_config_init_configuration:
kubernetes_config_init_configuration: localAPIEndpoint:
localAPIEndpoint: advertiseAddress: "{{ kubernetes_apiserver_advertise_address | default(ansible_default_ipv4.address, true) }}"
advertiseAddress: "{{ kubernetes_apiserver_advertise_address | default(ansible_default_ipv4.address, true) }}"
```
Defines the options under `kind: InitConfiguration`. Including `kubernetes_apiserver_advertise_address` here is for backward-compatibilty to older versions of this role, where `kubernetes_apiserver_advertise_address` was used with a command-line-option. Defines the options under `kind: InitConfiguration`. Including `kubernetes_apiserver_advertise_address` here is for backward-compatibilty to older versions of this role, where `kubernetes_apiserver_advertise_address` was used with a command-line-option.
```yaml kubernetes_config_cluster_configuration:
kubernetes_config_cluster_configuration: networking:
networking: podSubnet: "{{ kubernetes_pod_network.cidr }}"
podSubnet: "{{ kubernetes_pod_network.cidr }}" kubernetesVersion: "{{ kubernetes_version_kubeadm }}"
kubernetesVersion: "{{ kubernetes_version_kubeadm }}"
```
Options under `kind: ClusterConfiguration`. Including `kubernetes_pod_network.cidr` and `kubernetes_version_kubeadm` here are for backward-compatibilty to older versions of this role, where they were used with command-line-options. Options under `kind: ClusterConfiguration`. Including `kubernetes_pod_network.cidr` and `kubernetes_version_kubeadm` here are for backward-compatibilty to older versions of this role, where they were used with command-line-options.
```yaml kubernetes_config_kubelet_configuration:
kubernetes_config_kubelet_configuration: cgroupDriver: cgroupfs
cgroupDriver: systemd
```
Options to configure kubelet on any nodes in your cluster through the `kubeadm init` process. For syntax options read the [kubelet config file](https://kubernetes.io/docs/tasks/administer-cluster/kubelet-config-file) and [kubelet integration](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/kubelet-integration) documentation. Options to configure kubelet on any nodes in your cluster through the `kubeadm init` process. To get the syntax of this options see https://kubernetes.io/docs/tasks/administer-cluster/kubelet-config-file and https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/kubelet-integration.
NOTE: This is the recommended way to do the kubelet-configuration. Most command-line-options are deprecated. NOTE: This is the recommended way to do the kubelet-configuration. Most command-line-options are deprecated.
NOTE: The recommended cgroupDriver depends on your [Container Runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes). When using this role with Docker instead of containerd, this value should be changed to `cgroupfs`. NOTE: The recommended cgroupDriver depends on your [Container Runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes). When using this role with containerd instead of docker, this value should be changed to `systemd`.
```yaml kubernetes_config_kube_proxy_configuration: {}
kubernetes_config_kube_proxy_configuration: {}
```
Options to configure kubelet's proxy configuration in the `KubeProxyConfiguration` section of the kubelet configuration. Options to configure kubelet's proxy configuration in the `KubeProxyConfiguration` section of the kubelet configuration.
### Variables to configure kubeadm and kubelet through command-line-options ### Variables to configure kubeadm and kubelet through command-line-options
```yaml kubernetes_kubelet_extra_args: ""
kubernetes_kubelet_extra_args: "" kubernetes_kubelet_extra_args_config_file: /etc/default/kubelet
kubernetes_kubelet_extra_args_config_file: /etc/default/kubelet
```
Extra args to pass to `kubelet` during startup. E.g. to allow `kubelet` to start up even if there is swap is enabled on your server, set this to: `"--fail-swap-on=false"`. Or to specify the node-ip advertised by `kubelet`, set this to `"--node-ip={{ ansible_host }}"`. **This option is deprecated. Please use `kubernetes_config_kubelet_configuration` instead.** Extra args to pass to `kubelet` during startup. E.g. to allow `kubelet` to start up even if there is swap is enabled on your server, set this to: `"--fail-swap-on=false"`. Or to specify the node-ip advertised by `kubelet`, set this to `"--node-ip={{ ansible_host }}"`. *This is deprecated. Please use `kubernetes_config_kubelet_configuration` instead.*
```yaml kubernetes_kubeadm_init_extra_opts: ""
kubernetes_kubeadm_init_extra_opts: ""
```
Extra args to pass to `kubeadm init` during K8s control plane initialization. E.g. to specify extra Subject Alternative Names for API server certificate, set this to: `"--apiserver-cert-extra-sans my-custom.host"` Extra args to pass to `kubeadm init` during K8s control plane initialization. E.g. to specify extra Subject Alternative Names for API server certificate, set this to: `"--apiserver-cert-extra-sans my-custom.host"`
```yaml kubernetes_join_command_extra_opts: ""
kubernetes_join_command_extra_opts: ""
```
Extra args to pass to the generated `kubeadm join` command during K8s node initialization. E.g. to ignore certain preflight errors like swap being enabled, set this to: `--ignore-preflight-errors=Swap` Extra args to pass to the generated `kubeadm join` command during K8s node initialization. E.g. to ignore certain preflight errors like swap being enabled, set this to: `--ignore-preflight-errors=Swap`
### Additional variables ### Additional variables
```yaml kubernetes_allow_pods_on_master: true
kubernetes_allow_pods_on_control_plane: true
```
Whether to remove the taint that denies pods from being deployed to the Kubernetes control plane. If you have a single-node cluster, this should definitely be `True`. Otherwise, set to `False` if you want a dedicated Kubernetes control plane which doesn't run any other pods. Whether to remove the taint that denies pods from being deployed to the Kubernetes master. If you have a single-node cluster, this should definitely be `True`. Otherwise, set to `False` if you want a dedicated Kubernetes master which doesn't run any other pods.
```yaml kubernetes_pod_network:
kubernetes_pod_network: # Flannel CNI.
# Flannel CNI. cni: 'flannel'
cni: 'flannel' cidr: '10.244.0.0/16'
cidr: '10.244.0.0/16' #
# # Calico CNI.
# Calico CNI. # cni: 'calico'
# cni: 'calico' # cidr: '192.168.0.0/16'
# cidr: '192.168.0.0/16' #
# # Weave CNI.
# Weave CNI. # cni: 'weave'
# cni: 'weave' # cidr: '192.168.0.0/16'
# cidr: '192.168.0.0/16'
```
This role currently supports `flannel` (default), `calico` or `weave` for cluster pod networking. Choose only one for your cluster; converting between them is not done automatically and could result in broken networking; if you need to switch from one to another, it should be done outside of this role. This role currently supports `flannel` (default), `calico` or `weave` for cluster pod networking. Choose only one for your cluster; converting between them is not done automatically and could result in broken networking; if you need to switch from one to another, it should be done outside of this role.
```yaml kubernetes_apiserver_advertise_address: ''
kubernetes_apiserver_advertise_address: ''` kubernetes_version_kubeadm: 'stable-{{ kubernetes_version }}'
kubernetes_version_kubeadm: 'stable-{{ kubernetes_version }}'` kubernetes_ignore_preflight_errors: 'all'
kubernetes_ignore_preflight_errors: 'all'
```
Options passed to `kubeadm init` when initializing the Kubernetes control plane. The `kubernetes_apiserver_advertise_address` defaults to `ansible_default_ipv4.address` if it's left empty. Options passed to `kubeadm init` when initializing the Kubernetes master. The `kubernetes_apiserver_advertise_address` defaults to `ansible_default_ipv4.address` if it's left empty.
```yaml kubernetes_apt_release_channel: main
kubernetes_apt_release_channel: "stable" kubernetes_apt_repository: "deb http://apt.kubernetes.io/ kubernetes-xenial {{ kubernetes_apt_release_channel }}"
kubernetes_apt_repository: "https://pkgs.k8s.io/core:/{{ kubernetes_apt_release_channel }}:/v{{ kubernetes_version }}/deb/" kubernetes_apt_ignore_key_error: false
```
Apt repository options for Kubernetes installation. Apt repository options for Kubernetes installation.
```yaml kubernetes_yum_arch: x86_64
kubernetes_yum_base_url: "https://pkgs.k8s.io/core:/stable:/v{{ kubernetes_version }}/rpm/" kubernetes_yum_base_url: "https://packages.cloud.google.com/yum/repos/kubernetes-el7-{{ kubernetes_yum_arch }}"
kubernetes_yum_gpg_key: "https://pkgs.k8s.io/core:/stable:/v{{ kubernetes_version }}/rpm/repodata/repomd.xml.key" kubernetes_yum_gpg_key:
kubernetes_yum_gpg_check: true - https://packages.cloud.google.com/yum/doc/yum-key.gpg
kubernetes_yum_repo_gpg_check: true - https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
```
Yum repository options for Kubernetes installation. You can change `kubernete_yum_gpg_key` to a different url if you are behind a firewall or provide a trustworthy mirror. Usually in combination with changing `kubernetes_yum_base_url` as well. Yum repository options for Kubernetes installation. You can change `kubernete_yum_gpg_key` to a different url if you are behind a firewall or provide a trustworthy mirror. Usually in combination with changing `kubernetes_yum_base_url` as well.
```yaml kubernetes_flannel_manifest_file_rbac: https://raw.githubusercontent.com/coreos/flannel/master/Documentation/k8s-manifests/kube-flannel-rbac.yml
kubernetes_flannel_manifest_file: https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml kubernetes_flannel_manifest_file: https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
```
Flannel manifest file to apply to the Kubernetes cluster to enable networking. You can copy your own files to your server and apply them instead, if you need to customize the Flannel networking configuration. Flannel manifest files to apply to the Kubernetes cluster to enable networking. You can copy your own files to your server and apply them instead, if you need to customize the Flannel networking configuration.
```yaml
kubernetes_calico_manifest_file: https://projectcalico.docs.tigera.io/manifests/calico.yaml
```
Calico manifest file to apply to the Kubernetes cluster (if using Calico instead of Flannel).
## Dependencies ## Dependencies
@ -173,25 +136,25 @@ None.
## Example Playbooks ## Example Playbooks
### Single node (control-plane-only) cluster ### Single node (master-only) cluster
```yaml ```yaml
- hosts: all - hosts: all
vars: vars:
kubernetes_allow_pods_on_control_plane: true kubernetes_allow_pods_on_master: true
roles: roles:
- geerlingguy.docker - geerlingguy.docker
- geerlingguy.kubernetes - geerlingguy.kubernetes
``` ```
### Two or more nodes (single control-plane) cluster ### Two or more nodes (single master) cluster
Control plane inventory vars: Master inventory vars:
```yaml ```yaml
kubernetes_role: "control_plane" kubernetes_role: "master"
``` ```
Node(s) inventory vars: Node(s) inventory vars:
@ -206,14 +169,14 @@ Playbook:
- hosts: all - hosts: all
vars: vars:
kubernetes_allow_pods_on_control_plane: true kubernetes_allow_pods_on_master: true
roles: roles:
- geerlingguy.docker - geerlingguy.docker
- geerlingguy.kubernetes - geerlingguy.kubernetes
``` ```
Then, log into the Kubernetes control plane, and run `kubectl get nodes` as root, and you should see a list of all the servers. Then, log into the Kubernetes master, and run `kubectl get nodes` as root, and you should see a list of all the servers.
## License ## License

View File

@ -9,17 +9,17 @@ kubernetes_packages:
- name: kubernetes-cni - name: kubernetes-cni
state: present state: present
kubernetes_version: '1.32' kubernetes_version: '1.20'
kubernetes_version_rhel_package: '1.32' kubernetes_version_rhel_package: '1.20.4'
kubernetes_role: control_plane kubernetes_role: master
# This is deprecated. Please use kubernetes_config_kubelet_configuration instead. # This is deprecated. Please use kubernetes_config_kubelet_configuration instead.
kubernetes_kubelet_extra_args: "" kubernetes_kubelet_extra_args: ""
kubernetes_kubeadm_init_extra_opts: "" kubernetes_kubeadm_init_extra_opts: ""
kubernetes_join_command_extra_opts: "" kubernetes_join_command_extra_opts: ""
kubernetes_allow_pods_on_control_plane: true kubernetes_allow_pods_on_master: true
kubernetes_pod_network: kubernetes_pod_network:
# Flannel CNI. # Flannel CNI.
cni: 'flannel' cni: 'flannel'
@ -29,13 +29,8 @@ kubernetes_pod_network:
# cidr: '192.168.0.0/16' # cidr: '192.168.0.0/16'
kubernetes_kubeadm_kubelet_config_file_path: '/etc/kubernetes/kubeadm-kubelet-config.yaml' kubernetes_kubeadm_kubelet_config_file_path: '/etc/kubernetes/kubeadm-kubelet-config.yaml'
kubernetes_config_kubeadm_apiversion: v1beta3
kubenetes_config_kubelet_apiversion: v1beta1
kubernetes_config_kubeproxy_apiversion: v1alpha1
kubernetes_config_kubelet_configuration: kubernetes_config_kubelet_configuration:
cgroupDriver: "systemd" cgroupDriver: "cgroupfs"
kubernetes_config_init_configuration: kubernetes_config_init_configuration:
localAPIEndpoint: localAPIEndpoint:
@ -56,16 +51,20 @@ kubernetes_apiserver_advertise_address: ''
kubernetes_version_kubeadm: 'stable-{{ kubernetes_version }}' kubernetes_version_kubeadm: 'stable-{{ kubernetes_version }}'
kubernetes_ignore_preflight_errors: 'all' kubernetes_ignore_preflight_errors: 'all'
kubernetes_apt_release_channel: "stable" kubernetes_apt_release_channel: main
kubernetes_apt_repository: "https://pkgs.k8s.io/core:/{{ kubernetes_apt_release_channel }}:/v{{ kubernetes_version }}/deb/" # Note that xenial repo is used for all Debian derivatives at this time.
kubernetes_apt_repository: "deb http://apt.kubernetes.io/ kubernetes-xenial {{ kubernetes_apt_release_channel }}"
kubernetes_apt_ignore_key_error: false
kubernetes_yum_base_url: "https://pkgs.k8s.io/core:/stable:/v{{ kubernetes_version }}/rpm/" kubernetes_yum_arch: '$basearch'
kubernetes_yum_gpg_key: "https://pkgs.k8s.io/core:/stable:/v{{ kubernetes_version }}/rpm/repodata/repomd.xml.key" kubernetes_yum_base_url: "https://packages.cloud.google.com/yum/repos/kubernetes-el7-{{ kubernetes_yum_arch }}"
kubernetes_yum_gpg_check: true kubernetes_yum_gpg_key:
kubernetes_yum_repo_gpg_check: true - https://packages.cloud.google.com/yum/doc/yum-key.gpg
- https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
# Flannel config file. # Flannel config files.
kubernetes_flannel_manifest_file: https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml kubernetes_flannel_manifest_file_rbac: https://raw.githubusercontent.com/coreos/flannel/master/Documentation/k8s-manifests/kube-flannel-rbac.yml
kubernetes_flannel_manifest_file: https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
# Calico config file. # Calico config files
kubernetes_calico_manifest_file: https://projectcalico.docs.tigera.io/manifests/calico.yaml kubernetes_calico_manifest_file: https://docs.projectcalico.org/v3.10/manifests/calico.yaml

View File

@ -7,19 +7,21 @@ galaxy_info:
description: Kubernetes for Linux. description: Kubernetes for Linux.
company: "Midwestern Mac, LLC" company: "Midwestern Mac, LLC"
license: "license (BSD, MIT)" license: "license (BSD, MIT)"
min_ansible_version: 2.10 min_ansible_version: 2.4
platforms: platforms:
- name: EL
versions:
- 7
- 8
- name: Debian - name: Debian
versions: versions:
- stretch - stretch
- buster - buster
- bullseye
- name: Ubuntu - name: Ubuntu
versions: versions:
- xenial - xenial
- bionic - bionic
- focal - focal
- jammy
galaxy_tags: galaxy_tags:
- system - system
- containers - containers

View File

@ -1,20 +1,16 @@
--- ---
- name: Converge - name: Converge
hosts: all hosts: all
#become: true become: true
vars: vars:
kubernetes_pod_network: kubernetes_pod_network:
cni: 'calico' cni: 'calico'
cidr: '192.168.0.0/16' cidr: '192.168.0.0/16'
# Allow swap in test environments (hard to control in some envs). # Allow swap in test environments (hard to control in some Docker envs).
kubernetes_config_kubelet_configuration: kubernetes_kubelet_extra_args: "--fail-swap-on=false --cgroup-driver=cgroupfs"
cgroupDriver: "systemd" docker_install_compose: false
failSwapOn: false
cgroupsPerQOS: true
enforceNodeAllocatable: ['pods']
containerd_config_cgroup_driver_systemd: true
pre_tasks: pre_tasks:
- name: Update apt cache. - name: Update apt cache.
@ -33,7 +29,7 @@
action: setup action: setup
roles: roles:
- role: geerlingguy.containerd - role: geerlingguy.docker
- role: geerlingguy.kubernetes - role: geerlingguy.kubernetes
post_tasks: post_tasks:

View File

@ -1,16 +1,12 @@
--- ---
- name: Converge - name: Converge
hosts: all hosts: all
#become: true become: true
vars: vars:
# Allow swap in test environments (hard to control in some envs). # Allow swap in test environments (hard to control in some Docker envs).
kubernetes_config_kubelet_configuration: kubernetes_kubelet_extra_args: "--fail-swap-on=false --cgroup-driver=cgroupfs"
cgroupDriver: "systemd" docker_install_compose: false
failSwapOn: false
cgroupsPerQOS: true
enforceNodeAllocatable: ['pods']
containerd_config_cgroup_driver_systemd: true
pre_tasks: pre_tasks:
- name: Update apt cache. - name: Update apt cache.
@ -29,7 +25,7 @@
action: setup action: setup
roles: roles:
- role: geerlingguy.containerd - role: geerlingguy.docker
- role: geerlingguy.kubernetes - role: geerlingguy.kubernetes
post_tasks: post_tasks:

View File

@ -1,19 +1,15 @@
--- ---
role_name_check: 1
dependency: dependency:
name: galaxy name: galaxy
options:
ignore-errors: true
driver: driver:
name: docker name: docker
platforms: platforms:
- name: instance - name: instance
image: "geerlingguy/docker-${MOLECULE_DISTRO:-rockylinux9}-ansible:latest" image: "geerlingguy/docker-${MOLECULE_DISTRO:-centos7}-ansible:latest"
command: ${MOLECULE_DOCKER_COMMAND:-""} command: ${MOLECULE_DOCKER_COMMAND:-""}
volumes: volumes:
- /sys/fs/cgroup:/sys/fs/cgroup:rw - /sys/fs/cgroup:/sys/fs/cgroup:ro
- /var/lib/containerd - /var/lib/docker
cgroupns_mode: host
privileged: true privileged: true
pre_build_image: true pre_build_image: true
provisioner: provisioner:

View File

@ -1,2 +1,2 @@
--- ---
- src: geerlingguy.containerd - src: geerlingguy.docker

View File

@ -34,15 +34,15 @@
path: /etc/kubernetes/admin.conf path: /etc/kubernetes/admin.conf
register: kubernetes_init_stat register: kubernetes_init_stat
# Set up control plane. # Set up master.
- include_tasks: control-plane-setup.yml - include_tasks: master-setup.yml
when: kubernetes_role == 'control_plane' when: kubernetes_role == 'master'
# Set up nodes. # Set up nodes.
- name: Get the kubeadm join command from the Kubernetes control plane. - name: Get the kubeadm join command from the Kubernetes master.
command: kubeadm token create --print-join-command command: kubeadm token create --print-join-command
changed_when: false changed_when: false
when: kubernetes_role == 'control_plane' when: kubernetes_role == 'master'
register: kubernetes_join_command_result register: kubernetes_join_command_result
- name: Set the kubeadm join command globally. - name: Set the kubeadm join command globally.

View File

@ -9,7 +9,7 @@
src: "kubeadm-kubelet-config.j2" src: "kubeadm-kubelet-config.j2"
dest: "{{ kubernetes_kubeadm_kubelet_config_file_path }}" dest: "{{ kubernetes_kubeadm_kubelet_config_file_path }}"
- name: Initialize Kubernetes control plane with kubeadm init - name: Initialize Kubernetes master with kubeadm init
command: > command: >
kubeadm init kubeadm init
--config {{ kubernetes_kubeadm_kubelet_config_file_path }} --config {{ kubernetes_kubeadm_kubelet_config_file_path }}
@ -17,7 +17,7 @@
register: kubeadmin_init register: kubeadmin_init
when: (not kubernetes_init_stat.stat.exists) and (kubernetes_ignore_preflight_errors is not defined) when: (not kubernetes_init_stat.stat.exists) and (kubernetes_ignore_preflight_errors is not defined)
- name: Initialize Kubernetes control plane with kubeadm init and ignore_preflight_errors - name: Initialize Kubernetes master with kubeadm init and ignore_preflight_errors
command: > command: >
kubeadm init kubeadm init
--config {{ kubernetes_kubeadm_kubelet_config_file_path }} --config {{ kubernetes_kubeadm_kubelet_config_file_path }}
@ -46,31 +46,27 @@
mode: 0644 mode: 0644
- name: Configure Flannel networking. - name: Configure Flannel networking.
command: "kubectl apply -f {{ kubernetes_flannel_manifest_file }}" command: "{{ item }}"
with_items:
- kubectl apply -f {{ kubernetes_flannel_manifest_file_rbac }}
- kubectl apply -f {{ kubernetes_flannel_manifest_file }}
register: flannel_result register: flannel_result
changed_when: "'created' in flannel_result.stdout" changed_when: "'created' in flannel_result.stdout"
when: kubernetes_pod_network.cni == 'flannel' when: kubernetes_pod_network.cni == 'flannel'
until: flannel_result is not failed
retries: 12
delay: 5
- name: Configure Calico networking. - name: Configure Calico networking.
command: "kubectl apply -f {{ kubernetes_calico_manifest_file }}" command: "{{ item }}"
with_items:
- kubectl apply -f {{ kubernetes_calico_manifest_file }}
register: calico_result register: calico_result
changed_when: "'created' in calico_result.stdout" changed_when: "'created' in calico_result.stdout"
when: kubernetes_pod_network.cni == 'calico' when: kubernetes_pod_network.cni == 'calico'
until: calico_result is not failed
retries: 12
delay: 5
- name: Get Kubernetes version for Weave installation. - name: Get Kubernetes version for Weave installation.
shell: kubectl version | base64 | tr -d '\n' shell: kubectl version | base64 | tr -d '\n'
changed_when: false changed_when: false
register: kubectl_version register: kubectl_version
when: kubernetes_pod_network.cni == 'weave' when: kubernetes_pod_network.cni == 'weave'
until: kubectl_version is not failed
retries: 12
delay: 5
- name: Configure Weave networking. - name: Configure Weave networking.
command: "{{ item }}" command: "{{ item }}"
@ -82,8 +78,8 @@
# TODO: Check if taint exists with something like `kubectl describe nodes` # TODO: Check if taint exists with something like `kubectl describe nodes`
# instead of using kubernetes_init_stat.stat.exists check. # instead of using kubernetes_init_stat.stat.exists check.
- name: Allow pods on control plane (if configured). - name: Allow pods on master node (if configured).
command: "kubectl taint nodes --all node-role.kubernetes.io/control-plane-" command: "kubectl taint nodes --all node-role.kubernetes.io/master-"
when: when:
- kubernetes_allow_pods_on_control_plane | bool - kubernetes_allow_pods_on_master | bool
- not kubernetes_init_stat.stat.exists - not kubernetes_init_stat.stat.exists

View File

@ -1,5 +1,5 @@
--- ---
- name: Join node to Kubernetes control plane. - name: Join node to Kubernetes master
shell: > shell: >
{{ kubernetes_join_command }} {{ kubernetes_join_command }}
creates=/etc/kubernetes/kubelet.conf creates=/etc/kubernetes/kubelet.conf

View File

@ -4,22 +4,20 @@
name: name:
- apt-transport-https - apt-transport-https
- ca-certificates - ca-certificates
- python3-debian
state: present state: present
- name: Add Kubernetes repository. - name: Add Kubernetes apt key.
deb822_repository: apt_key:
name: kubernetes url: https://packages.cloud.google.com/apt/doc/apt-key.gpg
types: deb state: present
uris: "{{ kubernetes_apt_repository }}" register: add_repository_key
suites: / ignore_errors: "{{ kubernetes_apt_ignore_key_error }}"
signed_by: "{{ kubernetes_apt_repository }}/Release.key"
register: kubernetes_repository
- name: Update Apt cache. - name: Add Kubernetes repository.
apt: apt_repository:
repo: "{{ kubernetes_apt_repository }}"
state: present
update_cache: true update_cache: true
when: kubernetes_repository.changed
- name: Add Kubernetes apt preferences file to pin a version. - name: Add Kubernetes apt preferences file to pin a version.
template: template:

View File

@ -4,17 +4,20 @@
name: kubernetes name: kubernetes
description: Kubernetes description: Kubernetes
enabled: true enabled: true
gpgcheck: "{{ kubernetes_yum_gpg_check }}" gpgcheck: true
repo_gpgcheck: "{{ kubernetes_yum_repo_gpg_check }}" repo_gpgcheck: true
baseurl: "{{ kubernetes_yum_base_url }}" baseurl: "{{ kubernetes_yum_base_url }}"
gpgkey: "{{ kubernetes_yum_gpg_key }}" gpgkey: "{{ kubernetes_yum_gpg_key }}"
- name: Add Kubernetes GPG keys. - name: Add Kubernetes GPG keys.
rpm_key: rpm_key:
key: "{{ kubernetes_yum_gpg_key }}" key: "{{ item }}"
state: present state: present
register: kubernetes_rpm_key register: kubernetes_rpm_key
with_items: "{{ kubernetes_yum_gpg_key }}"
- name: Make cache if Kubernetes GPG key changed. - name: Make cache if Kubernetes GPG key changed.
command: "yum -q makecache -y --disablerepo='*' --enablerepo='kubernetes'" command: "yum -q makecache -y --disablerepo='*' --enablerepo='kubernetes'"
when: kubernetes_rpm_key is changed when: kubernetes_rpm_key is changed
args:
warn: false

View File

@ -1,20 +1,20 @@
--- ---
apiVersion: kubeadm.k8s.io/{{ kubernetes_config_kubeadm_apiversion }} apiVersion: kubeadm.k8s.io/v1beta2
kind: InitConfiguration kind: InitConfiguration
{{ kubernetes_config_init_configuration | to_nice_yaml }} {{ kubernetes_config_init_configuration | to_nice_yaml }}
--- ---
apiVersion: kubeadm.k8s.io/{{ kubernetes_config_kubeadm_apiversion }}
kind: ClusterConfiguration kind: ClusterConfiguration
apiVersion: kubeadm.k8s.io/v1beta2
{{ kubernetes_config_cluster_configuration | to_nice_yaml }} {{ kubernetes_config_cluster_configuration | to_nice_yaml }}
{% if kubernetes_config_kubelet_configuration|length > 0 %} {% if kubernetes_config_kubelet_configuration|length > 0 %}
--- ---
apiVersion: kubelet.config.k8s.io/{{ kubenetes_config_kubelet_apiversion }} apiVersion: kubelet.config.k8s.io/v1beta1
kind: KubeletConfiguration kind: KubeletConfiguration
{{ kubernetes_config_kubelet_configuration | to_nice_yaml }} {{ kubernetes_config_kubelet_configuration | to_nice_yaml }}
{% endif %} {% endif %}
{% if kubernetes_config_kube_proxy_configuration|length > 0 %} {% if kubernetes_config_kube_proxy_configuration|length > 0 %}
--- ---
apiVersion: kubeproxy.config.k8s.io/{{ kubernetes_config_kubeproxy_apiversion }} apiVersion: kubeproxy.config.k8s.io/v1alpha1
kind: KubeProxyConfiguration kind: KubeProxyConfiguration
{{ kubernetes_config_kube_proxy_configuration | to_nice_yaml }} {{ kubernetes_config_kube_proxy_configuration | to_nice_yaml }}
{% endif %} {% endif %}

View File

@ -1,3 +1,12 @@
--- ---
procps_package: procps-ng procps_package: procps-ng
kubelet_environment_file_path: /etc/sysconfig/kubelet kubelet_environment_file_path: /etc/sysconfig/kubelet
kubernetes_packages:
- name: kubelet-{{ kubernetes_version_rhel_package }}-0
state: present
- name: kubectl-{{ kubernetes_version_rhel_package }}-0
state: present
- name: kubeadm-{{ kubernetes_version_rhel_package }}-0
state: present
- name: kubernetes-cni
state: present