google 云构建语法

Question

我正在处理我的第一个 cloudbuild.yaml 文件，运行遇到此错误：

Your build failed to run: failed unmarshalling build config cloudbuild.yaml: yaml: line 8: did not find expected key

下面是我的文件内容（注释省略），后面有几个问题：

steps:
- name: 'node:12-alpine'
    entrypoint: 'bash'
    args:
        - 'build.sh'
- name: 'docker'
    args:
    - 'build'
    - '-t'
    - 'gcr.io/$PROJECT_ID/my-project:$(git describe --tags `git rev-list --tags --max-count=1`)'
images: ['gcr.io/$PROJECT_ID/my-project']

问题：

带有 - name: 'node:12-alpine' 的那一行似乎是爆炸的地方。但是，文档指出，"Cloud Build enables you to use any publicly available image to execute your tasks.". The node:12-alpine imgage 是公开可用的，所以我做错了什么？
其次，我试图在第一步中使用一堆 BASH 命令来执行一个文件。如果我使用的 Alpine 图像支持所有命令，那应该可以，对吗？
最后，我正在尝试创建一个 docker 图像，其版本号基于最新的 git 标签的版本。是否支持这样的语法，或者通常如何使用 google cloud build 处理版本控制（环顾四周，我没有看到关于这个主题的任何内容）

Answer 1

此错误很可能是由于 cloudbuild.yaml 文件的缩进错误造成的。你可以看看official documentation，它显示了这个文件的结构：

steps:
- name: string
  args: [string, string, ...]
  entrypoint: string
- name: string
  ...
- name: string
  ...
images:
- [string, string, ...]

Answer 2

当你运行一个容器进入Cloud Build时，定义到容器中的入口点会被自动调用，并且args传入这个入口点的参数。

你必须知道的

您可以覆盖入口点，就像您在 node:12 图像中所做的那样
如果容器不包含入口点，则构建失败（您的错误，您使用了通用 docker 图像）。你可以
- 要么定义正确的入口点（此处entrypoint: "docker"）
- 或者用一个Cloud Builder，对于docker，这个- name: 'gcr.io/cloud-builders/docker'
步骤的参数被转发 as-is，没有任何解释（除了 $MyVariable 之类的变量替换）。您的命令解释 $(my command) 未被评估。除了你这样做

- name: 'gcr.io/cloud-builders/docker' #you can also use the raw docker image here
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      first bash command line
      second bash command line
      docker build -t gcr.io/$PROJECT_ID/my-project:$(git describe --tags `git rev-list --tags --max-count=1`)

但是您可以让标签更智能。如果你看看 default environment variable of Cloud Build，你可以使用 $TAG_NAME.

docker build -t gcr.io/$PROJECT_ID/my-project:$TAG_NAME

请注意，只有当您从您的存储库中触发它时，它才是正确的。如果您运行手动构建，则它不起作用。所以，有一个解决方法。看看这个

- name: 'gcr.io/cloud-builders/docker' 
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      TAG=${TAG_NAME}
      if [ -z $${TAG} ]; then TAG=$(git describe --tags `git rev-list --tags --max-count=1`); fi      
      docker build -t gcr.io/$PROJECT_ID/my-project:$${TAG}

但是，我不建议您覆盖图像。你会丢失历史，如果你用错误的版本覆盖了一个好的图像，你就失去了它！

如果你有什么地方没听懂，比如为什么双 $$ 等等，不要犹豫，评论

google 云构建语法

google cloud build syntax

docker

google-cloud-build