Mengonfigurasi urutan langkah-langkah build

Anda dapat menentukan urutan langkah-langkah build dieksekusi. Secara default, langkah-langkah build berjalan secara berurutan, tetapi Anda dapat mengonfigurasinya agar berjalan secara bersamaan.

Halaman ini menjelaskan cara mengonfigurasi urutan langkah-langkah build.

Urutan dan dependensi langkah-langkah 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 semua langkah build sebelumnya dalam permintaan build selesai dengan berhasil sebelum dijalankan.

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

Urutan langkah-langkah build di kolom steps terkait dengan urutan eksekusi langkah-langkah tersebut. Langkah-langkah akan berjalan secara berurutan atau serentak berdasarkan dependensi yang ditentukan di kolom waitFor.

Langkah bergantung pada setiap id di waitFor-nya dan tidak akan diluncurkan hingga setiap dependensi berhasil diselesaikan.

Langkah-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, semua langkah akan dieksekusi secara berurutan sesuai urutan yang ditentukan.

Langkah-langkah dapat bergantung pada awal build dengan membuat waitFor hanya berisi -. Dengan menyatakan bahwa langkah hanya bergantung pada -, langkah akan segera berjalan saat build dimulai. Langkah pertama yang ditentukan bergantung secara implisit pada start.

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

YAML 

steps:
- name: foo
- name: bar

JSON 

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

Cuplikan berikut menunjukkan dua langkah serentak yang bergantung pada start; 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 dimulai. Contoh ini dapat disederhanakan dengan menghilangkan kolom id, yang tidak dirujuk 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 berikut memanggil langkah gcloud storage dan wget secara bersamaan. 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/gcloud'
  args: ['storage', '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/gcloud",
      "args": [
        "storage",
        "cp",
        "gs://$PROJECT_ID-data/rawdata.tgz",
        "."
      ],
      "waitFor": [
        "-"
      ]
    },
    {
      "name": "ubuntu",
      "args": [
        "./binary",
        "rawdata.tgz"
      ]
    }
  ]
}

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

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

  • Kemudian, langkah build docker akan membangun 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/gcloud'
  args: ['storage', '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/gcloud",
      "args": [
        "storage",
        "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 berikutnya