Introdução ao Red Hat Ansible Lightspeed com IBM watsonx Code Assistant

No Red Hat Summit e no AnsibleFest 2023, anunciamos o Ansible Lightspeed with IBM Watson Code Assistant, um novo serviço de IA generativa para o Ansible. Em junho de 2023, lançamos uma apresentação técnica prévia das suas funcionalidades. Hoje, estamos felizes em anunciar que o Red Hat Ansible Lightspeed com IBM watsonx Code Assistant agora está disponível como um componente do Red Hat Ansible Automation Platform.

O Ansible Lightspeed com watsonx Code Assistant foi projetado para auxiliar as equipes de automação a criar, adotar e manter o conteúdo do Ansible com mais eficiência. 

Neste post, explicamos as etapas para instalar e executar o Ansible Lightspeed com IBM watsonx Code Assistant na sua empresa. Mostraremos como os usuários finais podem configurar o serviço no ambiente do Visual Studio Code (VS Code). Também falaremos mais sobre o que esperar da experiência e das ferramentas complementares disponíveis para turbinar sua jornada de criador do Ansible com recursos de IA generativa criados com transparência, precisão e poder de escolha. 

Essa é uma ótima adição à experiência do Ansible Automation Platform, então vamos começar.

Funcionalidades comerciais: trazendo a IA para a criação de conteúdo do Ansible por meio da colaboração entre a Red Hat e a IBM

O Ansible Lightspeed com o watsonx Code Assistant é o resultado da combinação de forças entre as equipes da Red Hat e da IBM para criar uma experiência de IA coesa voltada à criação de conteúdo do Ansible. Usando os modelos-base do IBM watsonx específicos para automação, ele transforma prompts de texto em trechos de conteúdo do Ansible para a criação de conteúdo do Ansible. O conteúdo gerado segue as práticas recomendadas aceitas pelo Ansible e, quando combinado com o recurso de bot de código do Ansible, as equipes podem ter mais confiança em sua base de código de automação.

O serviço consiste em três componentes:

1. A interface do desenvolvedor: incorporada de maneira nativa na extensão do VS Code por meio da extensão do Ansible, isso permite que os criadores de conteúdo do Ansible usem prompts de linguagem natural nos arquivos de tarefas ou playbooks do Ansible para gerar sugestões de tarefas únicas e multitarefa do Ansible Lightspeed.
2. O serviço integrado: atua como intermediário entre a interface do desenvolvedor e o serviço watsonx.ai. Ele traz o poder da IA para o Ansible Automation Platform e aprimora as respostas da IA com seus recursos de pós-processamento.
3. Inteligência Artificial: o IBM watsonx Code Assistant fornece acesso ao modelo base watsonx.ai específico do Ansible que gera recomendações de conteúdo do Ansible. Essa é a base da IA da solução.

Nas próximas etapas, explicaremos como configurar e começar a usar o Ansible Lightspeed com o watsonx Code Assistant.

Login e configuração do Red Hat Ansible Lightspeed para se conectar ao IBM watsonx Code Assistant

Observação: esta seção é destinada apenas a usuários com privilégios de administrador na conta da sua organização no portal do cliente Red Hat. Se não for seu caso, pule para a próxima seção sobre como se conectar à extensão do VS Code para Ansible. 

Como administrador do portal do cliente Red Hat, você deve configurar o Red Hat Ansible Lightspeed para se conectar à sua instância do IBM watsonx Code Assistant. Essa configuração permite que o Red Hat Ansible Lightspeed se comunique com sua instância do IBM watsonx Code Assistant.

Você precisa das seguintes informações do IBM watsonx Code Assistant para conectar o Red Hat Ansible Lightspeed:

• Chave de API do IBM watsonx Code Assistant (WxCA)
  • Uma chave de API WxCA autentica todas as solicitações feitas do Red Hat Ansible Lightspeed para o IBM watsonx Code Assistant. Cada organização Red Hat com uma subscrição válida do Ansible Automation Platform deve ter uma chave de API do WxCA configurada. Quando um usuário autenticado do Red Hat Single Sign-On (SSO) consulta o Red Hat Ansible Lightspeed para obter uma sugestão, a chave de API do WxCA associada à organização do Red Hat do usuário é usada para autenticar a solicitação para o IBM watsonx Code Assistant. 
