[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["Prepare an offline installation of Cloud Service Mesh\n\nThis page explains how to prepare offline installations of Cloud Service Mesh on\n[supported platforms](/service-mesh/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/docs/overview).\n\nWhen running the `asmcli` tool to\n[install Cloud Service Mesh](/service-mesh/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\nBefore you begin, make sure that you:\n\n- Review [the prerequisites](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/cloud-service-mesh-prerequisites).\n- Review the information in [Plan the install](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/plan-install).\n- [Install the required tools](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#install_required_tools).\n- [Download `asmcli`](/service-mesh/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\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/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- Learn about [setting up a multi-cluster mesh outside of Google Cloud](/service-mesh/docs/operate-and-maintain/off-gcp-multi-cluster-setup).\n\n- [Configure an external IP address on-premises](/service-mesh/docs/operate-and-maintain/external-ip-load-balance).\n\n- [Deploy the Online Boutique sample application](/service-mesh/docs/onlineboutique-install-kpt)."]]