Configuração do registro compatível com OCI

Configure e gerencie registros de contêiner compatíveis com OCI para implantações offline do Automation Suite.

Em instalações offline, você precisa de um registro compatível com o OCI (Open Container Iniciative) para armazenar as imagens de contêiner e os gráficos do Helm de implantação.

Upload dos artefatos do Automation Suite para o registro externo compatível com OCI

Há duas maneiras de carregar os artefatos do Automation Suite para o registro externo compatível com OCI:

• Opção A: espelhando seu registro compatível com o OCI com o registro da UiPath®
• Opção B: populando seu registro compatível com OCI com o pacote offline

A tabela a seguir compara as duas opções para carregar os artefatos para o registro para que você possa escolher aquela que atenda às suas necessidades:

Opção A: espelhar o registro	Opção B: hidratando o registro
Copia os artefatos do registro da UiPath® para qualquer registro de destino.	Usa o tarball offline para descompactar e carregar os artefatos para o registro de destino.
Requer ferramentas do Docker e do Helm.	Requer ferramentas do Podman e do Helm.
Requer acesso à internet para copiar os artefatos do registro da UiPath® para o registro de destino.	Requer acesso à internet apenas para baixar o tarball offline para o jump server. O upload do tarball não requer acesso à internet.
Requer um espaço temporário para armazenar em cache as imagens durante o método de cópia. Esse espaço normalmente é configurado durante a instalação do Docker. O local padrão é /var/lib/docker.	Requer um espaço temporário para extrair o tarball e um espaço temporário para o Podman carregar as imagens. O local da extração do tarball deve ser fornecido durante a etapa de hidratação. O local do Podman pode ser /var/tmp, que deve ter armazenamento adequado disponível.
A capacidade de armazenamento necessária para o diretório /var/lib/docker é de cerca de 128 GB.	A capacidade de armazenamento necessária para a extração é de cerca de 200 GB, e /var/tmp deve ser de 256 GB.

Observação:

É recomendável executar a operação de espelhamento ou hidratação na máquina de gerenciamento ou na jump box, em vez de usar os nós do servidor.

Opção A: espelhamento do registro da UiPath® para seu registro

Este método requer acesso à Internet na máquina intermediária a partir da qual você carrega os artefatos do Automation Suite para seu registro compatível com OCI.

Pré-requisitos para espelhar o registro da UiPath®

Para espelhar o registro da UiPath®, você precisa do seguinte:

• uma VM executando uma distribuição Linux (recomendada) ou um laptop (não recomendado)
• um cliente Docker autenticado com o registro privado
• Helm 3.8 ou mais recente autenticado com o registro privado
• as-images.txt
• as-helm-charts.txt
• mirror-registry.sh
• conectividade de saída para registry.uipath.com
• 128 GB de espaço livre em disco para o Docker na partição /var/lib/docker na máquina a partir da qual você carrega as imagens e gráficos do contêiner

Instalando o Docker e o Helm

Você deve ter o Docker e o Helm instalados e autenticados na máquina na qual planeja carregar as imagens e gráficos do contêiner do Automation Suite para seu registro.

• Para baixar os binários do Docker, consulte a documentação oficial.
• Para autenticar o registro do Docker, consulte a documentação oficial. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  docker login my.registry.io:443 --username "admin" --password "secret"
  

• Para baixar os binários do Helm, consulte a documentação oficial.
• Para autenticar o registro do Helm, consulte a documentação oficial. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  helm registry login my.registry.io:443 --username "admin" --password "secret"
  

Download dos artefatos

Baixe os seguintes artefatos antes de prosseguir:

• as-images.txt consulte Como baixar os pacotes de instalação
• as-helm-charts.txt consulte Como baixar os pacotes de instalação
• mirror-registry.sh consulte Como baixar os pacotes de instalação
• Pacotes opcionais do Document Understanding: consulte a documentação clássica do Document Understanding ou a documentação do Document Understanding

Como carregar as imagens do Automation Suite para seu registro

O script mirror-registry.sh requer conectividade de saída para os registros de origem (padrão registry.uipath.com) e de destino.

Observação:

O script mirror-registry.sh não executa a autenticação para o registro. Assume-se que você já tenha se autenticado no registro.

A tabela a seguir descreve os sinalizadores disponíveis para o script mirror-registry.sh .

Bandeira	Variável de ambiente	Required	Description
--images-manifest	IMAGES_MANIFEST	Sim	Caminho para o arquivo de manifesto de imagem.
--helm-charts-manifest	HELM_CHARTS_MANIFEST	Sim	Caminho para o arquivo de manifesto do gráfico do Helm.
--target-registry-url	TARGET_REGISTRY_URL	Sim	URL do registro de destino.
--source-registry-url	SOURCE_REGISTRY_URL	Não	URL do registro de origem. O padrão é registry.uipath.com.

Para carregar as imagens do Automation Suite para seu registro:

1. Certifique-se de ter as permissões necessárias para executar o script de shell, executando o seguinte comando:

   chmod +x mirror-registry.sh
   

