Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Preparar uma instalação off-line do Cloud Service Mesh
Nesta página, explicamos como preparar instalações off-line do Cloud Service Mesh em
plataformas compatíveis além do
GKE no Google Cloud.
Ao executar a ferramenta asmcli para
instalar o Cloud Service Mesh,
ela usa um diretório local para armazenar configuração e artefatos. Por padrão, um
diretório temporário é criado ao executar a ferramenta. No entanto, é possível especificar
um diretório usando a opção --output_dir na linha de comando. Se o
diretório já existir com a configuração e os artefatos necessários, eles
serão reutilizados, e não será necessário fazer o download deles novamente.
Para realizar uma instalação off-line do Cloud Service Mesh, é possível gerar um
pacote de configuração em uma máquina com acesso à Internet e depois distribuí-lo
a outras máquinas sem acesso à Internet. Em seguida, use o subcomando
asmcli build-offline-package para gerar pacotes de configuração.
Durante a instalação, verifique se é possível
acessar as APIs e serviços do Google
ou ative manualmente as dependências necessárias. Mesmo no modo
off-line, o asmcli usa o Google Cloud CLI para ativar algumas dependências se a
flag correspondente for transmitida durante a instalação.
Instalação off-line do Cloud Service Mesh
Confira a seguir como preparar uma instalação off-line do Cloud Service Mesh:
Na máquina com acesso à Internet em que você instalou o Cloud Service Mesh,
crie um pacote e depois salve-o na pasta
OFFLINE_PKG_DIR_PATH:
Copie o diretório de configuração e a ferramenta asmcli na máquina off-line.
Siga as instruções normais de
instalação do Cloud Service Mesh.
Quando as instruções especificarem a execução de asmcli install, transmita
também a flag --offline e especifique o diretório de configuração
criado nas etapas anteriores:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[],[],null,["# Prepare an offline installation of Cloud Service Mesh\n=====================================================\n\nThis page explains how to prepare offline installations of Cloud Service Mesh on\n[supported platforms](/service-mesh/v1.25/docs/supported-platforms) other than\nGKE on Google Cloud.\n| **Note:** This guide only supports Cloud Service Mesh with Istio APIs and does not support Google Cloud APIs. For more information see, [Cloud Service Mesh overview](/service-mesh/v1.25/docs/overview).\n\nWhen running the `asmcli` tool to\n[install Cloud Service Mesh](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/install-in-cluster-cloud-service-mesh),\nit uses a local directory to store configuration and artifacts. By default, a\ntemporary directory is created when executing the tool. However, you can specify\na directory using the `--output_dir` option on the command line. If the\ndirectory already exists with the necessary configuration and artifacts, they\nwill be reused instead of re-downloading anything.\n\nTo perform an offline installation of Cloud Service Mesh, you can generate a\nconfiguration package on a machine with Internet access, and then distribute\nthat package to other machines without internet access. Then, use the subcommand\n`asmcli build-offline-package` to generate configuration packages.\n\nBefore you begin\n----------------\n\nBefore you begin, make sure that you:\n\n- Review [the prerequisites](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/cloud-service-mesh-prerequisites).\n- Review the information in [Plan the install](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/plan-install).\n- [Install the required tools](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#install_required_tools).\n- [Download `asmcli`](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#download_asmcli).\n- During installation, ensure access to [Google APIs and Services](/vpc/docs/configure-private-google-access-hybrid) is possible, or manually enable the required dependencies. Even in offline mode, `asmcli` uses Google Cloud CLI to enable some dependencies if the corresponding flag is passed during installation.\n\nOffline installation of Cloud Service Mesh\n------------------------------------------\n\nThe following outlines how to prepare an offline installation of Cloud Service Mesh:\n\n1. On the machine with Internet access that you installed Cloud Service Mesh,\n create a package and then save it to the folder\n \u003cvar translate=\"no\"\u003eOFFLINE_PKG_DIR_PATH\u003c/var\u003e:\n\n ./asmcli build-offline-package \\\n --output_dir \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nx\"\u003eOFFLINE_PKG_DIR_PATH\u003c/span\u003e\u003c/var\u003e\n\n | **Note:** The `offline-package` includes critical hidden files. You must copy all of the files to the offline machine. To avoid missing files, create an archive bundle of the entire `output_dir` and copy it to the offline machine.\n2. Copy the configuration directory and `asmcli` tool to the offline machine.\n\n3. Follow the normal instructions for\n [installing Cloud Service Mesh](/service-mesh/v1.25/docs/onboarding/kubernetes-off-gcp/install/install-in-cluster-cloud-service-mesh).\n Wherever the instructions specify to run `asmcli install`, ensure that you\n also pass the `--offline` flag and specify the configuration directory\n created in the previous steps:\n\n ./asmcli install \\\n --output_dir \u003cvar translate=\"no\"\u003eOFFLINE_PKG_DIR_PATH\u003c/var\u003e \\\n --project_id \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --cluster_location \u003cvar translate=\"no\"\u003eCLUSTER_LOCATION\u003c/var\u003e \\\n --cluster_name \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e \\\n --offline\n\nWhat's next?\n------------\n\n- Learn about [setting up a multi-cluster mesh outside of Google Cloud](/service-mesh/v1.25/docs/operate-and-maintain/off-gcp-multi-cluster-setup).\n\n- [Configure an external IP address on-premises](/service-mesh/v1.25/docs/operate-and-maintain/external-ip-load-balance).\n\n- [Deploy the Online Boutique sample application](/service-mesh/v1.25/docs/onlineboutique-install-kpt)."]]