이 페이지에서는 Google Cloud기반 GKE 이외의 지원 플랫폼에서 Cloud Service Mesh의 오프라인 설치를 준비하는 방법을 설명합니다.
asmcli 도구를 실행하여 Cloud Service Mesh를 설치할 때는 로컬 디렉터리를 사용하여 구성 및 아티팩트를 저장합니다. 기본적으로 도구를 실행하면 임시 디렉터리가 생성됩니다. 하지만 명령줄에서 --output_dir 옵션을 사용하여 디렉터리를 지정할 수 있습니다. 필요한 구성 및 아티팩트가 있는 디렉터리가 이미 있는 경우 다시 다운로드하지 않고 재사용됩니다.
Cloud Service Mesh의 오프라인 설치를 수행하려면 인터넷 액세스 권한이 있는 머신에서 구성 패키지를 생성한 다음 인터넷 액세스 없이 다른 머신에 해당 패키지를 배포하면 됩니다. 그런 다음 asmcli build-offline-package 하위 명령어를 사용하여 구성 패키지를 생성합니다.
[[["이해하기 쉬움","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(UTC)"],[],[],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)."]]