• ID de modelo
  • Uma ID de modelo do WxCA exclusiva identifica um modelo do IBM watsonx Code Assistant em sua conta do IBM Cloud. A ID do modelo que você configura no portal do administrador do Red Hat Ansible Lightspeed é usada como o modelo padrão, portanto, será usada para obter sugestões do Ansible Lightspeed para todos os usuários em sua organização que tenham uma estação atribuída. Esse modelo de tenant único do IBM watsonx Grantite é exclusivo à sua organização e ajuda na privacidade, conformidade e segurança dos dados. Esses modelos são fornecidos, gerenciados e mantidos pela IBM.

Importante: você deve configurar a chave de API do WxCA e a ID do modelo ao fazer a configuração inicial do Red Hat Ansible Lightspeed.

Pré-requisitos

• Você tem privilégios de administrador em uma organização do Portal do Cliente Red Hat com uma subscrição válida do Ansible Automation Platform.
• Você obteve uma chave de API do WxCA e uma ID de modelo do IBM watsonx Code Assistant que deseja usar no Red Hat Ansible Lightspeed. 

Para informações sobre como obter uma chave de API do WxCA e uma ID de modelo do IBM watsonx Code Assistant, consulte a documentação do IBM watsonx Code Assistant. 

Procedimento

1. Faça login no portal do Ansible Lightspeed como administrador da organização.
2. Clique em Log in > Log in with Red Hat. 
3. Digite o nome de usuário e a senha da sua conta da Red Hat. 
   • O serviço do Red Hat Ansible Lightspeed usa o Red Hat Single Sign-On (SSO) para autenticação. 
   • Como parte do processo de autenticação, o serviço Red Hat Ansible Lightspeed verifica se você é um administrador da organização e se sua organização tem uma subscrição válida do Ansible Automation Platform. Após a autenticação com êxito, a tela de login é exibida com seu nome de usuário e sua função de usuário atribuída. 
4. Na tela de login, clique em Admin Portal. 
   • Você será redirecionado para o portal do administrador do Ansible Lightspeed with watsonx Code Assistant, que pode ser usado para conectar o Red Hat Ansible Lightspeed à sua instância do IBM watsonx Code Assistant.
5. Especifique a chave de API da instância do IBM watsonx Code Assistant e clique em Save.
   • Opcional: clique em Test para validar a chave de API
6. Especifique a ID do modelo que você deseja usar e clique em Save.
   • Opcional: clique em Test para validar a ID do modelo.
7. Quando a chave da API do WxCA e a ID do modelo forem validadas com êxito, o Red Hat Ansible Lightspeed será conectado à sua instância do IBM watsonx Code Assistant.

Atribuição e remoção de licenças por estação

Observação: esta seção é destinada apenas a usuários com privilégios de administrador na conta da sua organização no portal do cliente Red Hat. Se não for seu caso, pule para a próxima seção sobre como se conectar à extensão do VS Code para Ansible.

Após conectar o Red Hat Ansible Lightspeed a uma instância do IBM watsonx Code Assistant, os administradores da organização do Portal do Cliente Red Hat podem atribuir licenças por estação aos usuários do Ansible Automation Platform em sua organização. O recurso de atribuição de licenças permite que usuários selecionados do Ansible Automation Platform na sua organização acessem e usem o Red Hat Ansible Lightspeed. 

Sua subscrição do Ansible Automation Platform inclui um número específico de licenças nomeadas do Red Hat Ansible Lightspeed dependendo do número de subscrições que sua organização adquiriu. O Red Hat Ansible Lightspeed autentica os usuários usando o Red Hat Single Sign On (SSO) e verifica se eles têm uma licença por estação atribuída.

Atribuição de licenças por estação

Você pode conceder licenças por estação do Red Hat Ansible Lightspeed a usuários selecionados na sua organização.  

Pré-requisitos

• Você deve ter a função de administrador da organização no Portal do Cliente Red Hat. 
• Você deve ter configurado o Red Hat Ansible Lightspeed para se conectar à instância do IBM watsonx Code Assistant.
• Você deve estar conectado ao Ansible Automation Platform no Red Hat Hybrid Cloud Console como administrador da organização.

Procedimento

1. Acesse Ansible Automation Platform no Red Hat Hybrid Cloud Console.
2. No painel de navegação, selecione Ansible Lightspeed com IBM watsonx Code Assistant > Seat Management. 
3. Clique em Assign users.
4. Digite o nome de usuário ao qual você deseja atribuir uma licença de estação.
5. Clique em Assign e, na mensagem de verificação, clique em Ok para confirmar.

