如何更优雅地等待Firestore索引部署完成？

最优解决方案：使用gcloud原生操作等待命令 #

你不需要手动轮询解析操作结果，gcloud内置了firestore operations wait命令，会自动阻塞直到指定的索引操作完成，操作失败时会直接返回非零退出码中断CI/CD流程，比自行实现的轮询逻辑稳定性高很多。
Cloud Build的完整配置参考如下：

steps:
  # 原有部署索引步骤
  - name: gcr.io/${PROJECT_ID}/firebase
    args: ['deploy', '--project=${PROJECT_ID}', '--only=firestore:indexes']
  # 新增等待索引部署完成步骤
  - name: gcr.io/google.com/cloudsdktool/cloud-sdk
    entrypoint: bash
    args:
      - '-c'
      - |
        while :; do
          # 筛选所有未完成的索引操作
          RUNNING_OPERATIONS=$(gcloud firestore operations list \
            --filter="metadata.@type=type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata AND done=false" \
            --format="value(name)")
          if [ -z "$RUNNING_OPERATIONS" ]; then
            echo "✅ 所有Firestore索引部署完成，继续后续流程"
            break
          fi
          # 逐个等待操作执行完成
          for OP_ID in $RUNNING_OPERATIONS; do
            gcloud firestore operations wait "$OP_ID"
          done
          sleep 3
        done

备选方案：通过Firebase Admin SDK实现（适合自定义脚本场景） #

如果你需要在应用代码或者自定义构建脚本中集成等待逻辑，可以使用官方Admin SDK实现，Node.js示例如下：

const { FirestoreAdminClient } = require('@google-cloud/firestore-admin').v1;
const adminClient = new FirestoreAdminClient();

async function waitAllIndexesReady(projectId) {
  const projectResource = `projects/${projectId}`;
  while (true) {
    const [runningOps] = await adminClient.listOperations({
      name: projectResource,
      filter: 'metadata.@type="type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata" AND done=false'
    });
    if (runningOps.length === 0) {
      console.log('所有索引部署完成');
      return;
    }
    // 并发等待所有运行中操作完成
    await Promise.all(runningOps.map(op => adminClient.waitOperation({ name: op.name })));
    await new Promise(r => setTimeout(r, 5000));
  }
}

注意事项 #

• 确保CI/CD使用的服务账号拥有Cloud Datastore Index Admin预定义角色，包含索引查看、操作查询的必要权限
• 如果索引部署出现冲突、配置错误等问题，wait命令会直接抛出异常终止流程，不需要额外做异常校验
• 上述脚本已经处理了多索引并行部署的场景，不管同时提交多少个索引更新都会等待全部完成后再继续后续步骤

内容的提问来源于stack exchange，提问作者Han