2. Carregue as imagens do Automation Suite para seu registro, executando o seguinte comando:

   ./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
   

   Para registros como o Harbor, que exigem um projeto, anexe o nome do projeto à URL do registro de destino:

   ./mirror-registry.sh --target-registry-url my.registry.io:443/myproject --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
   

Opção B: hidratar o registro com o pacote offline

Este método requer apenas acesso à Internet na máquina intermediária para baixar o pacote offline. Quando o pacote estiver disponível, você poderá carregar para seu registro compatível com OCI sem uma conexão com a Internet.

Observação:

Esse método também pode exigir espaço adicional na máquina para descompactar e carregar para seu registro. Além disso, esse método pode levar mais tempo que a abordagem de espelhamento.

Pré-requisitos para o preenchimento do registro

Para popular o registro, você precisa do seguinte:

• é preferível uma VM executando uma distribuição Linux a executar o script em um laptop
• capacidade de baixar e copiar ou de alguma forma propagar o pacote offline para a VM
• Helm 3.8 ou mais recente autenticado com o registro privado
• Podman instalado, configurado e autenticado com o registro privado
• 150 GB de espaço livre em disco para o Podman sob o /var/lib/containers para carregar os contêineres localmente antes de enviá-los para o registro remoto. Se você precisar alterar o caminho padrão, atualize a variável graphRoot no arquivo /etc/containers/storage.conf . Por exemplo, você pode editar storage.conf usando sudo nano /etc/containers/storage.conf, alterar graphRoot para seu novo caminho e, em seguida, verificar se o caminho está atualizado usando o comando podman info .
• Defina a TMP_DIR variável de ambiente conforme descrito na documentação oficial do Podman. Essa variável especifica o armazenamento temporário para imagens de contêiner baixadas durante operações de pull e build, cruciais para evitar erros de falta de espaço se /var/tmp for limitado.
• as-cmk.tar.gz

Instalação do Podman e do Helm

Você deve se certificar de ter o Podman e o Helm instalados e autenticados na máquina na qual planeja carregar as imagens e gráficos do contêiner do Automation Suite para o seu registro.

• Para baixar os binários do Podman, consulte a documentação oficial.
• Para se autenticar no registro do Podman, consulte a documentação oficial. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  podman login my.registry.io:443 --username "admin" --password "secret"
  

• Para baixar os binários do Helm, consulte a documentação oficial.
• Para autenticar o registro do Helm, consulte a documentação oficial. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  helm registry login my.registry.io:443 --username "admin" --password "secret"
  

Download dos artefatos

Baixe os seguintes artefatos antes de prosseguir:

• as-cmk.tar.gz consulte Como baixar os pacotes de instalação
• hydrate-registry.sh consulte Como baixar os pacotes de instalação
• Pacotes opcionais do Document Understanding: consulte a documentação clássica do Document Understanding ou a documentação do Document Understanding

Como carregar as imagens do Automation Suite para o registro

Para carregar as imagens do Automation Suite para o registro, use o script hydrate-registry.sh .

O script hydrate-registry.sh não requer conectividade de saída, exceto com os registros de destino.

Observação:

O script hydrate-registry.sh não executa a autenticação para o registro. Assume-se que você já tenha se autenticado no registro.

A tabela a seguir descreve os sinalizadores disponíveis para o script hydrate-registry.sh .

Bandeira	Required	Description
--offline-bundle-path	Sim	Caminho para o pacote offline.
--target-registry-url	Sim	URL do registro de destino.
--extract-path	Sim	O local a ser usado para descompactar o pacote offline. Pode ser /var/lib/containers ou um local personalizado. Certifique-se de ter no mínimo 100 GB de armazenamento. É recomendável ter 256 GB de armazenamento.

Para carregar as imagens do Automation Suite para o registro:

1. Certifique-se de ter as permissões necessárias para executar o script de shell, executando o seguinte comando:

   chmod +x hydrate-registry.sh
   

2. Carregue as imagens do Automation Suite para seu registro executando o seguinte comando:

   ./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path /path/to/as-cmk.tar.gz --extract-path /tmp
   

   Para registros como o Harbor, que exigem um projeto, anexe o nome do projeto à URL do registro de destino:

   ./hydrate-registry.sh --target-registry-url my.registry.io:443/myproject --offline-bundle-path /path/to/as-cmk.tar.gz
   

   Para pacotes offline do Document Understanding, certifique --extract-path se de incluir no comando:

   ./hydrate-registry.sh --target-registry-url my.registry.io:443 --optional-bundle-path ./dusemistructured-2023.10.0.tar.gz --extract-path /tmp
   

Configuração do certificado para o registro externo compatível com OCI

Para configurar corretamente seu registro externo compatível com OCI, você deve atualizar o armazenamento de confiança de todas as máquinas nas quais você planeja instalar o Automation Suite. Para obter instruções sobre como realizar essa etapa pós-instalação, consulte Gerenciamento de certificados.