E assim, os usuários com estações atribuídas passarão a ter acesso ao Ansible Lightspeed com o serviço watsonx Code Assistant.

Conexão: instalação e configuração

Pré-requisitos

• O Visual Studio Code e o Ansible instalados na sua workstation
• Uma conta no Portal do Cliente Red Hat (vinculada à sua organização)
• Uma licença atribuída à sua conta pelo administrador da organização do portal Red Hat para que sua organização acesse o serviço Red Hat Ansible Lightspeed.

Procedimento

• Instale a extensão do Ansible VS Code no Visual Studio Code Marketplace pesquisando por "ansible" e selecionando a extensão publicada pela Red Hat. A versão mínima da extensão do Ansible para funcionar com o serviço Ansible Lightspeed é a 2.8.108. Verifique o histórico da versão aqui.
• Habilite o serviço Red Hat Ansible Lightspeed na extensão acessando "Extension Settings" no ícone de engrenagem.
• Nas configurações, ative as caixas de seleção "Ansible Lightspeed enabled" e "Enable Ansible Lightspeed with Watson Code Assistant inline suggestions".

Observação: você pode ativar o Red Hat Ansible Lightspeed nas configurações "User" ou "Workspace", de acordo com sua preferência. Mais informações sobre as configurações de usuário e espaço de trabalho do VS Code podem ser encontradas na documentação.

Instalação da extensão do Ansible Visual Studio Code

• Clique no "A" de Ansible na barra de atividades do VS Code no lado esquerdo do editor para abrir a extensão.
• Clique em "Connect" e siga as instruções para fazer login na sua conta da Red Hat usando suas credenciais.
• Em seguida, autorize o Ansible Lightspeed para VS Code clicando em "Authorize".
• Siga os prompts do navegador para redirecionar você de volta ao VS Code e, por fim, clique em "Open" na caixa de diálogo de confirmação do VS Code.

Faça login usando as suas credenciais do Red Hat

Parabéns! Você configurou o Ansible Lightspeed com o watsonx Code Assistant no VS Code.

Você pode confirmar se o Red Hat Ansible Lightspeed está habilitado verificando a barra de status do VS Code na parte inferior da janela do editor.

Certifique-se de que um ambiente Python esteja selecionado e que seus arquivos YAML do Ansible estejam associados à linguagem do Ansible. Encontre mais informações sobre as linguagens do VS Code na documentação.

Criar com o Red Hat Ansible Lightspeed

Agora que você está conectado ao Ansible Lightspeed com o watsonx Code Assistant, é hora de colocar em prática a experiência de criação de conteúdo aprimorada por IA.

Usaremos um playbook de exemplo para analisar como pedir sugestões de tarefas geradas por IA ao Red Hat Ansible Lightspeed. Além disso, destacaremos algumas das funcionalidades comerciais. O playbook de exemplo instala e configura o PostgreSQL em todas as máquinas do grupo de hosts do banco de dados.

Observação: como parte das nossas melhorias contínuas no serviço, a IBM e a Red Hat continuarão enviando atualizações para melhorar a qualidade das recomendações. Portanto, as sugestões de tarefas do Ansible nos exemplos abaixo podem ser diferentes.

Como gerar uma sugestão do Red Hat Ansible Lightspeed?

Vamos usar nossa primeira tarefa de playbook no playbook de exemplo configure_postgres.yml para demonstrar a solicitação de uma sugestão de IA ao Ansible Lightspeed com watsonx Code Assistant.

• Mova o cursor para o final da descrição da tarefa "- name: Install postgresql-server".
• Pressione "ENTER" para gerar uma sugestão.
• Pressione "TAB" para aceitar a sugestão.

Geração de uma tarefa do Ansible

Nesta sugestão, pedimos ao serviço para instalar o pacote "postgresql-server", a sugestão usou o Nome de coleção totalmente qualificado (FQCN) - ansible.builtin.package para fazer referência ao módulo do Ansible para gerenciar o SO genérico pacotes.

Usar FQCNs é uma prática recomendada e um exemplo dos muitos recursos exclusivos de pós-processamento que incluímos no serviço Red Hat Ansible Lightspeed.

Vamos para as próximas tarefas.

Como faço para gerar várias sugestões de tarefas?

Agora que recebemos uma sugestão do serviço para "Install postgresql-server", precisamos pedir mais algumas sugestões do serviço para configurar o PostgreSQL, como

