Como Instalar o Minikube no Ubuntu 24.04|22.04|20.04

Você está pronto para descobrir o poder do Kubernetes? Neste tutorial passo a passo, mostramos como instalar o Minikube em um sistema Linux Ubuntu, com o hipervisor base sendo Libvirt (KVM) ou VirtualBox. Começaremos com uma introdução básica ao Minikube e, em seguida, entraremos na instalação real do Minikube e como começar a usá-lo.

Minikube é uma ferramenta de código aberto desenvolvida para permitir que desenvolvedores e administradores de sistemas executem um único cluster do Kubernetes em sua máquina local. O Minikube inicia um cluster Kubernetes de nó único localmente com baixo uso de recursos. Isso é ideal para testes de desenvolvimento e propósitos de POC.

O Guia Definitivo do Desktop Ubuntu

Domine o Ubuntu como um profissional - desde a personalização bela da área de trabalho até a automação poderosa do terminal. Perfeito para desenvolvedores, administradores de sistemas e usuários avançados que querem controle total sobre seu ambiente de trabalho.

Para CentOS, confira: Instalando o Minikube no CentOS 7/8 com KVM.

Em resumo, o Minikube empacota e configura uma VM Linux, e então instala o Docker e todos os componentes do Kubernetes nela.

O Minikube suporta recursos do Kubernetes, como:

DNS
NodePorts
ConfigMaps e Secrets
Painéis
Tempo de Execução de Contêiner: Docker, CRI-O e containerd
Habilitando CNI (Interface de Rede de Contêiner)
Ingressar
Volumes Persistentes do tipo hostPath

Vamos começar a instalar o Minikube no Ubuntu Linux.

Instalar o Hypervisor KVM ou VirtualBox

Execute os seguintes comandos para atualizar todos os pacotes do sistema para a versão mais recente:

sudo apt update && sudo apt upgrade -y

Se for necessário reiniciar após a atualização, então realize o processo.

[ -f /var/run/reboot-required ] && sudo reboot -f

Para usuários do VirtualBox, instale o VirtualBox usando:

Instalar o VirtualBox no Ubuntu

Usuários do Hypervisor KVM

Para aqueles interessados em usar o hipervisor KVM, confira nosso guia sobre como instalar o KVM no CentOS/Ubuntu/Debian

Então siga Como executar o Minikube no KVM em vez disso.

Baixar e Configurar o Minikube no Ubuntu

