设置 IO 工具以访问 Runbook

本页面介绍了如何设置和配置 IO 工具服务。 此服务会设置一个本地网页,用于访问服务手册,其中包含运行手册、提醒和错误消息说明,这些信息有助于排查部署问题。在问题排查过程中,Google 支持团队可能会要求您按照这些 runbook 中的某一个进行操作。该服务还包括运行手册中提到的工具和脚本。您可以使用此方法在安装了 Docker 的任何设备上设置设备外部的 IO 工具。

下载 GDC tar

  1. 验证您的服务账号对 private-cloud-release 存储桶的访问权限。

  2. 在笔记本电脑或工作站上,使用 gcloud 进行身份验证,然后按照说明操作:

     gcloud auth login
    
  3. 将 GDC tar 下载到笔记本电脑或工作站。 如果以下命令失败,请运行第 2 步,然后重试当前步骤。

    gsutil cp gs://private-cloud-release-partner/${GDCH_VERSION}/prod_te_gdch.tar.gz ~/
    

配置 IO 工具

  1. 在设备上创建一个目录,并将 prod_te_gdch.tar.gz 从 DTO 机器转移到该目录。在后续步骤中,请将此目录称为 $GDCH_ROOT

  2. 将下载的 tar 文件解压缩到 $GDCH_ROOT

    tar -I pigz -xvf gdch.tar.gz -C $GDCH_ROOT
    
  3. 前往 $GDCH_ROOT/release/ 目录,然后使用以下命令提取 IO 工具:docker image。

    gdcloud artifacts extract oci/ $GDCH_ROOT/io_tool/ --image-name gpc-system-container-images/private-cloud-devel/operation-tools:latest --docker-executable
    
  4. 使用 Docker 命令加载映像,然后运行该映像:

    docker load $GDCH_ROOT/io_tool/gpc-system-container-images/private-cloud-devel/operation-tools.tar
    docker run -v ~/log:/var/log --net=host -it gpc-system-container-images/private-cloud-devel/operation-tools
    
  5. 等待文档加载完毕,然后使用 http://127.0.0.1:7001 访问文档。