1. 简介
在此 Codelab 中,您将在 Google Cloud 上构建和部署 gCurrenC 计算器 Web 应用,然后保护该应用免遭不必要的访问。您将使用 Google Antigravity、Google Cloud Developer 插件和 Developer Knowledge (DK) MCP 服务器,设计并实现一个安全架构,以控制哪些人可以访问应用,并保护应用免遭未经授权的使用。
在本实验中,您会将 Google Antigravity 连接到 DK MCP 服务器,从而使 Antigravity 能够基于官方、实时的 Google Cloud 文档提供回答。Antigravity 不依赖静态训练数据或过时的模型权重,而是动态检索当前架构模式、最新 gcloud CLI 语法和安全参数,从而减少幻觉,并根据最新知识提供回答。
构建内容
- 私有计算工作负载:两个 Compute Engine 虚拟机 (VM),在没有公共 IP 地址的自定义 Virtual Private Cloud (VPC) 网络中运行 gCurrenC 计算器 Web 应用。
- 安全的入站流量流水线:全球外部应用负载均衡器,具有专用的代理专用子网,可通过 Google Front End (GFE) 将网络流量路由到您的私有虚拟机,而无需将其公开到公共网络。
- 安全出站流水线:Cloud Router 和 Cloud NAT 网关,与项目级 Cloud Next Generation Firewall (Cloud NGFW) Enterprise 和 Certificate Authority Service (CAS) 搭配使用,可对出站 HTTPS 货币兑换 API 流量执行实时 TLS 检查和入侵防御服务 (IPS) 扫描。
学习内容
- 使用 Antigravity CLI 安装
google-cloud-developer插件,并在 Antigravity 中配置 DK MCP 服务器。 - 使用 Identity-Aware Proxy (IAP) TCP 转发,在 Compute Engine 上部署和测试隔离的私有 Web 应用。
- 在 Antigravity 中使用基于事实的多轮提示词撰写,设计项目级入站流量和出站流量安全架构。
- 生成、自审并运行
bash部署脚本,以部署全球外部应用负载均衡、Cloud NAT、CAS 和 Cloud NGFW Enterprise。
2. 准备工作
前提条件
在开始此 Codelab 之前,请确保您具备以下条件:
- Google 账号和 Google Chrome 浏览器。
- 已启用结算功能的新 Google Cloud 项目。记下您的项目 ID (
PROJECT_ID),因为您将在整个 Codelab 中使用它来启用 API、创建 API 密钥和部署 Google Cloud 资源。 - Google Cloud 项目中的 Identity and Access Management (IAM) 权限,用于创建 API 密钥、Compute Engine 资源、VPC 网络、CAS 池、IAP 隧道和 Cloud NGFW 端点。
- 使用
gcloudCLI 进行身份验证,设置活跃的 Google Cloud 云项目,并启用所需的 API:- 在终端或 Cloud Shell 中,检查您是否已通过身份验证:
如果您需要对账号进行身份验证,请运行以下命令:gcloud auth listgcloud auth login - 验证
gcloudCLI 是否已配置为使用您的项目: 如果您的项目未设置,或者其他项目处于活跃状态,请设置您的项目 ID。将gcloud config list projectPROJECT_ID替换为您的 Google Cloud 项目 ID:export PROJECT_ID=PROJECT_ID gcloud config set project PROJECT_ID - 在 Google Cloud 项目中启用所需的 API:
gcloud services enable \ compute.googleapis.com \ iap.googleapis.com \ networksecurity.googleapis.com \ privateca.googleapis.com \ developerknowledge.googleapis.com \ apikeys.googleapis.com
- 在终端或 Cloud Shell 中,检查您是否已通过身份验证:
- 从 Google Antigravity 下载页面在本地系统上安装 Antigravity 2.0。
使用 Antigravity CLI 安装 Google Cloud Developer 插件
如需使用 Antigravity CLI 安装 Google Cloud Developer 插件,请执行以下操作:
- 如需在本地工作站上安装 Antigravity CLI,请执行以下操作:
- 打开本地终端。
- 运行安装程序脚本:
curl -fsSL https://antigravity.google/cli/install.sh | bash - 关闭并重新打开终端会话,以便在系统
PATH中使用 Antigravity CLI 二进制文件agy。
- 在本地终端中,运行以下命令以安装
google-cloud-developer插件: 您将看到类似如下所示的输出:agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer 如需了解该插件中包含的所有可用技能和功能,请参阅 Google Cloud Developer 插件文档和 Google Cloud Developer 插件入门 Codelab。Cloning plugin from https://github.com/google/skills.git... [ok] google-cloud-developer ✔ skills : 5 processed - agents : skipped (not found) - commands : skipped (not found) ✔ mcpServers : 1 processed - hooks : skipped (not found)
3. 设置 Antigravity 和 DK MCP 服务器
在本部分中,您将使用受限的 Google Cloud API 密钥在 Antigravity 中配置 DK MCP 服务器。
- 打开 Antigravity,输入
/goal,然后按 Enter 键激活目标模式,接着粘贴以下提示,以创建受限 API 密钥并配置 DK MCP 服务器。 将PROJECT_ID替换为准备工作部分中的 Google Cloud 项目 ID。如需了解详情,请参阅 google-cloud-developer 插件。Set up Antigravity to use the Developer Knowledge MCP server on my local machine. Run the necessary terminal commands to complete the following: 1. Create a restricted API key named 'DKP-MCP-Key' that can only target the Developer Knowledge API. Use the PROJECT_ID to create the API key. 2. Retrieve the actual key string of the newly created API key. 3. Create or safely update my ~/.gemini/config/mcp_config.json file (preserve any existing MCP servers) with the correct JSON structure to connect the developer-knowledge server using that API key in the headers. You MUST use the following JSON structure for the new server: "developer-knowledge": { "serverUrl": "https://developerknowledge.googleapis.com/mcp", "headers": { "x-goog-api-key": "<INSERT_RETRIEVED_API_KEY_HERE>" } } When you are done, confirm that the setup is complete. - 如需验证 DK MCP 服务器是否处于活跃状态,请在 Antigravity 聊天窗口中输入以下提示:
Antigravity 会列出Which MCP servers are available?developer-knowledge及其可用工具(search_documents、answer_query和get_documents):
4. 创建和部署应用
在本部分中,您将在自定义 VPC 网络内的两个专用 Compute Engine 虚拟机上部署 gCurrenC 计算器应用。
该应用提供:
- 一个实时货币换算器,支持
USD、EUR、GBP、JPY、CAD、INR和AUD,使用 Python 的内置http.server标准库,在端口8080上运行,并提供/healthz健康检查端点。 - 安全验证控制台,用于运行实时出站 API 连接和加密威胁防护探测。
- 一条入站流量防火墙规则,允许 Google 的 IAP 范围访问端口
22和8080,以便进行管理测试,而无需公开公共 IP 地址。
部署应用
- 在 Antigravity 对话窗口中,输入
/goal,然后运行以下提示:You are a Cloud developer. Deploy the "gCurrenC calculator" app onto two (2) Compute Engine VMs with no external IP addresses (`--no-address`) inside a dedicated custom VPC network and private subnet. CRITICAL INSTRUCTIONS ON OUTPUT: - The VMs are strictly private with no external IP addresses and the local IAP tunnel has NOT been started yet. Any web URL is completely unreachable and will fail with a connection error. - In your final response, simply confirm that the private VMs and Managed Instance Group are deployed, and state that the user should establish the IAP tunnel. Do not output, format, or suggest any web preview link or URL (such as http://localhost:8080 or internal IP addresses) in your final response. Run this script in the terminal: ```bash #!/usr/bin/env bash set -euxo pipefail # Disable any interactive confirmation prompts so execution never hangs export CLOUDSDK_CORE_DISABLE_PROMPTS=1 # --- User Configuration --- PROJECT_ID="[PROJECT_ID]" REGION="us-central1" ZONE="us-central1-a" NETWORK="gcurrenc-vpc" SUBNET="gcurrenc-app-subnet" SUBNET_RANGE="10.10.1.0/24" # -------------------------- echo "==> [1/5] Configuring project, default region/zone, and enabling APIs..." gcloud config set project "${PROJECT_ID}" gcloud config set compute/region "${REGION}" gcloud config set compute/zone "${ZONE}" gcloud services enable compute.googleapis.com echo "==> [2/5] Creating custom VPC network and private workload subnet..." gcloud compute networks create "${NETWORK}" \ --subnet-mode=custom \ --description="Dedicated VPC for currency exchange app demo" 2>/dev/null || true gcloud compute networks subnets create "${SUBNET}" \ --network="${NETWORK}" \ --region="${REGION}" \ --range="${SUBNET_RANGE}" \ --enable-private-ip-google-access \ --description="Private subnet hosting backend compute instances" 2>/dev/null || true echo "==> [3/5] Generating standalone Python standard-library startup script..." cat << 'STARTUP_EOF' > /tmp/private_app_startup.sh #!/bin/bash set -euxo pipefail mkdir -p /opt/gcurrenc-app # Pure Python standard-library application (zero pip/apt dependencies needed at boot) cat << 'APPEOF' > /opt/gcurrenc-app/app.py import os import sys import json import socket import urllib.request import urllib.parse import ssl from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer SUPPORTED_CURRENCIES = ["USD", "EUR", "GBP", "JPY", "CAD", "INR", "AUD"] class CurrencyAppHandler(BaseHTTPRequestHandler): def address_string(self): return str(self.client_address[0]) def do_GET(self): parsed = urllib.parse.urlparse(self.path) path = parsed.path params = urllib.parse.parse_qs(parsed.query) if path == "/favicon.ico": self.send_response(204) self.end_headers() return if path == "/healthz": self.send_response(200) self.send_header("Content-Type", "text/plain") self.end_headers() self.wfile.write(b"OK") return if path == "/api/security-test": mode = params.get("mode", ["safe"])[0] target = "https://secure.eicar.org/eicar.com.txt" if mode == "threat" else "https://api.frankfurter.dev/v1/latest?from=USD&to=EUR" try: req = urllib.request.Request(target, headers={"User-Agent": "SecureCurrencyApp/1.0"}) ctx = ssl.create_default_context() with urllib.request.urlopen(req, timeout=5, context=ctx) as resp: data = {"verdict": "PERMITTED", "target": target, "http_status": resp.status} code = 200 except Exception as e: data = {"verdict": "BLOCKED_OR_FAILED", "target": target, "error": str(e)} code = 502 self.send_response(code) self.send_header("Content-Type", "application/json") self.end_headers() self.wfile.write(json.dumps(data, indent=2).encode("utf-8")) return self.render_page() def do_POST(self): parsed = urllib.parse.urlparse(self.path) if parsed.path == "/generate": content_length = int(self.headers.get("Content-Length", 0)) post_body = self.rfile.read(content_length).decode("utf-8") form = urllib.parse.parse_qs(post_body) base_curr = form.get("base_curr", ["USD"])[0] target_curr = form.get("target_curr", ["EUR"])[0] try: amount = float(form.get("amount", ["2500.00"])[0]) except ValueError: amount = 2500.00 rate_str = "Unavailable" total_str = "Rate lookup pending outbound internet activation" try: if base_curr == target_curr: rate = 1.0 else: url = f"https://api.frankfurter.dev/v1/latest?from={base_curr}&to={target_curr}" req = urllib.request.Request(url, headers={"User-Agent": "SecureCurrencyApp/1.0"}) with urllib.request.urlopen(req, timeout=4) as resp: res_json = json.loads(resp.read().decode("utf-8")) rate = res_json["rates"][target_curr] rate_str = str(rate) total_str = f"{round(amount * rate, 2):,.2f} {target_curr}" except Exception as e: total_str = f"Outbound connection unavailable {str(e)}" self.render_page(base_curr, target_curr, amount, rate_str, total_str) return self.send_response(404) self.end_headers() def render_page(self, base_curr="USD", target_curr="EUR", amount=2500.00, fx_rate="1.00", total_str=""): hostname = socket.gethostname() curr_options_base = "".join([f'<option value="{c}" {"selected" if c == base_curr else ""}>{c}</option>' for c in SUPPORTED_CURRENCIES]) curr_options_target = "".join([f'<option value="{c}" {"selected" if c == target_curr else ""}>{c}</option>' for c in SUPPORTED_CURRENCIES]) result_block = "" if total_str: if fx_rate == "Unavailable": rate_line = "<p style='margin: 6px 0;'>Exchange Rate: <span style='color: #d93025; font-weight: bold;'>⚠️ Offline-Outbound internet blocked</span></p>" else: rate_line = f"<p style='margin: 6px 0; font-size: 14px; color: #137333;'>🟢 Exchange Rate: <strong>1 {base_curr} = {fx_rate} {target_curr}</strong> (Secured via Cloud NAT & Cloud NGFW)</p>" result_block = f""" <div style="margin-top: 22px; background: #e6f4ea; border: 1px solid #c6e1c6; border-left: 5px solid #34a853; padding: 18px 20px; border-radius: 8px;"> <h4 style="margin: 0 0 6px 0; text-transform: uppercase; font-size: 12px; color: #137333; letter-spacing: 0.5px;">Conversion Result</h4> <div style="font-size: 24px; font-weight: 700; color: #202124; margin-bottom: 6px;"> {amount:,.2f} {base_curr} = <span style="color: #1a73e8;">{total_str}</span> </div> {rate_line} </div> """ html = ("""<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>gCurrenC calculator</title> <style> body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; background: #f8f9fa; margin: 30px 15px; color: #202124; display: flex; justify-content: center; } .container { width: 100%; max-width: 860px; } .card { background: white; padding: 24px 28px; border-radius: 12px; box-shadow: 0 1px 3px rgba(60,64,67,0.12), 0 4px 8px rgba(60,64,67,0.06); border: 1px solid #dadce0; margin-bottom: 20px; } .header { display: flex; justify-content: space-between; align-items: center; border-bottom: 1px solid #e8eaed; padding-bottom: 14px; margin-bottom: 20px; } .header h2 { margin: 0 0 4px 0; font-size: 20px; font-weight: 600; } .header p { margin: 0; font-size: 13px; color: #5f6368; } .badge { background: #e8f0fe; color: #1a73e8; padding: 6px 12px; border-radius: 16px; font-weight: 600; font-size: 12px; border: 1px solid #d2e3fc; display: flex; align-items: center; gap: 6px; } .badge::before { content: ""; width: 8px; height: 8px; border-radius: 50%; background-color: #34a853; } .form-row { display: flex; gap: 14px; align-items: flex-end; flex-wrap: wrap; } .form-group { display: flex; flex-direction: column; gap: 6px; } .form-group label { font-size: 12px; font-weight: 600; color: #5f6368; text-transform: uppercase; letter-spacing: 0.5px; } input, select { padding: 10px 14px; border: 1px solid #dadce0; border-radius: 6px; font-size: 14px; color: #202124; background-color: #fff; box-sizing: border-box; transition: border-color 0.15s, box-shadow 0.15s; } input:focus, select:focus { outline: none; border-color: #1a73e8; box-shadow: 0 0 0 3px rgba(26, 115, 232, 0.15); } button { padding: 11px 20px; background: #1a73e8; color: white; border: none; border-radius: 6px; font-size: 14px; font-weight: 500; cursor: pointer; transition: background 0.15s, box-shadow 0.15s; } button:hover { background: #1557b0; box-shadow: 0 1px 2px rgba(60,64,67,0.3); } .danger-btn { background: #d93025; } .danger-btn:hover { background: #b31412; } pre { background: #202124; color: #8ab4f8; padding: 14px; border-radius: 6px; overflow-x: auto; font-family: "SF Mono", "Fira Code", Consolas, monospace; font-size: 13px; line-height: 1.5; margin: 0; } /* Collapsible Security Console */ details.security-drawer { background: white; border-radius: 12px; box-shadow: 0 1px 3px rgba(60,64,67,0.12); border: 1px solid #dadce0; overflow: hidden; margin-bottom: 24px; } details.security-drawer summary { padding: 16px 20px; font-size: 14px; font-weight: 600; cursor: pointer; list-style: none; display: flex; justify-content: space-between; align-items: center; user-select: none; background: #fafafa; transition: background 0.15s; } details.security-drawer summary::-webkit-details-marker { display: none; } details.security-drawer summary:hover { background: #f1f3f4; } details.security-drawer[open] summary { border-bottom: 1px solid #dadce0; background: #ffffff; } .expand-toggle { font-size: 13px; font-weight: 500; } details.security-drawer summary .expand-toggle::before { content: "▶ Click to Expand"; color: #1a73e8; } details.security-drawer[open] summary .expand-toggle::before { content: "▼ Click to Collapse"; color: #5f6368; } .drawer-body { padding: 20px; background: #ffffff; } .drawer-body p { margin-top: 0; font-size: 13px; color: #5f6368; } .probe-buttons { display: flex; gap: 10px; margin-bottom: 14px; } </style> </head> <body> <div class="container"> <div class="card"> <div class="header"> <div> <h2>💱 gCurrenC calculator</h2> </div> <div class="badge">Serving host: {hostname}</div> </div> <form method="POST" action="/generate"> <div class="form-row"> <div class="form-group" style="flex: 1.5; min-width: 140px;"> <label>Amount</label> <input type="number" step="0.01" name="amount" value="{amount}" required> </div> <div class="form-group" style="flex: 1; min-width: 100px;"> <label>From</label> <select name="base_curr">{curr_options_base}</select> </div> <div class="form-group" style="flex: 1; min-width: 100px;"> <label>To (Target)</label> <select name="target_curr">{curr_options_target}</select> </div> <div class="form-group"> <button type="submit">Convert currency ➔</button> </div> </div> </form> {result_block} </div> <!-- Collapsible Security Verification Console --> <details class="security-drawer"> <summary> <span>🛡️ Security verification console</span> <span class="expand-toggle"></span> </summary> <div class="drawer-body"> <p>Test outbound HTTPS traffic and threat prevention capabilities in real time:</p> <div class="probe-buttons"> <button type="button" onclick="runProbe('safe')">Test Outbound API Connection</button> <button type="button" class="danger-btn" onclick="runProbe('threat')">Simulate Encrypted Threat (EICAR)</button> </div> <pre id="output">Waiting for command...</pre> </div> </details> </div> <script> function runProbe(mode) { const el = document.getElementById('output'); el.innerText = 'Executing outbound request...'; fetch('/api/security-test?mode=' + mode) .then(res => res.json()) .then(data => el.innerText = JSON.stringify(data, null, 2)) .catch(err => el.innerText = 'Connection dropped / reset by Firewall: ' + err); } </script> </body> </html>""" .replace("{hostname}", str(hostname)) .replace("{amount}", str(amount)) .replace("{curr_options_base}", curr_options_base) .replace("{curr_options_target}", curr_options_target) .replace("{result_block}", result_block) ) self.send_response(200) self.send_header("Content-Type", "text/html; charset=utf-8") self.end_headers() self.wfile.write(html.encode("utf-8")) def run(): server_address = ('0.0.0.0', 8080) httpd = ThreadingHTTPServer(server_address, CurrencyAppHandler) httpd.serve_forever() if __name__ == '__main__': run() APPEOF # Register and start systemd unit cat << 'SERVICEEOF' > /etc/systemd/system/gcurrenc-app.service [Unit] Description=Currency exchange calculator web application After=network.target [Service] Type=simple User=root WorkingDirectory=/opt/gcurrenc-app ExecStart=/usr/bin/python3 /opt/gcurrenc-app/app.py Restart=always [Install] WantedBy=multi-user.target SERVICEEOF systemctl daemon-reload systemctl enable gcurrenc-app systemctl start gcurrenc-app STARTUP_EOF echo "==> [4/5] Creating Firewall, Regional Instance Template, and 2-VM MIG..." gcloud compute firewall-rules create allow-iap-admin \ --network="${NETWORK}" \ --allow=tcp:22,tcp:8080 \ --source-ranges=35.235.240.0/20 \ --target-tags=gcurrenc-app-vm \ --description="Allow IAP SSH and port 8080 access to private VMs" \ --quiet 2>/dev/null || true # Explicitly pass both --region and --instance-template-region to avoid prompt gcloud compute instance-templates create gcurrenc-app-template \ --instance-template-region="${REGION}" \ --region="${REGION}" \ --network="${NETWORK}" \ --subnet="${SUBNET}" \ --machine-type=e2-medium \ --no-address \ --tags=gcurrenc-app-vm \ --metadata-from-file=startup-script=/tmp/private_app_startup.sh \ --quiet gcloud compute instance-groups managed create gcurrenc-app-mig \ --base-instance-name=gcurrenc-vm \ --template="projects/${PROJECT_ID}/regions/${REGION}/instanceTemplates/gcurrenc-app-template" \ --size=2 \ --zone="${ZONE}" \ --quiet gcloud compute instance-groups managed set-named-ports gcurrenc-app-mig \ --named-ports=http-port:8080 \ --zone="${ZONE}" \ --quiet echo "==> [5/5] Verifying private VM deployment and internal status..." sleep 30 gcloud compute instances list \ --filter="name ~ '^gcurrenc-vm-'" \ --zones="${ZONE}" \ --format="table(name,zone.basename():label=ZONE,networkInterfaces[0].networkIP:label=INTERNAL_IP,status)" FIRST_VM=$(gcloud compute instances list \ --filter="name ~ '^gcurrenc-vm-'" \ --zones="${ZONE}" \ --format="value(name)" \ --limit=1) echo "Testing healthz on ${FIRST_VM} via IAP tunnel..." gcloud compute ssh "${FIRST_VM}" \ --zone="${ZONE}" \ --tunnel-through-iap \ --quiet \ --command="curl -fsS http://localhost:8080/healthz" echo "" echo "==========================================================================" echo "PREREQUISITE COMPLETE: 2 private VMs deployed with no external IPs." echo "VPC: ${NETWORK} | Subnet: ${SUBNET} (${SUBNET_RANGE})" echo "Instance Group: gcurrenc-app-mig (Zone: ${ZONE}, Port: 8080)" echo "" echo "The VMs are private and the IAP tunnel is not active. Set up the background IAP tunnel first to access the deployed app." echo "" echo "==========================================================================" ```
验证虚拟机实例创建
Antigravity 在两个私有 Compute Engine 虚拟机上完成应用部署后,请在 Google Cloud 控制台中验证实例:
- 在 Google Cloud 控制台中,前往虚拟机实例。
- 验证这两个虚拟机实例是否正在运行,且具有内部 IP 地址,但没有外部 IP 地址:

5. 测试应用
由于这些专用虚拟机没有外部 IP 地址 (--no-address),也没有 Cloud NAT 网关,因此它们没有通往互联网的路由,无法访问外部货币兑换 API。在配置安全出站访问权限之前,请通过本地 IAP 隧道测试应用,以验证其无法访问互联网。
- 在
/goal模式下,在 Antigravity 对话窗口中运行以下提示:Automate the IAP tunnel configuration and health verification for the web app, then output the live test URL. Run a terminal script that performs the following steps non-interactively: 1. Firewall Check: - Identify the active network ('gcurrenc-vpc' if it exists, otherwise 'default'). - Idempotently ensure an ingress firewall rule exists permitting 'tcp:22,tcp:8080' from the Google IAP range '35.235.240.0/20' targeting 'gcurrenc-app-vm'. 2. VM Health Verification: - Find the first running instance matching '^gcurrenc-vm-' in zone 'us-central1-a'. - Via 'gcloud compute ssh --tunnel-through-iap', verify that the 'gcurrenc-app' systemd service is active. If not active, restart it. 3. Background IAP Tunnel: - Free up local port 8080 if an old tunnel or process is lingering (e.g., using 'lsof -ti:8080 | xargs kill -9' or 'fuser -k 8080/tcp'). - Launch 'gcloud compute start-iap-tunnel <VM_NAME> 8080 --local-host-port=localhost:8080 --zone=us-central1-a' in the background using nohup, redirecting output to '/tmp/iap_tunnel.log'. - Wait up to 10 seconds for the tunnel to establish, checking with 'curl -fsS http://localhost:8080/healthz'. 4. Output Web Preview URL: - Detect whether the environment is Google Cloud Shell (check if $CLOUD_SHELL is true) or a local workstation. - If Cloud Shell, print instructions and the direct web preview link. - If local machine, provide the clickable 'http://localhost:8080' URL. - 隧道启动后,在网络浏览器中打开
http://localhost:8080/:
- 测试应用:
- 点击换算货币。转换结果会显示
Offline - Outbound internet blocked和Outbound connection unavailable。此结果符合预期,因为专用虚拟机无法连接到互联网来获取最新汇率。 - 展开安全验证控制台,然后点击测试出站 API 连接。输出会显示
https://api.frankfurter.dev/v1/latest的verdict: BLOCKED_OR_FAILED()。此结果符合预期,因为专用虚拟机无法连接到互联网,也无法从https://api.frankfurter.dev/v1/latest提取汇率。 - 点击模拟加密威胁 (EICAR)。输出还会显示
https://secure.eicar.org/eicar.com.txt的verdict: BLOCKED_OR_FAILED。这也是预期的结果,因为专用虚拟机没有互联网连接。
- 点击换算货币。转换结果会显示
停止本地 IAP 隧道
在设计和部署安全架构之前,请终止本地 IAP 隧道以释放端口 8080:
- 在
/goal模式下,运行以下提示: Antigravity 确认 IAP 隧道已终止,本地端口Free up local port 8080 and terminate any running Google Cloud IAP tunnels (e.g., kill processes matching 'start-iap-tunnel' or listening on port 8080).8080已释放。
6. 保护应用
在前面的部分中,您创建了没有公共 IP 地址的专用 Compute Engine 虚拟机,并验证了两个核心网络和安全挑战:
- 入站访问(入站流量):互联网用户无法直接访问专用虚拟机实例,并且公开 Web 应用需要通过全球外部应用负载均衡器和专用代理专用子网代理流量,而无需将虚拟机公开到公共互联网。
- 出站访问(出站流量):专用虚拟机没有连接到互联网的路由,无法查询实时 HTTPS 货币兑换 API,而启用出站访问需要检查加密流量是否存在恶意软件和数据渗漏,同时不能破坏 SSL/TLS 信任。
在本部分中,您将引导 Antigravity 遵循基于 Google Cloud 官方文档 (@retrieving-developer-knowledge) 的精简工作流,为您的应用设计、自审和部署项目级入站和出站流量安全架构。
设计统一的安全架构
- 在
/goal模式下,运行以下提示,生成涵盖入站和出站流量的端到端架构图和说明: Antigravity 查询 DK MCP 服务器,并返回一个架构图和说明,展示全球外部应用负载均衡、仅代理子网、Cloud NAT、CAS 和项目级 Cloud NGFW Enterprise 如何连接在一起。You are a Google Cloud Network and Security Architect. We need to design an end-to-end security architecture for our "gCurrenC calculator" app running on private Compute Engine VMs with no external IP addresses inside 'gcurrenc-vpc'. We are operating in a standalone Google Cloud project without an Organization resource, so all security resources must be scoped at the project level. Use the @retrieving-developer-knowledge skill to consult official Google Cloud documentation and suggest an architecture diagram and explanation covering both flows: 1. Ingress Flow: - How internet users securely reach the private VMs via a global external Application Load Balancer. - Why Envoy-based external Application Load Balancers require a dedicated proxy-only subnet, and how Google Front Ends (GFEs) proxy traffic to private backends without exposing VMs to the public internet. 2. Egress Flow: - How private VMs reach the internet via Cloud NAT to query live currency exchange APIs, such as frankfurter.dev. - How Cloud NGFW Enterprise provides Layer 7 deep packet inspection and intrusion prevention (IPS) for outbound encrypted HTTPS traffic. - How TLS inspection backed by Certificate Authority Service (CAS) decrypts outbound HTTPS sessions on the fly, and what Root CA trust configuration the private VMs require. Provide a clear diagram and explain how these components connect together.
生成架构资源大纲
- 输入以下提示,以便在生成部署脚本之前,将设计整理成按类别划分的项目级资源大纲:
Antigravity 会生成一个结构化资源大纲,其中映射了核心 VPC 基础设施、入站负载均衡和项目级出站威胁防护。Act as a Lead Network Security Architect. Using the @retrieving-developer-knowledge skill, provide an architectural outline of all the Google Cloud resources required to secure the "gCurrenC calculator" app. Our starting state: - The custom VPC ('gcurrenc-vpc'), workload subnet ('gcurrenc-app-subnet'), and 2-instance MIG ('gcurrenc-app-mig', port 8080) are already deployed. - All newly added security components must be project-level resources (no organization resources). Structure your resource outline into three distinct categories, indicating which resources are new additions: 1. Core VPC Infrastructure: proxy-only subnet ('gcurrenc-proxy-subnet', 10.10.2.0/24), Cloud Router, and Cloud NAT gateway. 2. Inbound security (ingress): global external ALB components (forwarding rule on port 443, target HTTPS proxy, SSL certificate, URL map, backend service attached to 'gcurrenc-app-mig' on port 8080, and HTTP health check on '/healthz') and ingress firewall rules. 3. Outbound security (egress): CAS DevOps CA pool and root CA, project-level Cloud NGFW Enterprise components (Threat Prevention profile, Security Profile Group, Firewall Endpoint in zone us-central1-a, and Endpoint Association attaching the TLS policy), and global network firewall policy egress rules. For each resource, briefly state its role in the security boundary and how it connects to adjacent components.
生成并自行审核部署脚本
- 在
/goal模式下,运行以下提示,生成一个完整的非交互式bash部署脚本,并在同一轮对话中根据合规性要求自动对其进行自我审核: Antigravity 会生成完整的Act as a Principal Infrastructure Engineer. Using the @retrieving-developer-knowledge skill, generate a complete, non-interactive Bash script to deploy this entire security architecture for our "gCurrenC calculator" app, and self-audit the script before outputting it. Requirements: - Discover the project ID, region, and zone dynamically from the existing 'gcurrenc-app-subnet' and 'gcurrenc-app-mig'. - Keep all resources scoped strictly to the project level (no Organization resource). - Deploy the proxy-only subnet, global external Application Load Balancer, Cloud Router, and Cloud NAT. Don't use Cloud Armor. - Deploy project-level Cloud NGFW Enterprise with CAS TLS inspection ('--tls-inspect' on the firewall policy egress rule and 'gcloud beta' for the project-level firewall endpoint association) and an explicit DENY override for malware and antivirus threats. - Distribute the root CA to the private VMs over IAP SSH with connection timeouts so the guest OS trust store is updated. - Print the final Load Balancer URL ('https://${LB_IP}') at the end. Wrap the script in 'set -euxo pipefail' and output only the single executable bash script block.bash脚本,根据合规性限制条件自行审核每个命令,并输出封装在set -euxo pipefail中的单个可执行脚本块。
运行安全部署脚本
- 在
/goal模式下,将上一个提示中生成的bash脚本粘贴到 Antigravity 聊天窗口中,格式如下,以运行部署并输出实时应用网址 (https://<LB_IP>):Run this script. <PASTED-SCRIPT>
7. 验证受保护的应用
部署脚本运行完毕后,Antigravity 会输出全球外部应用负载均衡器 (https://<LB_IP>) 的外部 HTTPS 网址。
- 在网络浏览器中打开
https://<LB_IP>,并绕过浏览器的自签名证书警告,以加载 gCurrenC 计算器界面:
- 测试应用,以验证出站连接和威胁防护:
- 点击换算货币。应用会立即显示实时换算汇率。这证实了入站流量负载均衡通过 Google Front End (GFE) 和代理专用子网顺利路由,而 Cloud NAT 则从
api.frankfurter.dev提取实时汇率。 - 展开安全验证控制台,然后点击测试出站 API 连接。应用会显示
verdict: PERMITTED(HTTP 200)。这证实了 Cloud NAT 路由正常运行,并且虚拟机操作系统信任私有 CAS 根 CA,可用于解密的 HTTPS 会话。 - 点击模拟加密威胁 (EICAR)。应用会显示
verdict: PERMITTED。这证实了 Cloud NGFW Enterprise 使用由 CAS 支持的 TLS 检查来解密出站 HTTPS 请求,并使用其入侵防御服务 (IPS) 检查 EICAR 测试签名。
- 点击换算货币。应用会立即显示实时换算汇率。这证实了入站流量负载均衡通过 Google Front End (GFE) 和代理专用子网顺利路由,而 Cloud NAT 则从
8. 清理
为避免系统因本 Codelab 中创建的资源向您的 Google Cloud 账号持续收取费用,您可以仅删除 Codelab 资源,也可以删除 Google Cloud 项目。
- 如果您想保留 Google Cloud 项目,仅移除在此 Codelab 期间创建的资源,请在 Antigravity 聊天窗口中以
/goal模式运行以下提示:Remove all resources created in this session, including the gcurrenc app and its resources. Don't delete the project. - 如果您为此 Codelab 创建了专用 Google Cloud 项目,并且想要删除整个项目,请在 Antigravity 聊天窗口中以
/goal模式运行以下提示:Clean up the demo environment by deleting the Google Cloud project. Run the following command in the terminal: gcloud projects delete "$(gcloud config get-value project 2>/dev/null)" --quiet
9. 恭喜
恭喜!您在 Google Antigravity 中使用 Google Cloud 开发者插件(DK MCP 服务器),在 Google Cloud 上部署并保护了 gCurrenC 计算器 Web 应用。
后续步骤
如需详细了解此 Codelab 中使用的服务,请参阅 Google Cloud 官方文档: