Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Variáveis de Ambiente

Como mencionado no Guia de Início Rápido, você pode usar o script de instalação disponível em https://get.k3s.io para instalar o K3s como um serviço em sistemas baseados em systemd e openrc.

A forma mais simples deste comando é a seguinte:

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s sh -

Ao usar este método para instalar o K3s, as seguintes variáveis de ambiente podem ser usadas para configurar a instalação:

Variável de ambiente Descrição

Variável de ambiente	Descrição
`INSTALL_K3S_SKIP_DOWNLOAD`	Se definido como verdadeiro, não fará o download do hash ou binário do K3s.
`INSTALL_K3S_SYMLINK`	Por padrão, criará links simbólicos para os binários kubectl, crictl e ctr se os comandos já não existirem no caminho. Se definido como 'skip', não criará links simbólicos e 'force' irá sobrescrever.
`INSTALL_K3S_SKIP_ENABLE`	Se definido como verdadeiro, não habilitará ou iniciará o serviço K3s.
`INSTALL_K3S_SKIP_START`	Se definido como verdadeiro, não iniciará o serviço K3s.
`INSTALL_K3S_VERSION`	Versão do K3s a ser baixada do Github. Tentará baixar do canal estável se não for especificado.
`INSTALL_K3S_BIN_DIR`	Diretório para instalar o binário do K3s, links e script de desinstalação, ou use `/usr/local/bin` como padrão.
`INSTALL_K3S_BIN_DIR_READ_ONLY`	Se definido como verdadeiro, não escreverá arquivos em `INSTALL_K3S_BIN_DIR`, forçando a configuração de `INSTALL_K3S_SKIP_DOWNLOAD=true`.
`INSTALL_K3S_SYSTEMD_DIR`	Diretório para instalar o serviço systemd e arquivos de ambiente, ou use `/etc/systemd/system` como padrão.
`INSTALL_K3S_EXEC`	Comando com flags a serem usados para iniciar o K3s no serviço. Se o comando não for especificado, e o `K3S_URL` estiver definido, o padrão será "agent." Se `K3S_URL` não estiver definido, o padrão será "server." Para ajuda, consulte este exemplo.
`INSTALL_K3S_NAME`	Nome do serviço systemd a ser criado, o padrão será 'k3s' se estiver executando o k3s como um servidor e 'k3s-agent' se estiver executando o k3s como um agente. Se especificado, o nome será prefixado com 'k3s-'.
`INSTALL_K3S_TYPE`	Tipo de serviço systemd a ser criado, o padrão será definido a partir do comando exec do K3s, se não especificado.
`INSTALL_K3S_SELINUX_WARN`	Se definido como verdadeiro, continuará se a política k3s-selinux não for encontrada.
`INSTALL_K3S_SKIP_SELINUX_RPM`	Se definido como verdadeiro, pulará a instalação automática do RPM do k3s.
`INSTALL_K3S_CHANNEL_URL`	URL do canal para buscar a URL de download do K3s. Padrão: https://update.k3s.io/v1-release/channels.
`INSTALL_K3S_CHANNEL`	Canal a ser usado para buscar a URL de download do K3s. Padrão: "stable". As opções incluem: `stable`, `latest`, `testing`.

INSTALL_K3S_SKIP_DOWNLOAD

Se definido como verdadeiro, não fará o download do hash ou binário do K3s.

INSTALL_K3S_SYMLINK

Por padrão, criará links simbólicos para os binários kubectl, crictl e ctr se os comandos já não existirem no caminho. Se definido como 'skip', não criará links simbólicos e 'force' irá sobrescrever.

INSTALL_K3S_SKIP_ENABLE

Se definido como verdadeiro, não habilitará ou iniciará o serviço K3s.

INSTALL_K3S_SKIP_START

Se definido como verdadeiro, não iniciará o serviço K3s.

INSTALL_K3S_VERSION

Versão do K3s a ser baixada do Github. Tentará baixar do canal estável se não for especificado.

INSTALL_K3S_BIN_DIR

Diretório para instalar o binário do K3s, links e script de desinstalação, ou use /usr/local/bin como padrão.

INSTALL_K3S_BIN_DIR_READ_ONLY

Se definido como verdadeiro, não escreverá arquivos em INSTALL_K3S_BIN_DIR, forçando a configuração de INSTALL_K3S_SKIP_DOWNLOAD=true.

INSTALL_K3S_SYSTEMD_DIR

Diretório para instalar o serviço systemd e arquivos de ambiente, ou use /etc/systemd/system como padrão.

INSTALL_K3S_EXEC

Comando com flags a serem usados para iniciar o K3s no serviço. Se o comando não for especificado, e o K3S_URL estiver definido, o padrão será "agent." Se K3S_URL não estiver definido, o padrão será "server." Para ajuda, consulte este exemplo.

INSTALL_K3S_NAME

Nome do serviço systemd a ser criado, o padrão será 'k3s' se estiver executando o k3s como um servidor e 'k3s-agent' se estiver executando o k3s como um agente. Se especificado, o nome será prefixado com 'k3s-'.

INSTALL_K3S_TYPE

Tipo de serviço systemd a ser criado, o padrão será definido a partir do comando exec do K3s, se não especificado.

INSTALL_K3S_SELINUX_WARN

Se definido como verdadeiro, continuará se a política k3s-selinux não for encontrada.

INSTALL_K3S_SKIP_SELINUX_RPM

Se definido como verdadeiro, pulará a instalação automática do RPM do k3s.

INSTALL_K3S_CHANNEL_URL

URL do canal para buscar a URL de download do K3s. Padrão: https://update.k3s.io/v1-release/channels.

INSTALL_K3S_CHANNEL

Canal a ser usado para buscar a URL de download do K3s. Padrão: "stable". As opções incluem: stable, latest, testing.

Este exemplo mostra onde colocar as variáveis de ambiente mencionadas como opções (após o pipe):

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s INSTALL_K3S_CHANNEL=latest sh -

As variáveis de ambiente que começam com K3S_ serão preservadas para uso pelos serviços systemd e openrc.

Definir K3S_URL sem definir explicitamente um comando exec fará com que o comando padrão seja "agent".

Ao executar o agente, K3S_TOKEN também deve ser definido.

Versão Gate

Disponível a partir das versões de outubro de 2024: v1.28.15+k3s1, v1.29.10+k3s1, v1.30.6+k3s1, v1.31.2+k3s1.

O K3s agora usará PATH para encontrar tempos de execução do contêiner alternativos, além de verificar os caminhos padrão usados pelos pacotes de tempo de execução do contêiner. Para usar este recurso, você deve modificar a variável de ambiente PATH do serviço K3s para adicionar os diretórios que contêm os binários do tempo de execução do contêiner.

É recomendado que você modifique um destes dois arquivos de ambiente:

/etc/default/k3s # ou k3s-agent
/etc/sysconfig/k3s # ou k3s-agent

Este exemplo adicionará o PATH em /etc/default/k3s:

echo PATH=$PATH >> /etc/default/k3s

As alterações em PATH devem ser feitas com cuidado para evitar colocar binários não confiáveis no caminho dos serviços que são executados como root.