删除大型数据共享 Go Web 应用

Last reviewed 2023-06-27 UTC

本指南介绍如何删除大型数据共享 Go Web 应用快速起步解决方案。您可以使用本指南删除解决方案的现有部署。

您无法再通过 Google Cloud 控制台部署大型数据共享 Go Web 应用，并且该应用也不受支持。

费用

如需估算大型数据共享 Go Web 应用解决方案使用的 Google Cloud 资源的费用，请参阅 Google Cloud 价格计算器中预先计算的估算值。

使用估算值作为起点来计算部署费用。您可以修改估算值，以反映您对解决方案中使用的资源所做的任何配置更改。

系统会基于某些因素（包括以下因素）做出预先计算的估算：

  • 部署资源的 Google Cloud 位置。
  • 资源的使用时间。

您还可以查看已部署资源的使用费。如需了解详情，请参阅查看您的结算报告和费用趋势。

获取所需的 IAM 权限

如需删除现有部署，您需要下表中列出的 Identity and Access Management (IAM) 权限。如果您拥有部署了解决方案的项目的 roles/owner 基本角色，则您已经拥有所有必要的权限。如果您没有 roles/owner 角色，请让管理员授予您这些权限（或包含这些权限的角色）。

所需的 IAM 权限 包含所需权限的预定义角色

serviceusage.services.enable

 Service Usage Admin
(roles/serviceusage.serviceUsageAdmin)

iam.serviceAccounts.create

 Service Account Admin
(roles/iam.serviceAccountAdmin)

resourcemanager.projects.setIamPolicy

 Project IAM Admin
(roles/resourcemanager.projectIamAdmin)
config.deployments.create
config.deployments.list		 Cloud Infrastructure Manager Admin
(roles/config.admin)

为解决方案创建的服务账号

通过控制台启动删除过程时，系统会创建一个服务账号，用于代表您部署解决方案（以及稍后删除部署 [如果您选择删除部署]）。系统会临时为此服务账号分配某些 IAM 权限；也就是说，在解决方案部署和删除操作完成后，会自动撤消这些权限。Google 建议您在删除部署后删除服务账号，如本指南后面部分所述。

查看分配给服务账号的角色

此处列出了这些角色，以防 Google Cloud 项目或组织的管理员需要此信息。

  • roles/storage.admin
  • roles/datastore.owner
  • roles/appengine.appAdmin
  • roles/compute.admin
  • roles/compute.networkAdmin
  • roles/cloudtrace.admin
  • roles/iam.serviceAccountUser
  • roles/run.admin
  • roles/monitoring.admin
  • roles/vpcaccess.admin

删除部署

如果不再需要解决方案部署，为避免继续为创建的资源计费，请删除部署。

删除项目

如果您在新的 Google Cloud 项目中部署了解决方案，但不再需要该项目，请完成以下步骤来将其删除：

  1. 在 Google Cloud 控制台中，进入管理资源页面：

    打开“管理资源”

  2. 在项目列表中，选择要删除的项目，然后点击删除。
  3. 在提示符处，输入项目 ID，然后点击关停。

如果您决定保留项目，请删除为此解决方案创建的服务账号，如下一部分所述。

通过控制台删除

如果您通过控制台删除解决方案部署，则 Firestore 数据库不会被删除。如需删除此数据库，请按照上文所述删除项目。

如果您通过控制台部署了解决方案，请按以下流程操作。

  1. 在 Google Cloud 控制台中，转到解决方案部署页面。

    转到“解决方案部署”

  2. 选择您要删除的部署所在的项目。

  3. 找到您要删除的部署。

  4. 在部署对应的行中，点击 操作，然后选择删除。

    您可能需要向下滚动才能看到该行中的操作。

  5. 输入部署的名称，然后点击确认。

    状态字段显示正在删除。

    如果删除失败，请参阅删除部署时出错中的问题排查指南。

如果您不再需要用于此解决方案的 Google Cloud 项目，则可以删除该项目。如需了解详情，请参阅可选：删除项目。

使用 Terraform CLI 进行删除

如果您使用 Terraform CLI 删除解决方案部署，则 Firestore 数据库不会被删除。如需删除此数据库，请按照上文所述删除项目。

如果您使用 Terraform CLI 部署了解决方案，请按照以下步骤操作。

  1. 在 Cloud Shell 中，确保当前工作目录为 $HOME/cloudshell_open/terraform-large-data-sharing-golang-webapp/infra。如果不是，请转到该目录。

  2. 移除 Terraform 预配的资源：

    terraform destroy

    Terraform 会显示将被销毁的资源列表。

  3. 当系统提示您执行操作时，请输入 yes。

    Terraform 会显示显示进度的消息。删除所有资源后，Terraform 将显示以下消息：

    Destroy complete!

    如果删除失败，请参阅删除部署时出错中的问题排查指南。

如果您不再需要用于此解决方案的 Google Cloud 项目，则可以删除该项目。如需了解详情，请参阅可选：删除项目。

可选：删除服务账号

如果删除了用于解决方案的项目，请跳过此部分。

如本指南前面部分所述，当您部署解决方案时，系统代表您创建了一个服务账号。系统为服务账号临时分配了某些 IAM 权限；也就是说，在解决方案的部署和删除操作完成后，系统会自动撤消这些权限，但不会删除服务账号。Google 建议您删除此服务账号。

  • 如果您通过 Google Cloud 控制台部署了解决方案，请进入解决方案部署页面。（如果您已进入该页面，请刷新浏览器。）系统会在后台触发进程来删除服务账号。无需进一步操作。

  • 如果您使用 Terraform CLI 部署了解决方案，请完成以下步骤：

    1. 在 Google Cloud 控制台中，转到服务账号页面。

      转到“服务账号”

    2. 选择您用于解决方案的项目。

    3. 选择要删除的服务账号。

      为解决方案创建的服务账号的电子邮件 ID 采用以下格式：

      goog-sc-DEPLOYMENT_NAME-NNN@PROJECT_ID.iam.gserviceaccount.com

      电子邮件 ID 包含以下值：

      • DEPLOYMENT_NAME：部署的名称。
      • NNN：随机 3 位数。
      • PROJECT_ID：部署了解决方案的项目的 ID。

    4. 点击删除。

排查错误

可以诊断和解决错误的操作取决于部署方法和错误的复杂程度。

删除部署时出错

在某些情况下，尝试删除部署可能会失败：

  • 通过控制台部署解决方案后，如果您更改此解决方案预配的任何资源，然后尝试删除部署，则删除操作可能会失败。解决方案部署页面上的状态字段会显示失败，并且 Cloud Build 日志会显示错误原因。
  • 使用 Terraform CLI 部署解决方案后，如果您使用非 Terraform 界面（例如控制台）更改任何资源，然后尝试删除部署，则删除操作可能会失败。terraform destroy 命令输出中的消息会显示错误的原因。

查看错误日志和消息，找出并删除导致错误的资源，然后再次尝试删除部署。

如果基于控制台的部署未删除，并且您无法使用 Cloud Build 日志诊断错误，则可以使用 Terraform CLI 删除该部署，如下一部分所述。

使用 Terraform CLI 删除基于控制台的部署

本部分介绍在尝试通过控制台删除基于控制台的部署出错时如何删除该部署。在此方法中，您可以下载要删除的部署的 Terraform 配置，然后使用 Terraform CLI 删除部署。

  1. 确定部署的 Terraform 代码、日志和其他数据的存储区域。此区域可能与您在部署解决方案时选择的区域不同。

    1. 在 Google Cloud 控制台中，转到解决方案部署页面。

      转到“解决方案部署”

    2. 选择您要删除的部署所在的项目。

    3. 在部署列表中，找到要删除的部署所在的行。

    4. 点击 查看所有行内容。

    5. 在位置列中，记下第二个位置，如以下示例中突出显示部分所示：

      部署代码、日志和其他工件的位置。

  2. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  3. 为要删除的部署的项目 ID、区域和名称创建环境变量：

    export REGION="REGION"
export PROJECT_ID="PROJECT_ID"
export DEPLOYMENT_NAME="DEPLOYMENT_NAME"

    在这些命令中，替换以下内容：

    • REGION：您先前在此过程中记下的位置。
    • PROJECT_ID：您在其中部署解决方案的项目的 ID。
    • DEPLOYMENT_NAME：您要删除的部署的名称。

  4. 获取您要删除的最新修订版本部署的 ID：

    export REVISION_ID=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .latestRevision -r)
    echo $REVISION_ID

    输出类似于以下内容：

    projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME/revisions/r-0

  5. 获取该部署的 Terraform 配置的 Cloud Storage 位置：

    export CONTENT_PATH=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/${REVISION_ID}" \
    | jq .applyResults.content -r)
    echo $CONTENT_PATH

    以下是此命令的输出示例：

    gs://PROJECT_ID-REGION-blueprint-config/DEPLOYMENT_NAME/r-0/apply_results/content

  6. 将 Terraform 配置从 Cloud Storage 下载到 Cloud Shell：

    gcloud storage cp $CONTENT_PATH $HOME --recursive
cd $HOME/content/infra

    等到系统显示 Operation completed 消息，如以下示例所示：

    Operation completed over 45 objects/268.5 KiB

  7. 初始化 Terraform：

    terraform init

    等待系统显示以下消息：

    Terraform has been successfully initialized!

  8. 移除已部署的资源：

    terraform destroy

    Terraform 会显示将被销毁的资源列表。

    如果显示的警告与未声明变量有关，请忽略这些警告。

  9. 当系统提示您执行操作时，请输入 yes。

    Terraform 会显示显示进度的消息。删除所有资源后，Terraform 将显示以下消息：

    Destroy complete!

  10. 删除部署工件：

    curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}?force=true&delete_policy=abandon"

  11. 等待几秒钟，然后验证部署工件是否已删除：

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .error.message

    如果输出显示 null，请等待几秒钟，然后再次运行该命令。

    删除部署工件后，系统会显示一条如以下示例所示的消息：

    Resource 'projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME' was not found

后续步骤