Você precisa baixar o binário do minikube. Vou colocar o binário no diretório /usr/local/bin, já que ele está dentro do ` PATH.

wget https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
chmod +x minikube-linux-amd64
sudo mv minikube-linux-amd64 /usr/local/bin/minikube

Confirmar versão instalada

$ minikube version
minikube version: v1.33.1
commit: 5883c09216182566a63dff4c326a6fc9ed2982ff

Precisamos do kubectl, que é uma ferramenta de linha de comando usada para implantar e gerenciar aplicações no Kubernetes:

curl -LO https://storage.googleapis.com/kubernetes-release/release/`curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt`/bin/linux/amd64/kubectl

Torne o binário kubectl executável.

chmod +x ./kubectl

Mova o binário para o seu PATH:

sudo mv ./kubectl /usr/local/bin/kubectl

Verificar versão:

$ kubectl version -o json  --client
{
  "clientVersion": {
    "major": "1",
    "minor": "30",
    "gitVersion": "v1.30.2",
    "gitCommit": "39683505b630ff2121012f3c5b16215a1449d5ed",
    "gitTreeState": "clean",
    "buildDate": "2024-06-11T20:29:44Z",
    "goVersion": "go1.22.4",
    "compiler": "gc",
    "platform": "linux/amd64"
  },
  "kustomizeVersion": "v5.0.4-0.20230601165947-6ce0bf390ce3"
}

Iniciando o minikube no Ubuntu

Agora que os componentes estão instalados, você pode iniciar o minikube. A imagem da VM será baixada e configurada para um cluster Kubernetes de nó único.

Minikube com driver KVM

minikube start --driver=kvm2

Com o driver do VirtualBox

minikube start --driver=virtualbox

Exemplo de saída dos comandos de execução.

...................................
* Using the kvm2 driver based on user configuration
*   https://minikube.sigs.k8s.io/docs/reference/drivers/none/
* Downloading driver docker-machine-driver-kvm2:
    > docker-machine-driver-kvm2-...:  65 B / 65 B [---------] 100.00% ? p/s 0s
    > docker-machine-driver-kvm2-...:  13.46 MiB / 13.46 MiB  100.00% ? p/s 100
* Downloading VM boot image ...
    > minikube-v1.33.1-amd64.iso....:  65 B / 65 B [---------] 100.00% ? p/s 0s
    > minikube-v1.33.1-amd64.iso:  314.16 MiB / 314.16 MiB  100.00% 37.68 MiB p
* Starting "minikube" primary control-plane node in "minikube" cluster
* Downloading Kubernetes v1.30.0 preload ...
    > preloaded-images-k8s-v18-v1...:  342.90 MiB / 342.90 MiB  100.00% 38.75 M
* Creating kvm2 VM (CPUs=2, Memory=2200MB, Disk=20000MB) ...
* Preparing Kubernetes v1.30.0 on Docker 26.0.2 ...
  - Generating certificates and keys ...
  - Booting up control plane ...
  - Configuring RBAC rules ...
* Configuring bridge CNI (Container Networking Interface) ...
* Verifying Kubernetes components...
  - Using image gcr.io/k8s-minikube/storage-provisioner:v5
* Enabled addons: default-storageclass, storage-provisioner
* Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

Aguarde o download e a instalação terminarem e, em seguida, confirme se tudo está funcionando corretamente.

Para definir o driver padrão do Minikube, use:

# VirtualBox
minikube config set driver virtualbox

# KVM
minikube config set driver kvm

Operações básicas do Minikube

Para verificar o status do cluster, execute:

$ kubectl cluster-info

Kubernetes master is running at https://192.168.39.117:8443
KubeDNS is running at https://192.168.39.117:8443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

Observe que o arquivo de configuração do Minikube está localizado em ~/.minikube/machines/minikube/config.json

Para visualizar a configuração, use:

$ kubectl config view
apiVersion: v1
clusters:
- cluster:
    certificate-authority: /root/.minikube/ca.crt
    extensions:
    - extension:
        last-update: Sat, 13 Jul 2024 15:29:47 UTC
        provider: minikube.sigs.k8s.io
        version: v1.33.1
      name: cluster_info
    server: https://192.168.39.249:8443
  name: minikube
contexts:
- context:
    cluster: minikube
    extensions:
    - extension:
        last-update: Sat, 13 Jul 2024 15:29:47 UTC
        provider: minikube.sigs.k8s.io
        version: v1.33.1
      name: context_info
    namespace: default
    user: minikube
  name: minikube
current-context: minikube
kind: Config
preferences: {}
users:
- name: minikube
  user:
    client-certificate: /root/.minikube/profiles/minikube/client.crt
    client-key: /root/.minikube/profiles/minikube/client.key

Para verificar os nós em execução:

$ kubectl get nodes
NAME       STATUS   ROLES           AGE     VERSION
minikube   Ready    control-plane   5m29s   v1.30.0

Acesse a VM do minikube usando ssh:

$ minikube ssh

                         _             _            
            _         _ ( )           ( )           
  ___ ___  (_)  ___  (_)| |/')  _   _ | |_      __  
/' _ ` _ `\| |/' _ `\| || , <  ( ) ( )| '_`\  /'__`\
| ( ) ( ) || || ( ) || || |\`\ | (_) || |_) )(  ___/
(_) (_) (_)(_)(_) (_)(_)(_) (_)`\___/'(_,__/'`\____)

$ sudo su -

Para parar um cluster Kubernetes local em execução, execute:

$ minikube stop

Para excluir um cluster Kubernetes local, use:

$ minikube delete

O Kubernetes vem com um painel web que

$ minikube addons list
...
|-----------------------------|----------|--------------|--------------------------------|
|         ADDON NAME          | PROFILE  |    STATUS    |           MAINTAINER           |
|-----------------------------|----------|--------------|--------------------------------|
| ambassador                  | minikube | disabled     | 3rd party (Ambassador)         |
| auto-pause                  | minikube | disabled     | minikube                       |
| cloud-spanner               | minikube | disabled     | Google                         |
| csi-hostpath-driver         | minikube | disabled     | Kubernetes                     |
| dashboard                   | minikube | disabled     | Kubernetes                     |
| default-storageclass        | minikube | enabled ✅   | Kubernetes                     |
| efk                         | minikube | disabled     | 3rd party (Elastic)            |
| freshpod                    | minikube | disabled     | Google                         |
| gcp-auth                    | minikube | disabled     | Google                         |
| gvisor                      | minikube | disabled     | minikube                       |
| headlamp                    | minikube | disabled     | 3rd party (kinvolk.io)         |
| helm-tiller                 | minikube | disabled     | 3rd party (Helm)               |
| inaccel                     | minikube | disabled     | 3rd party (InAccel             |
|                             |          |              | [[email ])            |
| ingress                     | minikube | disabled     | Kubernetes                     |
| ingress-dns                 | minikube | disabled     | minikube                       |
| inspektor-gadget            | minikube | disabled     | 3rd party                      |
|                             |          |              | (inspektor-gadget.io)          |
| istio                       | minikube | disabled     | 3rd party (Istio)              |
| istio-provisioner           | minikube | disabled     | 3rd party (Istio)              |
| kong                        | minikube | disabled     | 3rd party (Kong HQ)            |
| kubeflow                    | minikube | disabled     | 3rd party                      |
| kubevirt                    | minikube | disabled     | 3rd party (KubeVirt)           |
| logviewer                   | minikube | disabled     | 3rd party (unknown)            |
| metallb                     | minikube | disabled     | 3rd party (MetalLB)            |
| metrics-server              | minikube | disabled     | Kubernetes                     |
| nvidia-device-plugin        | minikube | disabled     | 3rd party (NVIDIA)             |
| nvidia-driver-installer     | minikube | disabled     | 3rd party (Nvidia)             |
| nvidia-gpu-device-plugin    | minikube | disabled     | 3rd party (Nvidia)             |
| olm                         | minikube | disabled     | 3rd party (Operator Framework) |
| pod-security-policy         | minikube | disabled     | 3rd party (unknown)            |
| portainer                   | minikube | disabled     | 3rd party (Portainer.io)       |
| registry                    | minikube | disabled     | minikube                       |
| registry-aliases            | minikube | disabled     | 3rd party (unknown)            |
| registry-creds              | minikube | disabled     | 3rd party (UPMC Enterprises)   |
| storage-provisioner         | minikube | enabled ✅   | minikube                       |
| storage-provisioner-gluster | minikube | disabled     | 3rd party (Gluster)            |
| storage-provisioner-rancher | minikube | disabled     | 3rd party (Rancher)            |
| volumesnapshots             | minikube | disabled     | Kubernetes                     |
| yakd                        | minikube | disabled     | 3rd party (marcnuri.com)       |
|-----------------------------|----------|--------------|--------------------------------|

Para habilitar um módulo, use o comando:

minikube addons enable <module>

Exemplo :

$ minikube addons enable portainer
! portainer is a 3rd party addon and is not maintained or verified by minikube maintainers, enable at your own risk.
! portainer does not currently have an associated maintainer.
  - Using image docker.io/portainer/portainer-ce:2.15.1
* The 'portainer' addon is enabled

Para abrir diretamente no seu navegador padrão, use:

$ minikube dashboard

Para obter a URL do painel

$ minikube dashboard --url
http://192.168.39.117:30000

Acesse o Painel do Kubernetes abrindo a URL no seu navegador favorito. Para mais informações, consulte:

Série Hello Minikube: https://kubernetes.io/docs/tutorials/stateless-application/hello-minikube/
Guias do Minikube para iniciantes disponíveis em: https://kubernetes.io/docs/getting-started-guides/minikube/

Mais guias sobre Kubernetes:

Agendar Pods nos nós do plano de controle (Master) do Kubernetes
Adicionando um novo Nó de Trabalho do Kubernetes a um Cluster existente
Implantando um Cluster Kubernetes no CentOS com Ansible e Calico CNI
Implantar o Metrics Server no Cluster Kubernetes
Baixar manualmente as imagens de contêiner usadas pelo Kubernetes kubeadm
Instalar e Usar o Helm 3 em um Cluster Kubernetes