Como criar CRD no Kubernetes

O que é CRD no Kubernetes?

CRD significa Custom Resource Definition usado para novos recursos sem adicionar outro servidor de API. Para trabalhar com CRDs, você não precisa entender a agregação de API. É um recurso muito poderoso introduzido no Kubernetes 1.7 para ser fornecido com vários recursos integrados e objetos de API. Ele permite que você defina recursos personalizados com um esquema e nome de sua escolha.

Os CRDs estendem as habilidades da API do Kubernetes que excedem a instalação padrão, utilizando as definições de recursos personalizados. Ao utilizar CRDs, você pode orientar o Kubernetes de uma maneira que possa lidar com mais do que apenas contêineres. Você pode criar um recurso personalizado de sua própria escolha e torná-lo declarativo usando os controladores personalizados. Agora, vamos aprender como criar uma definição de recurso personalizada e, em seguida, projetar um controlador personalizado para controlar o CRD. E então como excluir o CDR para ver seu impacto no Kubernetes.

Pré-requisito

Antes de passarmos para as etapas de criação e exclusão do CRD, vamos garantir que nosso sistema atenda a todas as necessidades dos pré-requisitos.

• Ubuntu 20.04 ou qualquer outra versão mais recente para ter um ambiente Linux/Unix para funcionar.
• Cluster do Kubernetes.
• Kubectl CLI para usar comandos kubectl, comunicação de cluster e gerenciar o ambiente de desenvolvimento.
• minikube ou qualquer outro playground do Kubernetes para criar os clusters

Instale essas ferramentas, caso ainda não as tenha instalado, antes de prosseguir para a próxima seção.

Agora, passaremos para o guia passo a passo sobre como criar CRDs no Kubernetes.

Etapa 1: Iniciar o Kubernetes

Para trabalhar com CDRs, você deve ter um cluster com pelo menos dois nós Kubernetes que não estejam funcionando como hosts do plano de controle. Estamos usando o minikube para criar e usar o cluster. Então, use o comando abaixo para iniciar o minikube:

Ao executar este comando, você obterá uma saída semelhante à fornecida abaixo:

Etapa 2: abra ou crie um arquivo de configuração

Agora que nosso minikube está funcionando, vamos abrir o arquivo de configuração. O comando ‘nano’ é usado para abrir os arquivos de configuração. Tudo o que você precisa fazer é fornecer o nome do arquivo ao lado do comando nano seguido da extensão do arquivo e pressionar enter. Aqui, temos o arquivo 'red.yaml' que contém os detalhes de configuração para criar os CRDs. Aqui está o comando nano completo que você pode usar para abrir o arquivo desejado:

Ao executar este comando, o seguinte arquivo será aberto em seu terminal:

Etapa 3: criar um recurso de endpoint

Os recursos de configuração foram salvos no red.yaml. Usaremos isso para criar o novo endpoint da API RESTful com namespace. Kubectl fornece o comando ‘apply’ para criar um endpoint a partir de um arquivo de configuração. Aqui está o comando ‘apply’ completo que é usado para criar a nova API RESTful com namespace:

O endpoint criado por este comando será usado para criar o objeto personalizado que controlará o CRD. A seguinte saída será gerada para o recurso com namespace:

Etapa # 4: Crie um objeto personalizado para controlar o CRD

Os CRDs são controlados pelos objetos personalizados. Podemos criá-los assim que a definição de recurso personalizado for criada. Os objetos personalizados contêm os campos personalizados de JSON arbitrário. Para criar o objeto personalizado, precisamos novamente de um arquivo de configuração YAML. Use o comando ‘nano’ para criar o arquivo de configuração YAML:

Salve os campos obrigatórios com os detalhes específicos no arquivo YAML. Os detalhes de configuração de amostra são mostrados na amostra abaixo:

Agora, use o mesmo arquivo YAML para criar o objeto personalizado. Use o comando ‘apply’ para criar o objeto personalizado a partir do arquivo YAML especificado. Veja o comando completo dado abaixo:

Após a execução bem-sucedida deste comando, você obterá a seguinte saída:

Etapa # 5: Gerenciar o CRD com um objeto personalizado

Os objetos personalizados são usados ​​para gerenciar os CRDs. Então, vamos aprender como podemos utilizar o objeto personalizado criado recentemente para gerenciar o CRD já criado. Aqui, vamos verificar os detalhes que contêm o objeto personalizado usando o comando 'get'. Veja o comando fornecido no trecho de código abaixo:

Ao executar este comando no terminal minikube, a seguinte saída será gerada:

Se você deseja verificar os dados brutos contidos no arquivo YAML, pode usar este comando:

Isso mostrará os dados brutos no arquivo YAML como o exemplo abaixo:

É assim que podemos criar o CRD e um objeto personalizado para gerenciar e controlar o CRD criado. Agora, se você deseja excluir o CRD criado, siga o procedimento abaixo.

Como excluir os CRDs criados no Kubernetes?

Os comandos kubectl permitem excluir os CRDs no Kubernetes. Ao tentar excluir o CRD no Kubernetes, os recursos personalizados associados a ele também serão excluídos. O kubectl fornece o comando 'delete' para excluir qualquer recurso. O comando fornecido abaixo é usado para excluir o CRD que criamos nas etapas acima:

Após a execução bem-sucedida deste comando, você obterá o seguinte resultado:

Agora que o CRD e os objetos personalizados associados a ele foram excluídos, você receberá um erro do servidor se tentar acessá-lo. Veja o comando dado abaixo onde estamos tentando acessar a API RESTful com namespace:

Como o 'crontabs' foi excluído, o servidor gerará o erro para esta ação. Veja a saída deste comando dado abaixo:

Conclusão

Este artigo foi uma visão geral rápida de como criar a definição de recurso personalizado, como criar um objeto personalizado para controlar os CRDs e como excluir o CRD do Kubernetes. Com a ajuda de exemplos de amostra, demonstramos cada etapa para ajudá-lo a entender o processo de maneira fácil e rápida.