自动化索引的必要性
对于大型网站或频繁的内容更新,手动向谷歌搜索控制台(GSC)提交统一资源定位符(URL)效率低下。GSC URL 检查应用程序编程接口(API)提供了一种以编程方式与谷歌索引系统交互的方法,但直接使用可能较为复杂。本指南详细介绍了如何将命令行实用工具 gsc-indexer 集成到 GitHub Actions 持续集成/持续部署(CI/CD)流水线中,以自动化您的搜索引擎优化(SEO)索引工作流程。
CI/CD 中的 gsc-indexer:核心原则
为了让 gsc-indexer 在无人值守的 CI/CD 环境中有效运行,它依赖于以下几个关键设计选择:
- 机器友好的输出: 该工具支持
-json标志,在完成时发出一个包含结果的 JavaScript 对象表示法(JSON)数组。这便于在脚本中进行编程解析。 - 明确的退出代码: 成功运行(所有 URL 均已处理)返回
exit 0。任何失败(至少有一个 URL 检查或提交失败)返回非零退出代码。这使得在 CI 中能够进行 robust 的错误处理。 - 服务账号授权: 依赖谷歌云服务平台账号确保持久且细粒度的访问权限,无需手动进行开放授权(OAuth)流程。服务账号密钥文件(
sa.json)必须安全存储。
GitHub Actions 工作流示例
下面是一个 main.yaml 示例,演示了一个每日定时执行的工作流,该工作流检查站点地图,过滤特定 URL,并通过 gsc-indexer 请求索引。
name: 自动化 GSC 索引
on:
workflow_dispatch:
schedule:
- cron: '0 2 * * *' # 每天协调世界时凌晨 2 点运行
env:
GCP_PROJECT_ID: your-gcp-project-id # 替换为您的谷歌云平台项目 ID
GSC_PROPERTY_URL: https://www.your-domain.com/ # 替换为您的 GSC 属性 URL
jobs:
index-urls:
runs-on: ubuntu-latest
steps:
- name: 检出代码
uses: actions/checkout@v4
- name: 设置 Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: 安装 gsc-indexer
中文翻译:免责声明:本文内容来自互联网,该文观点不代表本站观点。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,请到页面底部单击反馈,一经查实,本站将立刻删除。