Skip to content
Snippets Groups Projects
  • Max Gautier's avatar
    e90cae93
    Refactor check_galaxy + fix version (#10729) · e90cae93
    Max Gautier authored
    * Remove checks for docs using exact tags
    
    Instead use a more generic documentation for installing kubespray as a
    collection from git.
    
    * Check that we upgraded galaxy.yml to next version
    
    This is only intented to check for human error. The version in galaxy
    should be the next (which does not mean the same if we're on master or a
    release branch).
    
    * Set collection version to KUBESPRAY_NEXT_VERSION
    Refactor check_galaxy + fix version (#10729)
    Max Gautier authored
    * Remove checks for docs using exact tags
    
    Instead use a more generic documentation for installing kubespray as a
    collection from git.
    
    * Check that we upgraded galaxy.yml to next version
    
    This is only intented to check for human error. The version in galaxy
    should be the next (which does not mean the same if we're on master or a
    release branch).
    
    * Set collection version to KUBESPRAY_NEXT_VERSION
ansible_collection.md 1.17 KiB

Ansible collection

Kubespray can be installed as an Ansible collection.

Requirements

  • An inventory file with the appropriate host groups. See the README.
  • A group_vars directory. These group variables need to match the appropriate variable names under inventory/local/group_vars. See the README.

Usage

  1. Add Kubespray to your requirements.yml file

    collections:
    - name: https://github.com/kubernetes-sigs/kubespray
      type: git
      version: master # use the appropriate tag or branch for the version you need
  2. Install your collection

    ansible-galaxy install -r requirements.yml
  3. Create a playbook to install your Kubernetes cluster

    - name: Install Kubernetes
      ansible.builtin.import_playbook: kubernetes_sigs.kubespray.cluster
  4. Update INVENTORY and PLAYBOOK so that they point to your inventory file and the playbook you created above, and then install Kubespray

    ansible-playbook -i INVENTORY --become --become-user=root PLAYBOOK