Instalando e configurando a ferramenta GitOps

Instale e configure a ferramenta ArgoCD GitOps para o Automation Suite no EKS/AKS.

Observação:

Antes de prosseguir com a instalação e configuração do ArgoCD, você deve instalar o Istio e fornecer todas as permissões necessárias para a conta de serviço uipathadmin .

For the service mesh installation and configuration instructions, refer to Installing and configuring the service mesh.

For the installation permissions, refer to Granting installation permissions.

If you cannot grant admin privileges to the Automation Suite installer, you must bring your own ArgoCD for the Automation Suite deployment. For details, refer to Provisioning ArgoCD.

Provisionamento do ArgoCD

Se você não puder conceder privilégios de administrador ao instalador do Automation Suite, você deve trazer seu próprio ArgoCD e seguir as seguintes etapas de configuração:

• Forneça o valor correto para o parâmetro application_namespace na seção argocd do seu arquivo input.json . Esse é o namespace onde os aplicativos são criados e, idealmente, deve ser o namespace onde o ArgoCD é instalado.
• If you install Automation Suite on a shared cluster, we recommend creating a new ArgoCD project dedicated to Automation Suite rather than using the default project. For details on how to create a project in ArgoCD, refer to Creating a project in ArgoCD.
• Configure the Helm repository in ArgoCD. For details, refer to Configuring the Helm repository in ArgoCD.
• Grant the necessary permissions on the ArgoCD namespace. For details, refer to Granting the necessary permissions on the ArgoCD namespace.

Criação de um projeto no ArgoCD

Para criar um novo projeto na interface gráfica do ArgoCD, siga as seguintes etapas:

1. Faça login no ArgoCD.
2. Navegue até Configurações > Projetos > +NEW PROJECT.
3. Forneça um nome e uma descrição para o projeto.
4. Adicione os seguintes destinos:
   1. Insira <uipath> como o namespace e https://kubernetes.default.svc como o servidor.
   2. Insira <istio-system> como o namespace e https://kubernetes.default.svc como o servidor.
5. Adicione o namespace <argocd> a sourceNamespaces.
   Observação:

   Em versões mais antigas do ArgoCD, sourceNamespaces não é visível na interface gráfica.

Você também pode criar um projeto do ArgoCD declarativamente:

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: <project-name>
  namespace: <argocd-namespace>
spec:
  description: App project to manage and deploy uipath applications
  clusterResourceWhitelist:
    - group: '*'
      kind: '*'
  destinations:
    - namespace: <uipath>
      server: https://kubernetes.default.svc
    - namespace: <istio-system>
      server: https://kubernetes.default.svc
  sourceNamespaces:
    - <argocd-namespace>
  sourceRepos:
    - '*'

Configurando o repositório do Helm no ArgoCD

Para configurar o repositório do Helm no ArgoCD, siga as seguintes etapas:

1. Faça login no ArgoCD.
2. Navegue até Configurações > Repositórios > +CONNECT REPO.
3. Use VIA HTTPS para o método de conexão.
4. Selecione Helm como o tipo.
5. Forneça um nome.
6. Escolha uipath como o projeto. uipath é o nome do projeto ArgoCD que você criou para o aplicativo UiPath®.
7. Forneça a URL do repositório, nome de usuário, senha e informações do certificado.
8. Habilite a caixa de seleção OCI .
9. Select Connect.
10. Certifique-se de que o status da conexão seja Bem-sucedido.

Concedendo as permissões necessárias no namespace ArgoCD

Para conceder as permissões necessárias no namespace ArgoCD, siga as seguintes etapas:

1. Crie uma função para criar e editar o segredo no namespace. <argocd>

   apiVersion: rbac.authorization.k8s.io/v1
   kind: Role
   metadata:
     name: argo-secret-role
     namespace: <argocd>
   rules:
     - apiGroups: ["rbac.authorization.k8s.io"]
       resources: ["roles", "rolebindings"]
       verbs: ["*"]
     - apiGroups: ["*"]
       resources: ["secrets"]
       verbs: ["get", "watch", "list", "patch", "update", "create"]
   

2. Associe a função argo-secret-role à conta de serviço uipathadmin :

   kubectl -n <argocd> create rolebinding secret-binding \
     --role=argo-secret-role --serviceaccount=<uipath>:uipathadmin
   

3. Crie uma função para gerenciar os aplicativos no namespace. <argocd>

   apiVersion: rbac.authorization.k8s.io/v1
   kind: Role
   metadata:
     name: uipath-application-manager
     namespace: <argocd>
   rules:
     - apiGroups:
         - argoproj.io
       resources:
         - applications
       verbs:
         - "*"
   

4. Associe a função uipath-application-manager à conta de serviço uipathadmin :

   kubectl create rolebinding uipath-application-manager-rolebinding --role=uipath-application-manager --serviceaccount=<uipath>:uipathadmin -n <argocd>
   

5. Associe a função de leitor de namespace no namespace <argocd> à conta de serviço uipathadmin :

   kubectl -n <argocd> create rolebinding namespace-reader-rolebinding \
     --clusterrole=namespace-reader-clusterrole --serviceaccount=<uipath>:uipathadmin