• Executar o comando postgresql-setup
• Iniciar e habilitar o serviço postgresql
• Permitir o tráfego de postgres pelo firewall

Uma opção seria seguir o mecanismo de tarefa única para obter recomendações para cada tarefa, como fizemos na seção acima.

Um novo e empolgante recurso comercial do Ansible Lightspeed com watsonx Code Assistant é a geração de várias tarefas. Uma etapa no roadmap para a geração completa do playbook, a geração multitarefa permite gerar várias tarefas com uma única entrada de prompt, encadeando várias descrições de tarefas usando o sinal de e comercial (&) em um comentário YAML no nível da tarefa.

Vamos usar nosso mesmo exemplo de playbook e demonstrar como solicitar ao serviço sugestões de multitarefa. Já criamos um comentário YAML neste arquivo. Se você observar atentamente a linha 12, verá que encadeamos as diferentes tarefas para configurar o PostgreSQL com sinal de e comercial (&) em um comentário YAML no nível da tarefa.

• Mova o cursor para o final da linha "# Run postresql-setup command & Start and enable postgresql service & Allow the traffic", o qual é um comentário YAML.
• Pressione "ENTER" para gerar uma sugestão com múltiplos.
• Pressione "TAB" para aceitar a sugestão.

Geração de várias tarefas do Ansible

No mesmo playbook, desta vez, pedimos várias sugestões juntas para "Run postgresql-command", "Start and enable postgresql service" e "Allow the traffic". A sugestão retornou três tarefas do Ansible na sugestão desta vez.

Ao gerar sugestões de conteúdo do Ansible contextualizadas e precisas, você economiza tempo e cria com eficiência. Um dos grandes destaques do Red Hat Ansible Lightspeed é o contexto. A última tarefa apenas pede para "Permitir o tráfego", o que pode parecer contra-intuitivo que uma IA "faça perguntas", mas o serviço Red Hat Ansible Lightspeed está ciente do playbook do Ansible no qual está trabalhando e sugere uma sugestão de porta para abrir que corresponde ao porta padrão para PostgreSQL (5432). 

Observação: este é apenas um exemplo para mostrar aos leitores um recurso do Ansible Lightspeed com o watsonx Code Assistant. Ao escrever conteúdo do Ansible, recomendamos que os nomes das tarefas sejam explícitos para facilitar o entendimento do seu conteúdo do Ansible por qualquer pessoa.

Vamos para o próximo recurso.

Adotar com transparência integrada: correspondência de fonte de conteúdo

Outro recurso importante do Ansible Lightspeed com watsonx Code Assistant é a transparência e a abertura usando a correspondência de origem de conteúdo. Compartilhamos com transparência a possível fonte, o autor e a licença de conteúdo dos dados de treinamento usados para a recomendação. Desenvolver a confiança na comunidade e apoiar as relações entre autores e colaboradores faz parte do DNA da Red Hat

Correspondência de fontes de conteúdo do Ansible Lightspeed

Adoção com as práticas recomendadas do Ansible e mais precisão

O Red Hat Ansible Lightspeed tem como foco exclusivo a automação, proporcionando uma experiência de IA generativa simplificada e precisa que é feita sob medida por e para as equipes de automação de TI.  Com recursos de pós-processamento que aderem às práticas recomendadas, as equipes de automação podem confiar no conteúdo que estão aceitando.

Os recursos de pós-processamento do Red Hat Ansible Lightspeed aprimoram as recomendações de conteúdo do Ansible feitas pelo IBM watsonx Code Assistant para práticas recomendadas. Por exemplo, usar FQCN, fazer anonimização de dados e substituições de variáveis, entre outros.

O exemplo na seção "como gerar uma sugestão" acima mostrou as sugestões geradas com FQCNs como um dos recursos de pós-processamento do serviço.

Manutenção: bot de código do Ansible (prévia de serviços)

Os clientes sempre se perguntam: "nós temos o conteúdo, mas o que devemos fazer?" Como migrar da automação em silos? Como criar uma comunidade de prática?

Nossa resposta começa com a cultura. Tratar os fluxos de trabalho de infraestrutura como ativos de software catalisa a abordagem colaborativa necessária para a automação ao nível empresarial. 

No entanto, isso pode envolver o aprendizado de novas habilidades, como controle de versão, testes automatizados e revisão de código. Nosso objetivo com o bot de código do Ansible é estender a melhoria da qualidade do conteúdo Ansible além da criação e em todo o seu fluxo de trabalho.

