Unverified Commit 11e99b0b authored by Phillip Thurston's avatar Phillip Thurston Committed by GitHub
Browse files

Add ability to move kubeconfig to control node on demand (#467) 



Signed-off-by: default avatarPhillip Thurston <phil@goinvictus.com>
parent c23ef774

README.md

+15 −2
Original line number Diff line number Diff line
@@ -167,7 +167,7 @@ It is assumed that the control node has access to the internet. The playbook wil 


## Kubeconfig



After successful bringup, the kubeconfig of the cluster is copied to the control node  and merged with `~/.kube/config` under the `k3s-ansible` context.

After successful bringup, the kubeconfig of the cluster is copied to the control node  and merged with `~/.kube/config` under the `k3s-ansible` context unless overwritten by the `cluster_context` variable.

Assuming you have [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) installed, you can confirm access to your **Kubernetes** cluster with the following:



```bash
@@ -177,6 +177,19 @@ kubectl get nodes 


If you wish for your kubeconfig to be copied elsewhere and not merged, you can set the `kubeconfig` variable in `inventory.yml` to the desired path.



If you wish to get a new copy of the kubeconfig after installation you can run the site playbook again using the `kubeconfig` tag.



*Installed with ansible-galaxy*



```bash

ansible-playbook k3s.orchestration.site -i inventory.yml --tags kubeconfig

```



*Running the playbook from inside the repository*



```bash

ansible-playbook playbooks/site.yml -i inventory.yml --tags kubeconfig

```

## Local Testing



A Vagrantfile is provided that provision a 5 nodes cluster using Vagrant (LibVirt or Virtualbox as provider). To use it:
@@ -185,7 +198,7 @@ A Vagrantfile is provided that provision a 5 nodes cluster using Vagrant (LibVir 
vagrant up

```



By default, each node is given 2 cores and 2GB of RAM and runs Ubuntu 20.04. You can customize these settings by editing the `Vagrantfile`.

By default, each node is given 2 cores and 2GB of RAM and runs Ubuntu 24.04. You can customize these settings by editing the `Vagrantfile`.



## Need More Features?

roles/k3s_server/tasks/main.yml

+3 −2
Original line number Diff line number Diff line
@@ -171,6 +171,7 @@ 
      # noqa var-naming[no-role-prefix]

      ansible.builtin.command: 'kubectl'

      register: kubectl_installed

      tags: kubeconfig

      ignore_errors: true

      delegate_to: 127.0.0.1

      become: false
@@ -185,11 +186,11 @@ 
        mode: "0600"

        remote_src: true

      register: k3s_server_copy_yaml

      tags: kubeconfig



    - name: Apply K3S kubeconfig to control node

      when:

        - kubectl_installed.rc == 0

        - k3s_server_copy_yaml.changed

        - kubectl_installed.rc == 0 and (k3s_server_copy_yaml.changed or 'kubeconfig' in ansible_run_tags)

      block:

        - name: Copy kubeconfig to control node

          ansible.builtin.fetch: