[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-19。"],[[["\u003cp\u003eInfra Manager uses deployments to provision Google Cloud resources to multiple locations and projects, with each deployment creating a storage bucket containing artifacts like Cloud Build and Terraform logs, and a copy of the Terraform configuration.\u003c/p\u003e\n"],["\u003cp\u003eDeployments and their revisions, which are versions of a deployment, have specific naming formats that include the project ID, location, and a user-specified identifier, with the revision ID being auto-incremented by Infra Manager.\u003c/p\u003e\n"],["\u003cp\u003ePreviews are used to describe and verify the actions to actuate a specific Terraform configuration before creating or updating a deployment, storing metadata in a designated storage bucket.\u003c/p\u003e\n"],["\u003cp\u003eThe Deployment ID and the Preview ID must contain only lowercase letters, numbers, or hyphens; start with a lowercase letter; end with a number or lowercase letter; and be unique within the project and location where the Infra Manager is run.\u003c/p\u003e\n"]]],[],null,["# Deployments, revisions, and previews overview\n\nThis page describes deployments and revisions, including the following:\n\n- List of metadata stored for each deployment.\n- The format of the deployment name and revision name.\n\nDeployments\n-----------\n\nInfra Manager provisions resources onto Google Cloud as a deployment.\n\nA deployment can provision Google Cloud resources to multiple locations and\nto multiple projects. Note that:\n\n- The specific resources need to be available in the locations. For example, see [Cloud Run locations](/run/docs/locations) for the list of locations where Cloud Run is available.\n- The service account must have the permissions that are required to deploy to the specified projects. For details, see [Configure the service account](/infrastructure-manager/docs/configure-service-account).\n\n### Deployment metadata\n\nInfra Manager creates a storage bucket in the project and location\nwhere Infra Manager is run. After the deployment is created, the\nInfrastructure Manager artifacts are in this storage bucket which has the name:\n`gs://`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e`-blueprint-config`.\n\nInfra Manager uses the term *blueprint* to refer to a\nTerraform configuration.\n\nWhere you replace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the project ID where Infra Manager is run.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the location where Infra Manager is run.\n\nThe deployment artifacts in the storage bucket include:\n\n- Cloud Build logs.\n- Terraform logs.\n- A copy of the Terraform configuration.\n\nInfra Manager also stores a copy of the Terraform state file. For\ndetails about the state file, including accessing the file, see\n[Manage the Terraform state file](/infrastructure-manager/docs/state-file).\n\nRevisions are versions of a deployment, so Infra Manager stores\nthis deployment metadata for each revision.\n\n### Deployment name\n\nThe format of the deployment name is: \n\n projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e/deployments/\u003cvar translate=\"no\"\u003eDEPLOYMENT_ID\u003c/var\u003e\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the project ID where Infra Manager runs.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the location where Infra Manager runs. See [Infrastructure Manager locations](/infrastructure-manager/docs/locations) for the list of valid locations.\n- \u003cvar translate=\"no\"\u003eDEPLOYMENT_ID\u003c/var\u003e is the deployment identifier, and is a user-specified name. This name must:\n - Contain only lowercase letters, numbers, or hyphens.\n - Start with a lowercase letter.\n - End with a number or lowercase letter\n - Cannot be the string `archived-deployments` or `archived-previews`\n - Must be unique within the project and location where Infra Manager is run.\n\nFor example: \n\n projects/my-project/locations/us-central1/deployments/my-deployment\n\nRevisions\n---------\n\nRevisions are versions of a deployment. When you initially create a\ndeployment, this deployment is also a revisions and has the revision ID `r-0`.\n\n### Revision name\n\nWhen you create an Infra Manager deployment, it is automatically given the\nrevision identifier `r-0`. If you update the deployment, then Infrastructure Manager\ncreates a new revision with identifier `r-1`. For every new revision,\nthe identifier increases by one. The revision identifier can only be set\nby Infrastructure Manager.\n\nFor example, a revision name could be: \n\n projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1\n\nPreviews\n--------\n\nA preview describes the actions to actuate a specific Terraform configuration.\nBefore you create a new deployment or update a deployment, you can preview\nthe deployment to verify the resources that are planned to be provisioned.\n\n### Preview metadata\n\nInfra Manager creates a storage bucket in the project and location\nwhere Infra Manager is run. After the preview is created, the Infra Manager artifacts are in this storage bucket which has the name:\n`gs://`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e`-blueprint-config`.\n\nFor a preview of a new deployment, the metadata is organized with a\n`new-previews` prefix, for example:\n`gs://`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e`-blueprint-config/new-previews/preview-name`\n\nYou can also preview an update to an existing deployment. For these previews\ntargeting an existing deployment, the artifacts are stored in the same storage\nbucket as the deployment artifacts. The storage bucket which has the name:\n`gs://`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e`-blueprint-config/deployment-ID/previews/preview-ID`.\n\nInfra Manager uses the term *blueprint* to refer to a Terraform configuration.\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: : the project ID where Infra Manager is run.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: : the location where Infra Manager is run.\n\nThe preview artifacts in the storage bucket include:\n\n- Cloud Build logs.\n- Terraform logs.\n- A copy of the Terraform configuration.\n\n### Preview name\n\nThe format of the preview name is: \n\n projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e/previews/\u003cvar translate=\"no\"\u003ePREVIEW_ID\u003c/var\u003e\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the project ID where Infra Manager runs.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the location where Infra Manager runs. See [Infrastructure Manager locations](/infrastructure-manager/docs/locations) for the list of valid locations.\n- \u003cvar translate=\"no\"\u003ePREVIEW_ID\u003c/var\u003e is the deployment identifier, and is a user-specified name. This name must:\n - Contain only lowercase letters, numbers, or hyphens.\n - Start with a lowercase letter.\n - End with a number or lowercase letter\n - Cannot be the string `archived-deployments` or `archived-previews`\n - Must be unique within the project and location where Infra Manager is run.\n\nFor example: \n\n projects/my-project/locations/us-central1/previews/my-preview\n\nWhat's next\n-----------\n\n- Learn more about [Terraform with Google Cloud](/docs/terraform).\n- [Create a deployment](/infrastructure-manager/docs/deploy-resources).\n- [Update a deployment](/infrastructure-manager/docs/update-deployment).\n- [View the state of a deployment](/infrastructure-manager/docs/view-deployments).\n- [Delete a deployment](/infrastructure-manager/docs/delete-deployments)."]]