O bot de código do Ansible verifica as Ansible Content Collections, as funções e os playbooks existentes hospedados nos repositórios do GitHub e cria pull requests proativamente sempre que as práticas recomendadas ou recomendações de melhoria de qualidade estão disponíveis. O bot envia automaticamente pull requests ao repositório, que alerta proativamente o proprietário do repositório sobre uma alteração recomendada em seu conteúdo. Você pode configurar o bot de código do Ansible para verificar seus repositórios Git existentes (públicos e privados).

O bot de código do Ansible usa o lint do Ansible para recomendar melhorias na qualidade do conteúdo do Ansible. O objetivo é promover práticas, padrões e comportamentos comprovados, evitando erros comuns que podem facilmente levar a bugs ou dificultar a manutenção do conteúdo. O bot de código do Ansible verifica seu conteúdo com base nas regras configuradas para garantir que ele siga as práticas recomendadas do Ansible.

Pré-requisitos

• Uma conta no Portal do Cliente Red Hat vinculada à sua organização
• Sua organização deve ter uma subscrição válida do Ansible Lightspeed com uma subscrição do código watsonx habilitada.

Procedimento

1. Faça login no GitHub usando uma conta associada à sua organização.
2. Instale a aplicação do GitHub para a organização da qual você é membro. 
3. Acesse o Ansible code bot na aplicação GitHub:
   • https://github.com/apps/ansible-code-bot
4. Selecione os repositórios nos quais você quer instalar o Ansible code bot.
5. Clique em Install & Authorize.
6. Quando solicitado, faça login na sua conta do Red Hat SSO.

Ansible Code bot em ação

Depois que o Ansible Code bot for instalado nos repositórios Git selecionados, você poderá configurar um cronograma para verificar seus repositórios Git em intervalos regulares. Você também pode verificar manualmente seus repositórios Git adicionando um tópico chamado “ansible-code-bot-scan” ao seu repositório, caso você não tenha configurado um cronograma de verificação para seu bot de código Ansible ou se não quiser aguardar a próxima verificação agendada.

Observação: a prévia de serviço é a "fase" inicial de lançamento de um serviço de nuvem. As visualizações de serviço são disponibilizadas a clientes internos e externos selecionados para coletar feedback inicial sobre um serviço, mas não para uso em produção. Além disso, os recursos individuais de um serviço de computação em nuvem na fase de avaliação de campo, disponibilidade limitada ou disponibilidade geral podem ser documentados como prévia de serviço, o que significa que o recurso não é destinado a uso em produção.

Conclusão

Parabéns! Você configurou com sucesso o Ansible Lightspeed com o watsonx Code Assistant para sua organização. Você também pode usar novos recursos incríveis de IA generativa em apenas algumas etapas simples.

Convidamos você a participar da sala do Ansible Lightspeed Matrix, um ótimo lugar para compartilhar seu feedback, receber as notícias mais recentes e receber respostas de seus colegas de automação e da equipe da Red Hat.  

Próximas etapas + recursos 

Para mais informações sobre as próximas etapas, confira a página inicial do Red Hat Ansible Lightspeed, onde você encontra links para clientes Red Hat existentes e interessados em conhecer o Ansible Automation Platform. 

Recursos adicionais à medida que você explora o Ansible e a IA generativa: 

• Vídeo de visão geral
• Press release: Red Hat lança o Red Hat Ansible Lightspeed com o IBM watsonx Code Assistant para automação de TI empresarial orientada por IA
• Documentação do produto: Red Hat Ansible Lightspeed com IBM watsonx Code Assistant
• Vídeo: Uma conversa da RedMonk: automação de IA e TI com o Ansible
• Datasheet do Red Hat Ansible Lightspeed
• Blog: A evolução do Ansible: capacitando pessoas e tecnologias
• A playlist do YouTube do Red Hat Ansible Lightspeed continuará a ser atualizada com demonstrações úteis e explicações sobre as funcionalidades. 
• Para mais insights sobre o modelo base específico para o Ansible da IBM, confira a página IBM watsonx Code Assistant.

Continuaremos disponibilizando blogs, vídeos e outros recursos à medida que esse serviço evolui para ajudar você a aproveitar ao máximo a IA generativa, do jeito Ansible. 

Agradecemos seu tempo de leitura e boa sorte com a automação.