Difference between revisions of "Installing Kubernetes with Ansible on AWS"
(Created page with "This article explains how to install Kubernetes using Ansible on AWS's Ubuntu 20.04 computing clusters. =Set up at least two machines on AWS= The first task is to create two E...") |
|||
(39 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
This article explains how to install Kubernetes using Ansible on AWS's Ubuntu 20.04 computing clusters. | This article explains how to install Kubernetes using Ansible on AWS's Ubuntu 20.04 computing clusters. | ||
A relevant article can be found here: [https://levelup.gitconnected.com/how-to-create-multi-node-kubernetes-cluster-using-ansible-roles-automation-inside-ec2-instance-c539a1b1f9a1 Create Multi-Node Kubernetes using Ansible inside AWS EC2 Instance]. | |||
For installing Kuberenetes onto [[Vagrant]] configurations, please refer to this page: [https://kubernetes.io/blog/2019/03/15/kubernetes-setup-using-ansible-and-vagrant/ Kubernetes setup using Ansible and Vagrant]. | |||
__TOC__ | |||
=Set up at least two machines on AWS= | =Set up at least two machines on AWS= | ||
The first task is to create two EC2 instances that matches [[Kubernetes Cluster minimal configuration]]: | The first task is to create two EC2 instances that matches [[Kubernetes Cluster minimal configuration]]: | ||
{{:Kubernetes Cluster minimal configuration}} | {{:Kubernetes Cluster minimal configuration}} | ||
== Set the right Security Groups == | |||
{{#lst:Input/K8s Installation/Security Groups|Security Groups}} | |||
Ideally, one could first create a Security Group, and name it <code>K8s Sec Grp</code>, then, just create two or more instances of EC2, and select the said security group during the creation cycle. | |||
== Use the same Signature File == | |||
When creating these instances, make sure that you create or select the same Identity file (<code>.pem</code> file) for all instances of the same cluster. This will significantly reduce the complexity of installation. | |||
==Make sure Ansible is installed== | |||
Install [[Ansible]] on the machine that will run [[Ansible]] to install the cluster. You may follow this procedure: [https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-and-upgrading-ansible-with-pip Installing Ansible]. If you already installed <code>Python 3.0</code> and <code>pip3</code>, launch the following instruction in your terminal should work: | |||
pip3 install ansible | |||
==Set up Ansible Inventory file== | |||
It is necessary to set up the <code>inventory</code> files for [[Ansible]]. | |||
See the following examples: | |||
For <code>inventory</code> file, one should provide a list of machines, and a list of variables (<code>vars</code>) that applies to <code>all</code> these machines. In our case, we want to access all these machines using the same <code>ansible_user</code>: <code>ubuntu</code>. | |||
<syntaxhighlight lang="CSS"> | |||
m1.xlp.pub | |||
w1.xlp.pub | |||
[all:vars] | |||
ansible_user=ubuntu | |||
</syntaxhighlight> | |||
==Set up Ansible Configuration file== | |||
One must also create the <code>ansible.cfg</code> files in the current working directory. | |||
See the following examples: | |||
<syntaxhighlight lang="CSS"> | |||
[defaults] | |||
inventory = inventory | |||
private_key_file = ~/.ssh/ansible.pem | |||
</syntaxhighlight> | |||
==Test to see if Ansible can access the machines== | |||
In the following instruction, <code>all</code> indicates running the instruction set on all machines, where <code>-m ping</code>, indicates that this instruction will run the module, <code>ping</code> on all the machines. | |||
ansible all -m ping | |||
For a more elaborate instruction, see [[Ansible/First Instruction]]. | |||
Other useful instructions to test if [[Ansible]] is running properly: [[Ansible/Useful Instructions]]. | |||
==Make changes to machines using Ansible== | |||
If you have certain password that you can key-in during an interactive session, you may use the following instruction. Note that if the user already is in the administrator group, you can ignore the <code>--ask-become-pass</code> part of the statement. By supplying the <code>--ask-become-pass</code> option, you will be asked to enter a password. | |||
ansible all -m apt -a update_cache=true --become --ask-become-pass |
Latest revision as of 16:56, 3 August 2021
This article explains how to install Kubernetes using Ansible on AWS's Ubuntu 20.04 computing clusters.
A relevant article can be found here: Create Multi-Node Kubernetes using Ansible inside AWS EC2 Instance.
For installing Kuberenetes onto Vagrant configurations, please refer to this page: Kubernetes setup using Ansible and Vagrant.
Set up at least two machines on AWS
The first task is to create two EC2 instances that matches Kubernetes Cluster minimal configuration:
The master node must have at least 2 CPU cores, 2 Gb of memory. The worker node (slave) should have at least 1 CPU core and 2 Gb of memory.
Set the right Security Groups
{{#lst:Input/K8s Installation/Security Groups|Security Groups}}
Ideally, one could first create a Security Group, and name it K8s Sec Grp
, then, just create two or more instances of EC2, and select the said security group during the creation cycle.
Use the same Signature File
When creating these instances, make sure that you create or select the same Identity file (.pem
file) for all instances of the same cluster. This will significantly reduce the complexity of installation.
Make sure Ansible is installed
Install Ansible on the machine that will run Ansible to install the cluster. You may follow this procedure: Installing Ansible. If you already installed Python 3.0
and pip3
, launch the following instruction in your terminal should work:
pip3 install ansible
Set up Ansible Inventory file
It is necessary to set up the inventory
files for Ansible.
See the following examples:
For inventory
file, one should provide a list of machines, and a list of variables (vars
) that applies to all
these machines. In our case, we want to access all these machines using the same ansible_user
: ubuntu
.
m1.xlp.pub
w1.xlp.pub
[all:vars]
ansible_user=ubuntu
Set up Ansible Configuration file
One must also create the ansible.cfg
files in the current working directory.
See the following examples:
[defaults]
inventory = inventory
private_key_file = ~/.ssh/ansible.pem
Test to see if Ansible can access the machines
In the following instruction, all
indicates running the instruction set on all machines, where -m ping
, indicates that this instruction will run the module, ping
on all the machines.
ansible all -m ping
For a more elaborate instruction, see Ansible/First Instruction. Other useful instructions to test if Ansible is running properly: Ansible/Useful Instructions.
Make changes to machines using Ansible
If you have certain password that you can key-in during an interactive session, you may use the following instruction. Note that if the user already is in the administrator group, you can ignore the --ask-become-pass
part of the statement. By supplying the --ask-become-pass
option, you will be asked to enter a password.
ansible all -m apt -a update_cache=true --become --ask-become-pass