Mengonfigurasi urutan langkah build

Anda bisa menetapkan urutan eksekusi langkah-langkah build Anda. Secara default, langkah-langkah build berjalan secara berurutan, tetapi Anda dapat mengonfigurasinya agar berjalan serentak.

Halaman ini menjelaskan cara mengonfigurasi urutan langkah build.

Urutan langkah dan dependensi build

Gunakan kolom waitFor dalam langkah build untuk menentukan langkah mana yang harus dijalankan sebelum langkah build dijalankan. Jika tidak ada nilai yang diberikan untuk waitFor, langkah build akan menunggu langkah build semua sebelumnya dalam permintaan build agar berhasil diselesaikan sebelum berjalan.

Untuk menjalankan langkah build segera pada waktu build, gunakan - di kolom waitFor.

Urutan langkah build di kolom steps berkaitan dengan urutan langkah-langkah dijalankan. Langkah-langkah akan berjalan secara seri atau serentak berdasarkan dependensi yang ditentukan di kolom waitFor.

Sebuah langkah bergantung pada setiap id dalam waitFor-nya dan tidak akan diluncurkan hingga setiap dependensi berhasil diselesaikan.

Langkah tanpa kolom waitFor opsional (atau dengan waitFor kosong) akan menunggu semua langkah sebelumnya berhasil diselesaikan sebelum dieksekusi. Oleh karena itu, jika tidak ada langkah yang berisi id di kolom waitFor-nya, semua langkah akan dijalankan secara serial dalam urutan yang ditentukan.

Langkah-langkah dapat bergantung pada awal build dengan menetapkan waitFor hanya berisi -. Dengan mendeklarasikan bahwa suatu langkah hanya bergantung pada -, langkah tersebut langsung berjalan saat build dimulai. Langkah pertama yang ditentukan bergantung secara implisit pada awal.

Cuplikan berikut menunjukkan konfigurasi build dengan dua langkah yang berjalan secara serial:

YAML 

steps:
- name: foo
- name: bar

JSON 

{
    "steps": [{
        "name": "foo"
    },
    {
        "name": "bar"
    }
    ]
}

Cuplikan berikut menunjukkan dua langkah serentak yang keduanya bergantung pada awal; langkah ketiga menunggu hingga dua langkah pertama berhasil diselesaikan sebelum diluncurkan. Build serentak ini menjalankan langkah A dan B di awal build. Langkah ketiga akan menunggu secara implisit hingga kedua langkah sebelumnya selesai sebelum memulai. Contoh ini dapat disederhanakan dengan menghilangkan kolom id, yang tidak direferensikan dalam waitFor berikutnya.

YAML 

steps:
- name: foo
  id: A
- name: bar
  id: B
  waitFor: ['-']
- name: baz

JSON 

{
    "steps": [
    {
        "name": "foo",
        "id": "A"
    },
    {
        "name": "bar",
        "id": "B",
        "waitFor": ["-"]
    },
    {
        "name": "baz"
    }
    ]
}

Cuplikan berikut menunjukkan langkah-langkah serentak yang bergantung pada langkah sebelumnya. Langkah A akan segera berjalan saat build dimulai. Langkah B dan C berjalan secara bersamaan setelah A berhasil diselesaikan. Perhatikan bahwa kolom id dan waitFor pada langkah B, serta kolom id pada langkah C, dapat dihilangkan tanpa mengubah urutan eksekusi.

YAML 

steps:
- name: foo
  id: A
- name: bar
  id: B
  waitFor:
  - A
- name: baz
  id: C
  waitFor:
  - A

JSON 

{
    "steps": [
    {
        "name": "foo",
        "id": "A"
    },
    {
        "name": "bar",
        "id": "B",
        "waitFor": [
            "A"
        ]
    },
    {
        "name": "baz",
        "id": "C",
        "waitFor": [
            "A"
        ]
    }
    ]
}

Contoh

Contoh di bawah memanggil langkah gsutil dan wget secara serentak. Setelah langkah-langkah ini selesai, langkah ubuntu akan dipanggil.

YAML

steps:
# Download the binary and the data in parallel.
- name: 'gcr.io/cloud-builders/wget'
  args: ['https://example.com/binary']
- name: 'gcr.io/cloud-builders/gsutil'
  args: ['cp', 'gs://$PROJECT_ID-data/rawdata.tgz', '.']
  waitFor: ['-']  # The '-' indicates that this step begins immediately.

# Run the binary on the data, once both are downloaded.
- name: 'ubuntu'
  args: ['./binary', 'rawdata.tgz']

JSON

{
  "steps": [
    {
      "name": "gcr.io/cloud-builders/wget",
      "args": [
        "https://example.com/binary"
      ]
    },
    {
      "name": "gcr.io/cloud-builders/gsutil",
      "args": [
        "cp",
        "gs://$PROJECT_ID-data/rawdata.tgz",
        "."
      ],
      "waitFor": [
        "-"
      ]
    },
    {
      "name": "ubuntu",
      "args": [
        "./binary",
        "rawdata.tgz"
      ]
    }
  ]
}

Contoh di bawah ini menggunakan kolom id untuk mengidentifikasi langkah build tertentu. Nilai dari id digunakan di waitFor untuk menentukan urutan langkah build:

  • Pertama, langkah fetch-resources menggunakan gsutil untuk menyalin resource lokal dari Cloud Storage. Secara bersamaan, go membuat, menguji, dan menginstal kode sumber.

  • Kemudian, langkah build docker akan mem-build image setelah semua langkah lainnya selesai.

YAML 

steps:
- name: 'gcr.io/cloud-builders/go'
  args: ['generate']
- name: 'gcr.io/cloud-builders/go'
  args: ['test', './...']
- name: 'gcr.io/cloud-builders/go'
  args: ['install', 'mytarget']
  id: 'go-install'

- name: 'gcr.io/cloud-builders/gsutil'
  args: ['cp', '-r', './somefiles', 'gs://my-resource-bucket/somefiles']
  waitFor: ['-']  # The '-' indicates that this step begins immediately.
  id: 'fetch-resources'

- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'gcr.io/$PROJECT_ID/mytarget', '.']
  waitFor: ['go-install', 'fetch-resources']

images: ['gcr.io/$PROJECT_ID/mytarget']

JSON 

{
  "steps": [
    {
      "name": "gcr.io/cloud-builders/go",
      "args": [
        "generate"
      ]
    },
    {
      "name": "gcr.io/cloud-builders/go",
      "args": [
        "test",
        "./..."
      ]
    },
    {
      "name": "gcr.io/cloud-builders/go",
      "args": [
        "install",
        "mytarget"
      ],
      "id": "go-install"
    },
    {
      "name": "gcr.io/cloud-builders/gsutil",
      "args": [
        "cp",
        "-r",
        "./somefiles",
        "gs://my-resource-bucket/somefiles"
      ],
      "waitFor": [
        "-"
      ],
      "id": "fetch-resources"
    },
    {
      "name": "gcr.io/cloud-builders/docker",
      "args": [
        "build",
        "-t",
        "gcr.io/$PROJECT_ID/mytarget",
        "."
      ],
      "waitFor": [
        "go-install",
        "fetch-resources"
      ]
    }
  ],
  "images": [
    "gcr.io/$PROJECT_ID/mytarget"
  ]
}

Langkah selanjutnya