GitLab Managed Apps era um recurso de integração do Kubernetes da plataforma que fornecia a instalação com um clique de aplicativos de cluster comuns. Essa iteração do recurso foi descontinuada durante o ciclo de lançamento do GitLab 13 e removida inteiramente na versão 14.0 de junho. Veja como migrar seus aplicativos gerenciados para um modelo de implantação compatível.
Afastando-se dos aplicativos gerenciados
Os aplicativos gerenciados foram desenvolvidos como uma forma de simplificar a ativação e a execução de um novo cluster Kubernetes. O GitLab forneceu modelos para aplicativos como NGINX Ingress, Cert Manager e Prometheus.
Dois métodos de instalação diferentes foram oferecidos: um clique e CI / CD. O método de um clique fornecia uma IU dentro do GitLab que listava os aplicativos disponíveis e permitia que você clique para instalar. Alguns aplicativos também expuseram configurações básicas. O método CI / CD ofereceu um modelo GitLab CI para adicionar aplicativos a um cluster como parte de um pipeline.
As instalações com um clique acabaram de vez. O método CI permanece funcional, mas está obsoleto e será removido no GitLab 15.0. Embora os aplicativos gerenciados tenham simplificado drasticamente a instalação, eles só cuidou desse estágio do ciclo de vida do cluster. Os aplicativos foram instalados ou desinstalados, então você precisa mudar rapidamente para as ferramentas normais de gerenciamento do Kubernetes para realizar manutenção e personalização.
Apesar da remoção do recurso, as instalações de aplicativos gerenciados existentes continuarão a funcionar no GitLab 14.0. Você pode atualizar o GitLab com segurança, sem se preocupar com o tempo de inatividade em seu cluster. A atualização removerá a IU de aplicativos gerenciados, portanto, você não conseguirá visualizar ou desinstalar aplicativos de dentro do GitLab.
Obtendo controle de seus aplicativos
Migrar de aplicativos gerenciados não requer necessariamente qualquer ação imediata de sua parte. Como seus aplicativos permanecerão operacionais, você pode deixá-los como estão se estiver satisfeito com a permanência deles no gitlab-managed-apps namespace.
Como os aplicativos são simplesmente implantações do Helm em seu cluster, você pode gerenciá-los usando o kubectl e binários de linha de comando do Helm. Eles aparecerão como recursos regulares do Kubernetes.
Você pode listar os recursos do cluster que foram instalados pelo GitLab usando este comando Kubectl:
kubectl get all -n gitlab-managed-apps
Isso permite que você verifique o que está sendo executado em seu cluster na ausência da página “Aplicativos” antiga do GitLab.

Você pode encontrar problemas com aplicativos instalados por versões antigas do GitLab. Eles podem ter sido adicionados usando o Helm v2, que não é compatível com clientes Helm v3 modernos. Se você não tem certeza se tem aplicativos v2 instalados, use o seguinte comando para verificar:
kubectl get all -n gitlab-managed-apps | grep 'helm.sh/release'
Apps que estão mostrado na saída deste comando foram instalados pelo Helm v3. Compare a lista com a anterior get all comando para identificar aplicativos adicionados pelo Helm v2.
Se seus aplicativos estiverem usando o Helm v2, você precisará percorrer manualmente o guia de migração do Helm para atualizá-los. É recomendável que você mude para o Helm v3 se for manter os aplicativos por muito tempo. Como alternativa, instalar o Helm v2 em sua máquina permitirá que você interaja com os aplicativos para aplicar correções e manutenção imediatas.
Atualizando para o novo modelo de aplicativos de cluster do GitLab
O objetivo primordial dos aplicativos gerenciados - simplificar a configuração do cluster - não foi completamente descartado pelo GitLab. O GitLab 14.0 se concentra em “projetos de gerenciamento” de cluster como um novo modelo de implantação para provisionamento de cluster.
O GitLab fornece um modelo de projeto que você pode usar para instalar aplicativos em clusters Kubernetes. Isso aborda os problemas originais com aplicativos gerenciados, garantindo que você tenha controle total sobre os gráficos do Helm que são implantados. Você clona o modelo, conecta o projeto ao cluster e, em seguida, edita e exclui os gráficos de aplicativos individuais conforme necessário. Executar um pipeline de CI implantará os aplicativos selecionados em seu cluster.
Você pode migrar aplicativos gerenciados existentes para o formato de projeto de gerenciamento. Isso permite que você continue operando-os usando uma abordagem endossada pelo GitLab. Vamos supor que você já tenha um cluster Kubernetes conectado à sua instância GitLab, em virtude de suas implantações existentes.

