1 Integração de host remoto com Elemental #

O seguinte descreve os requisitos mínimos de sistema e ambiente para realizar este guia de início rápido:

Note

Os dados existentes encontrados nas máquinas de destino serão sobrescritos como parte do processo; certifique-se de fazer backup de quaisquer dados em quaisquer dispositivos de armazenamento USB e discos conectados aos nós de implantação de destino.

Este guia foi criado usando um droplet da Digital Ocean para hospedar o cluster upstream e um Intel NUC como dispositivo downstream. Para criar a mídia de instalação, o SUSE Linux Enterprise Server é usado.

Comece criando um cluster capaz de hospedar o Rancher e o Elemental. Este cluster precisa ser roteável a partir da rede à qual os nós downstream estão conectados.

1.3.2 Configurar DNS #

 

Antes de continuar, você precisa configurar o acesso ao seu cluster. Assim como na configuração do próprio cluster, a forma como você configura o DNS será diferente dependendo de onde ele está sendo hospedado.

Tip

Se você não quiser lidar com a configuração de registros DNS (por exemplo, este é apenas um servidor de teste efêmero), você pode usar um serviço como sslip.io em vez disso. Com este serviço, você pode resolver qualquer endereço IP com <address>.sslip.io.

Para instalar o Rancher, você precisa obter acesso à API do Kubernetes do cluster que acabou de criar. Isso parece diferente dependendo de qual distribuição do Kubernetes está sendo usada.

Para o RKE2, o arquivo kubeconfig terá sido gravado em /etc/rancher/rke2/rke2.yaml. Salve este arquivo como ~/.kube/config em seu sistema local. Talvez você precise editar o arquivo para incluir o endereço IP ou nome de host roteável externamente correto.

Instale o Rancher facilmente com os comandos da Documentação do Rancher:

Instale o cert-manager:

helm repo add jetstack https://charts.jetstack.io
helm repo update
helm install cert-manager jetstack/cert-manager \
 --namespace cert-manager \
 --create-namespace \
 --set crds.enabled=true

Em seguida, instale o próprio Rancher:

helm repo add rancher-prime https://charts.rancher.com/server-charts/prime
helm repo update
helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --create-namespace \
  --set hostname=<DNS or sslip from above> \
  --set replicas=1 \
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN> \
  --version 2.14.2

Note

Se este sistema for destinado à produção, use o cert-manager para configurar um certificado real (como um da Let’s Encrypt).

Navegue até o nome de host que você configurou e faça login no Rancher com o bootstrapPassword que você usou. Você será guiado por um breve processo de configuração.

Com o Rancher instalado, você agora pode instalar o operador Elemental e os CRDs necessários. O gráfico Helm para o Elemental é publicado como um artefato OCI, portanto a instalação é um pouco mais simples do que a de outros gráficos. Ele pode ser instalado a partir do mesmo shell que você usou para instalar o Rancher ou no navegador, dentro do shell do Rancher.

helm install --create-namespace -n cattle-elemental-system \
 elemental-operator-crds \
 oci://registry.suse.com/rancher/elemental-operator-crds-chart \
 --version 1.9.0

helm install -n cattle-elemental-system \
 elemental-operator \
 oci://registry.suse.com/rancher/elemental-operator-chart \
 --version 1.9.0

Para simplificar, recomendamos definir a variável $ELEM para o caminho completo de onde você deseja o diretório de configuração:

export ELEM=$HOME/elemental
mkdir -p $ELEM

Para permitir que as máquinas se registrem no Elemental, precisamos criar um objeto MachineRegistration no namespace fleet-default.

Vamos criar uma versão básica deste objeto:

cat << EOF > $ELEM/registration.yaml
apiVersion: elemental.cattle.io/v1beta1
kind: MachineRegistration
metadata:
  name: ele-quickstart-nodes
  namespace: fleet-default
spec:
  machineName: "\${System Information/Manufacturer}-\${System Information/UUID}"
  machineInventoryLabels:
    manufacturer: "\${System Information/Manufacturer}"
    productName: "\${System Information/Product Name}"
EOF

kubectl apply -f $ELEM/registration.yaml

Note

O comando cat escapa cada $ com uma barra invertida (\) para que o Bash não os processe como modelos. Remova as barras invertidas se estiver copiando manualmente.

Assim que o objeto for criado, encontre e anote o endpoint que foi atribuído:

REGISURL=$(kubectl get machineregistration ele-quickstart-nodes -n fleet-default -o jsonpath='{.status.registrationURL}')

Alternativamente, isso também pode ser feito pela GUI.

Embora a versão atual do Elemental tenha uma maneira de criar sua própria mídia de instalação, no SUSE Edge 3.6 fazemos isso com o Kiwi e o Edge Image Builder, para que o sistema resultante seja criado com o SUSE Linux Micro como o Sistema Operacional base.

Tip

Para obter mais detalhes sobre o Kiwi, siga o processo do Kiwi Image Builder (Chapter 26, Criando imagens atualizadas do SUSE Linux Micro com o Kiwi) para criar novas imagens primeiro e, para o Edge Image Builder, confira o Guia de Introdução ao Edge Image Builder (Chapter 2, Clusters autônomos com o Edge Image Builder) e também a Documentação de Componentes (Chapter 8, Edge Image Builder).

A partir de um sistema Linux com Podman instalado, crie os diretórios e coloque a imagem base sendo criada pelo Kiwi:

mkdir -p $ELEM/eib_quickstart/base-images
cp /path/to/{micro-base-image-iso} $ELEM/eib_quickstart/base-images/
mkdir -p $ELEM/eib_quickstart/elemental

