A atualização de artefatos do sistema no dispositivo com isolamento físico do Google Distributed Cloud (GDC) permite gerenciar e refinar sua implantação. É possível fazer upload de imagens de contêiner modificadas para o System Artifact Registry, gerenciar pacotes da Open Container Initiative (OCI) e aplicar patches em pacotes de lançamento locais.
Antes de começar
Para modificar artefatos do sistema, você precisa receber acesso de diagnóstico e ter acesso aos papéis de identidade e acesso necessários:
- O acesso de diagnóstico é um modo de acesso privilegiado necessário para oferecer suporte seguro a um cliente quando ele encontra um problema. Você precisa criar um tíquete para receber esse acesso.
- Depurador do System Artifact Registry: tem acesso de leitura e gravação a todos os recursos do Harbor. Peça ao administrador de segurança para conceder a você o papel de cluster de depurador do Artifact Registry do sistema (
sar-debugger). - Depurador de secret do harbor-system do Artifact Registry do sistema: tem acesso de depurador no namespace
harbor-system. Peça ao administrador de segurança para conceder a você o papel de depurador de secrets do sistema do Artifact Registry (sar-harbor-system-secret-debugger).
Fazer upload de imagens Docker
Para modificar artefatos do sistema, faça upload de novas imagens Docker. O método de upload depende de qual dos dois registros a seguir você envia as imagens de contêiner:
- Faça upload de imagens de contêiner para o Artifact Registry na máquina de inicialização.
- Faça upload de imagens de contêiner para o Artifact Registry no cluster de infraestrutura da organização.
As seções a seguir mostram as instruções de upload para os dois tipos de registro.
Fazer upload da imagem do contêiner na máquina de inicialização
Para fazer upload de imagens de contêiner para o Artifact Registry na máquina de inicialização, siga estas etapas:
Verifique se você tem a imagem Docker modificada com os problemas de falha corrigidos.
Transfira a nova imagem para o nó de inicialização no ambiente do GDC.
Faça login no nó de inicialização.
Localize o endereço do Artifact Registry na máquina de inicialização no momento da inicialização e defina-o como a variável de ambiente
REGISTRY_IP:REGISTRY=$(kubectl get harborcluster harbor -n harbor-system -o=jsonpath='{.spec.externalURL}') REGISTRY_IP=${REGISTRY#https://}Recupere a credencial para acessar o Artifact Registry. Recupere a conta de administrador e a senha:
ADMIN_PASS=$(kubectl -n harbor-system get secret harbor-admin \ -o jsonpath="{.data.secret}" | base64 -d)Faça login no Artifact Registry:
docker login $REGISTRY_IP -u admin -p $ADMIN_PASSUma mensagem
Login Succeededé exibida para verificar se o login no Artifact Registry foi concluído.Marque a nova imagem:
docker image tag CONTAINER_IMAGE_URL \ $REGISTRY_IP/PROJECT_NAME/IMAGE_NAME:TAGSubstitua:
CONTAINER_IMAGE_URL: o URL da imagem do contêiner local, comogcr.io/repository/image:tag.PROJECT_NAME: o nome do projeto do Artifact Registry.IMAGE_NAME: o nome da imagem do contêiner.TAG: a tag da imagem do contêiner.
Envie a nova imagem para o Artifact Registry:
docker image push $REGISTRY_IP/PROJECT_NAME/IMAGE_NAME:TAG
Fazer upload da imagem do contêiner para o cluster de infraestrutura da organização
Para fazer upload de imagens de contêiner para o Artifact Registry em um cluster de infraestrutura da organização, siga estas etapas:
Verifique se você tem a imagem Docker modificada com os problemas de falha corrigidos.
Transfira a nova imagem para um nó que tenha acesso raiz com um arquivo
kubeconfigraiz para o cluster de infraestrutura da organização no ambiente com isolamento físico.Exporte o caminho do cluster de infraestrutura da organização
kubeconfigcomo uma variável de ambiente:export ORG_INFRA_KUBECONFIG=KUBECONFIG_FILE_PATHSubstitua
KUBECONFIG_FILE_PATHpelo caminho para o arquivokubeconfig.Localize o endereço do Artifact Registry no cluster e defina-o como a variável de ambiente
REGISTRY_IP:REGISTRY=$(kubectl --kubeconfig $ORG_INFRA_KUBECONFIG get harborcluster / harbor -n harbor-system -o=jsonpath='{.spec.externalURL}') REGISTRY_IP=${REGISTRY#https://}Verifique se o
REGISTRY_IPcontém um URL válido, como10.200.0.36:10443:echo ${REGISTRY_IP}Verifique se o certificado da autoridade certificadora (CA) existe:
ls -al /etc/docker/certs.d/${REGISTRY_IP}/ca.crtSe o certificado não existir, crie e configure-o:
mkdir -p /etc/docker/certs.d/${REGISTRY_IP}/ chmod 755 /etc/docker/certs.d/${REGISTRY_IP}/ echo $(kubectl get secret harbor-cert-secret -n istio-system -o jsonpath='{.data.ca\.crt}' --kubeconfig $ORG_INFRA_KUBECONFIG) | openssl base64 -A -d > /etc/docker/certs.d/${REGISTRY_IP}/ca.crt chmod 755 /etc/docker/certs.d/${REGISTRY_IP}/ca.crtRecupere a credencial para acessar o Artifact Registry. Use o comando a seguir para recuperar a conta de administrador e a senha:
ADMIN_PASS=$(kubectl --kubeconfig $ORG_INFRA_KUBECONFIG \ -n harbor-system get secret harbor-admin \ -o jsonpath="{.data.secret}" | base64 -d)Faça login no Artifact Registry:
docker login $REGISTRY_IP -u admin -p $ADMIN_PASSUma mensagem
Login Succeededé exibida para verificar se o login no Artifact Registry foi concluído.Marque a nova imagem:
docker image tag CONTAINER_IMAGE_URL \ $REGISTRY_IP/PROJECT_NAME/IMAGE_NAME:TAGSubstitua:
CONTAINER_IMAGE_URL: o URL da imagem do contêiner local, comogcr.io/repository/image:tag.PROJECT_NAME: o nome do projeto do Artifact Registry.IMAGE_NAME: o nome da imagem do contêiner.TAG: a tag da imagem do contêiner.
Envie a nova imagem para o Artifact Registry:
docker image push $REGISTRY_IP/PROJECT_NAME/IMAGE_NAME:TAG
Modificar artefatos do sistema
Use os comandos gdcloud artifacts para modificar artefatos do sistema no GDC. Atualize, personalize e proteja sua implantação realizando ações como substituir pacotes de software, ajustar configurações e aplicar patches.
Execute estas ações:
- Gerenciar pacotes do
apt. - Crie e extraia imagens de pacotes OCI.
- Liste as versões disponíveis da imagem OCI raiz.
- Aplique patches em pacotes atuais.
- Extrair e enviar pacotes OCI de e para um registro.
- Exibir a estrutura de um pacote OCI.
- Descompacte os pacotes OCI.
Para ver mais informações, consulte gdcloud artifacts.