Comece criando um novo projeto GitLab usando o botão de adição no canto superior direito. Clique em “Create from template”, então role para baixo até o template “GitLab Cluster Management”. Clique no botão “Usar modelo”. Na próxima tela, dê um nome ao seu projeto e pressione “Criar projeto”.
O modelo fornece uma série de gráficos Helm para implantar aplicativos em seu cluster. Os gráficos de aplicativos individuais são armazenados no applications diretório. Cada aplicativo tem seu próprio subdiretório. #

Comece editando helmfile.yaml na raiz do seu projeto, no GitLab Web IDE ou clonando o repositório usando Git. Este arquivo faz referência aos modelos de aplicativos individuais. Habilite os aplicativos que você está usando descomentando as linhas relevantes. Neste exemplo, instalamos anteriormente o Ingress e o Cert Manager como GitLab Managed Apps, portanto, estamos ativando-os no projeto de gerenciamento de cluster.
Em seguida, você precisa descobrir qual versão do gráfico já está implantada em seu cluster. Esta etapa é importante para que você não substitua acidentalmente seu aplicativo por uma versão diferente.
Você pode obter a versão de um aplicativo executando helm ls -n gitlab-managed-apps. Procure o aplicativo na tabela de saída e anote a versão exibida no CHART coluna. Isso tomará o formato app-name-X.Y.Z; você só precisa do X.Y.Z papel.

Retorne ao seu novo projeto GitLab e abra o helmfile.yaml associado ao aplicativo, como applications/ingress/helmfile.yaml. Mudar o version campo para corresponder à versão que você anotou.

Finalmente, substitua o padrão values.yaml com seu conjunto existente de valores de Helm. Use o Helm para carregar a representação YAML do arquivo de valores do seu aplicativo:
helm get values ingress -n gitlab-managed-apps -a --output yaml
Substituto ingress com o nome da implantação do seu aplicativo. Copie toda a saída YAML e use-a para substituir o applications/ingress/values.yaml Arquivo. Certifique-se de ajustar o caminho do arquivo para corresponder ao seu aplicativo. Agora você está pronto para executar a implantação do projeto de gerenciamento de cluster.
Um pipeline de implantação começará automaticamente quando você mesclar suas alterações no branch padrão (que geralmente é main para novos projetos no GitLab 14.0). Use o Git para confirmar suas alterações e mesclá-las em:
git checkout -b my-branch git add . git commit -m "Migrate existing GitLab Managed Apps" git checkout main git merge my-branch git push -u origin main
O pipeline será executado. Se as alterações do modelo estiverem corretas, não deve haver impacto nos aplicativos em execução. Alguns metadados inofensivos podem ser modificados conforme o mecanismo de implantação muda.
Agora você está pronto para usar o projeto de gerenciamento de cluster para a manutenção contínua de seus aplicativos. Por exemplo, você pode atualizar para uma nova versão de um aplicativo editando o version campo em seu helmfile.yaml. Mesclando a mudança em main solicitaria ao Helm para aplicar as mudanças dentro do seu cluster.
Conclusão
Os aplicativos gerenciados GitLab ajudaram muitos usuários a dar os primeiros passos com o Kubernetes. A simplicidade do recurso acabou se mostrando muito limitante, então agora está sendo removido em um processo de várias etapas.
Felizmente, é bastante simples concluir sua migração de aplicativos gerenciados. Não há nada de especial sobre eles - eles são simplesmente implantações regulares do Helm que vivem no seu cluster gitlab-managed-apps namespace. Isso significa que suas cargas de trabalho permanecerão disponíveis mesmo se você atualizar para o GitLab 14.0, deixando-o livre para fazer a transição em seu próprio ritmo.
Seguindo em frente, os projetos de gerenciamento de cluster são a abordagem preferencial para usar o GitLab para instalar aplicativos populares no Kubernetes. Embora seja um pouco mais exigente tecnicamente, este modelo oferece muito mais controle e ajuda a gerenciar sua infraestrutura como código.