curl $REGISURL -o $ELEM/eib_quickstart/elemental/elemental_config.yaml

cat << EOF > $ELEM/eib_quickstart/eib-config.yaml
apiVersion: 1.3
image:
    imageType: iso
    arch: x86_64
    baseImage: SL-Micro.x86_64-6.2-Base-SelfInstall-GM.install.iso
    outputImageName: elemental-image.iso
operatingSystem:
  time:
    timezone: Europe/London
    ntp:
      forceWait: true
      pools:
        - 2.suse.pool.ntp.org
      servers:
        - 10.0.0.1
        - 10.0.0.2
  isoConfiguration:
    installDevice: /dev/vda
  users:
    - username: root
      encryptedPassword: \$6\$jHugJNNd3HElGsUZ\$eodjVe4te5ps44SVcWshdfWizrP.xAyd71CVEXazBJ/.v799/WRCBXxfYmunlBO2yp1hm/zb4r8EmnrrNCF.P/
  packages:
    sccRegistrationCode: XXX
EOF

Note

• A seção time é opcional, mas é altamente recomendável que seja configurada para evitar possíveis problemas com certificados e defasagem de relógio. Os valores fornecidos neste exemplo são apenas para fins ilustrativos. Por favor, ajuste-os para atender aos seus requisitos específicos.

• A senha não codificada é eib.

• O sccRegistrationCode é necessário para baixar e instalar os RPMs necessários das fontes oficiais (alternativamente, os RPMs elemental-register e elemental-system-agent podem ser carregados manualmente)

• O comando cat escapa cada $ com uma barra invertida (\) para que o Bash não os processe como modelos. Remova as barras invertidas se estiver copiando manualmente.

• O dispositivo de instalação será apagado durante a instalação.

podman run --privileged --rm -it -v $ELEM/eib_quickstart/:/eib \
 registry.suse.com/edge/3.6/edge-image-builder:1.3.3.1 \
 build --definition-file eib-config.yaml

Se você estiver inicializando um dispositivo físico, precisamos gravar a imagem em uma unidade flash USB. Isso pode ser feito com:

sudo dd if=/eib_quickstart/elemental-image.iso of=/dev/<PATH_TO_DISK_DEVICE> status=progress

Agora que criamos o meio de instalação, podemos inicializar nossos nós downstream com ele.

Para cada um dos sistemas que você deseja controlar com o Elemental, adicione o meio de instalação e inicialize o dispositivo. Após a instalação, ele será reiniciado e se registrará automaticamente.

Se você estiver usando a extensão da UI, deverá ver seu nó aparecer no "Inventário de Máquinas".

Note

Não remova o meio de instalação até ver o prompt de login; durante a primeira inicialização, os arquivos ainda são acessados na unidade flash.

Existem dois objetos que precisamos criar ao provisionar um novo cluster usando o Elemental.

Após criar esses objetos, você deve ver um novo cluster Kubernetes iniciar usando o novo nó com o qual você acabou de instalar.

O SUSE Rancher Elemental suporta a capacidade de realizar uma "redefinição de nó", que pode ser acionada opcionalmente quando um cluster inteiro é excluído do Rancher, um único nó é excluído de um cluster ou um nó é excluído manualmente do inventário de máquinas. Isso é útil quando você deseja redefinir e limpar quaisquer recursos órfãos e deseja trazer automaticamente o nó limpo de volta para o inventário de máquinas para que ele possa ser reutilizado. Isso não está habilitado por padrão e, portanto, qualquer sistema que for removido não será limpo (ou seja, os dados não serão removidos e quaisquer recursos de cluster do Kubernetes continuarão a operar nos clusters downstream) e exigirá intervenção manual para apagar os dados e registrar novamente a máquina no Rancher via Elemental.

Se você deseja que esta funcionalidade seja habilitada por padrão, você precisa garantir que seu MachineRegistration habilite isso explicitamente adicionando config.elemental.reset.enabled: true, por exemplo:

config:
  elemental:
    registration:
      auth: tpm
    reset:
      enabled: true

Então, todos os sistemas registrados com este MachineRegistration receberão automaticamente a anotação elemental.cattle.io/resettable: 'true' em sua configuração. Se você deseja fazer isso manualmente em nós individuais, por exemplo, porque você tem um MachineInventory existente que não possui esta anotação, ou você já implantou nós, você pode modificar o MachineInventory e adicionar a configuração resettable, por exemplo:

apiVersion: elemental.cattle.io/v1beta1
kind: MachineInventory
metadata:
  annotations:
    elemental.cattle.io/os.unmanaged: 'true'
    elemental.cattle.io/resettable: 'true'

No SUSE Edge 3.1, o Operador Elemental coloca um marcador no sistema operacional que acionará o processo de limpeza automaticamente; ele interromperá todos os serviços do Kubernetes, removerá todos os dados persistentes, desinstalará todos os serviços do Kubernetes, limpará quaisquer diretórios restantes do Kubernetes/Rancher e forçará um novo registro no Rancher via configuração original do MachineRegistration Elemental. Isso acontece automaticamente, não há necessidade de qualquer intervenção manual. O script que é chamado pode ser encontrado em /opt/edge/elemental_node_cleanup.sh e é acionado via systemd.path após a colocação do marcador, portanto sua execução é imediata.

Warning

O uso da funcionalidade resettable pressupõe que o comportamento desejado ao remover um nó/cluster do Rancher é limpar os dados e forçar um novo registro. A perda de dados é garantida nesta situação, portanto, use isso apenas se você tiver certeza de que deseja que a redefinição automática seja realizada.

Aqui estão alguns recursos recomendados para pesquisar após usar este guia: