Blocos condicionais com if e else

Às vezes, um recurso só deve aparecer se o usuário o tiver solicitado. O Helm permite envolver esse YAML em um condicional para renderizá-lo sob demanda.

Um bloco if começa com {{ if SOMETHING }} e termina com {{ end }}. Tudo entre eles é renderizado apenas quando a condição é verdadeira.

A condição geralmente é um valor definido pelo usuário. Altere ingress.enabled para true em values.yaml e o manifesto envolvido aparecerá de repente.

Todo if deve ser acompanhado de um {{ end }}. Se você esquecê-lo, o Helm emitirá um erro de bloco não terminado ao tentar renderizar o gráfico.

Quer um fallback? Adicione um ramo {{ else }}. O Helm renderiza o primeiro bloco quando a condição é verdadeira; caso contrário, renderiza o bloco else.

Para vários casos, encadeie condições com {{ else if }}. O Helm verifica cada uma em ordem e renderiza o primeiro ramo cuja condição seja verdadeira.

Um if é verdadeiro a menos que o valor esteja vazio: false, zero, uma string vazia ou uma lista vazia são considerados falsos em uma condição.

Um padrão comum envolve um único campo opcional, não um recurso inteiro. Aqui, a anotação só é renderizada quando o usuário fornece um valor para ela.

Um bloco if deixa linhas em branco onde a ação ficava. Esse espaço em branco pode quebrar o YAML, por isso você aprenderá em breve a removê-lo. 🧹

Renderize com valores diferentes e observe qual ramo vence. helm template com --set permite confirmar cada condição antes mesmo de fazer uma implantação.

Se um usuário nunca definir a sinalização, ela será lida como vazia e seu if permanecerá falso. É por isso que os gráficos fornecem um padrão adequado para ela em values.yaml.

Você escreve {{ if .Values.cache }}, mas o gráfico falha ao renderizar.

Agora você pode controlar o YAML com if, adicionar ramos else e else if e se lembrar do {{ end }} de fechamento. A renderização condicional foi liberada! 🎯