Function Compute:Kelola pipeline

Konfigurasi pipeline

Konfigurasi pipeline mencakup empat komponen utama: metode pemicu, lingkungan eksekusi, file YAML deskripsi resource, dan notifikasi robot DingTalk. Anda dapat mengonfigurasi metode pemicu dan lingkungan eksekusi saat membuat aplikasi atau lingkungan. Setelah pembuatan, Anda dapat mengonfigurasi keempat komponen tersebut dengan mengklik tombol Edit.

Metode pemicu pipeline

Application Center memungkinkan Anda menyesuaikan event Git yang memicu pipeline. Application Center menggunakan webhook untuk menerima event Git. Saat menerima event yang sesuai dengan aturan pemicu, platform akan membuat dan menjalankan pipeline berdasarkan file YAML pipeline yang telah Anda konfigurasi. Metode pemicu yang didukung adalah:

• Pemicu branch: Lingkungan harus dikaitkan dengan branch tertentu. Mencocokkan semua event Push untuk branch yang ditentukan.

• Pemicu tag: Mencocokkan semua event pembuatan Tag untuk ekspresi tag yang ditentukan.

• Pemicu merge branch: Mencocokkan event Merge atau Pull Request dari branch sumber yang ditentukan ke branch target yang dikaitkan dengan lingkungan.

Lingkungan eksekusi pipeline

Pipeline Execution Environment memiliki dua mode: Default Environment dan Custom Environment.

Lingkungan eksekusi default

Dalam Default Environment, platform sepenuhnya mengelola resource pipeline. Alibaba Cloud Function Compute menanggung biaya eksekusi pipeline, sehingga Anda tidak dikenai biaya apa pun. Setiap tugas pipeline dijalankan dalam kontainer sandbox independen. Platform menjamin isolasi lingkungan eksekusi pipeline Anda. Lingkungan eksekusi default memiliki batasan berikut:

• Spesifikasi resource instans: 4 vCPU, memori 8 GB.

• Disk space sementara: 10 GB.

• Timeout eksekusi tugas: 15 menit.

• Batasan wilayah: Penerapan templat langsung dan sumber kode GitHub menggunakan wilayah Singapura di luar Tiongkok. Gitee, GitLab publik, dan Codeup menggunakan wilayah Tiongkok (Hangzhou).

• Batasan jaringan: Alamat IP tetap dan Blok CIDR tidak didukung. Akses ke situs web tertentu menggunakan Daftar putih alamat IP tidak didukung. Akses ke resource dalam VPC Anda tidak didukung.

Lingkungan eksekusi khusus

Custom Environment menjalankan tugas pipeline di akun Anda dan menyediakan lebih banyak opsi kustomisasi. Berdasarkan otorisasi Anda, Application Center sepenuhnya mengelola tugas dalam lingkungan eksekusi khusus dan menjadwalkan instans Function Compute di akun Anda untuk menjalankan pipeline secara real time. Seperti lingkungan eksekusi default, lingkungan eksekusi khusus sepenuhnya serverless. Anda tidak perlu mengelola infrastruktur dasar.

Custom Environment menyediakan opsi kustomisasi berikut:

• Wilayah dan jaringan: Anda dapat menentukan wilayah dan VPC untuk lingkungan eksekusi guna mendukung skenario seperti mengakses repositori kode jaringan pribadi, repositori artefak, repositori image, dan server Maven pribadi. Untuk informasi lebih lanjut tentang wilayah yang didukung, lihat Wilayah.

• Spesifikasi resource instans: Anda dapat menentukan spesifikasi CPU dan memori untuk lingkungan eksekusi. Misalnya, tentukan instans yang lebih besar untuk mempercepat proses build.

  Catatan

  Rasio vCPU terhadap memori dalam GB harus berada di antara 1:1 hingga 1:4.

• Persistensi penyimpanan: Anda dapat menentukan konfigurasi mount NAS dan OSS. Misalnya, mount sistem file NAS untuk caching file guna mempercepat proses build.

• Log: Anda dapat menentukan proyek SLS dan Logstore untuk persistensi log eksekusi pipeline.

• Timeout: Anda dapat menyesuaikan timeout eksekusi untuk tugas pipeline. Nilai default adalah 600 detik, dan maksimum adalah 86.400 detik.

YAML

Serverless Application Center terintegrasi erat dengan tool developer Serverless Devs. Anda dapat menggunakan file deskripsi resource Serverless Devs untuk mendeklarasikan konfigurasi resource aplikasi Anda. File deskripsi resource default bernama s.yaml, tetapi Anda dapat menentukan nama file lain. Setelah menentukan file deskripsi resource, Anda dapat menggunakannya dalam pipeline dengan dua cara:

• Saat menggunakan plugin deployment @serverless-cd/s-deploy, plugin tersebut secara otomatis menggunakan file deskripsi resource yang ditentukan untuk deployment. Ini dilakukan dengan menambahkan perintah -t/--template ke instruksi operasi Serverless Devs. Dalam contoh berikut, file YAML deskripsi resource yang ditentukan adalah demo.yaml, sehingga perintah yang dijalankan oleh plugin adalah s deploy -t demo.yaml.

- name: deploy
  context:
    data:
      deployFile: demo.yaml
      steps:
      - plugin: '@serverless-cd/s-setup'
      - plugin: '@serverless-cd/checkout'
      - plugin: '@serverless-cd/s-deploy'
  taskTemplate: serverless-runner-task

• Saat menggunakan skrip untuk eksekusi, Anda dapat mereferensikan nama file deskripsi resource tertentu dengan ${{ ctx.data.deployFile }}. Misalnya, kode contoh berikut menjalankan perintah `s plan` dengan file yang ditentukan jika file deskripsi resource disediakan. Jika tidak, perintah `s plan` dijalankan dengan file default `s.yaml`.

- name: pre-check
  context:
    data:
      steps:
      - run: s plan -t ${{ ctx.data.deployFile || s.yaml }}
      - run: echo "s plan finished."
  taskTemplate: serverless-runner-task

DingTalk Chatbot Notification Settings

Setelah mengaktifkan konfigurasi ini, konfigurasikan alamat Webhook, signature key, aturan notifikasi, dan pesan kustom robot DingTalk. Anda dapat mengelola secara terpusat tugas-tugas yang memerlukan notifikasi di sini, atau mengaktifkan notifikasi untuk setiap tugas secara terpisah melalui file YAML pipeline. Setelah menyelesaikan konfigurasi notifikasi secara keseluruhan di sini, Anda dapat memperhalus pengaturan notifikasi untuk setiap tugas di bagian Pipeline Details.

Variabel lingkungan pipeline

Di bagian Pipeline Environment Variables, klik Modify, pilih metode untuk mengonfigurasi lingkungan, selesaikan konfigurasi seperti dijelaskan di bawah, lalu klik Deploy.

• Edit menggunakan formulir (default)

  1. Klik +Add Variable.

  2. Konfigurasikan pasangan kunci-nilai untuk variabel lingkungan:

     • Variable: Kustom.

     • Value: Kustom.

• Edit menggunakan format JSON

  1. Klik Edit in JSON Format.

  2. Di kotak teks, masukkan pasangan kunci-nilai dalam format JSON sebagai berikut.

     {
         "key": "value"
     }

     Berikut adalah contohnya.

     {
         "REGION": "MY_REGION",
         "LOG_PROJECT": "MY_LOG_PROJECT"
     }

Variabel lingkungan tersebut berlaku dalam pipeline Serverless Devs. Anda dapat mereferensikannya di `s.yaml` menggunakan ${env(key)} atau dalam perintah shell menggunakan $Key. Berikut adalah contohnya.

vars:
  region: ${env(REGION)}
  service:
    name: demo-service-${env(prefix)}
    internetAccess: true
    logConfig:
      project: ${env(LOG_PROJECT)}
      logstore: fc-console-function-pre
    vpcConfig:
      securityGroupId: ${env(SG_ID)}
      vswitchIds:
        - ${env(VSWITCH_ID)}
      vpcId: ${env(VPC_ID)}

Detail pipeline

Di bagian Pipeline Details, Anda dapat mengonfigurasi alur pipeline dan menentukan pengaturan detail untuk tugas dan dependensinya dalam pipeline. Platform secara otomatis menghasilkan alur pipeline default, yang dapat Anda edit.

Pipeline dikelola menggunakan file YAML. Tersedia dua metode konfigurasi: Hosting on Platform dan Read from Repository .

Hosting on Platform

Secara default, file YAML pipeline di-host oleh platform. Artinya, konfigurasi dikelola secara terpusat di platform dan berlaku pada deployment berikutnya setelah pembaruan.

Read from Repository

File deskripsi YAML pipeline disimpan di repositori Git remote. Setelah Anda mengedit dan menyimpannya di Konsol, platform akan melakukan commit perubahan ke repositori Git Anda secara real time. Commit ini tidak memicu eksekusi pipeline. Saat suatu event di repositori kode Anda memicu pipeline, platform menggunakan file YAML pipeline dari repositori Git yang Anda tentukan untuk membuat dan menjalankan pipeline.

Anda dapat memilih Read from Repository di atas bagian Pipeline Details dan memasukkan nama file YAML, seperti yang ditunjukkan pada gambar berikut.

Bagian utama dari bagian Pipeline Details terdiri dari area alat pendukung di sebelah kiri dan area pengeditan YAML di sebelah kanan:

• Area pengeditan YAML: Anda dapat langsung mengedit file YAML pipeline untuk memodifikasi alur pipeline. Untuk informasi lebih lanjut, lihat Gunakan file YAML untuk menggambarkan pipeline.

• Area alat pendukung: Menyediakan alat bantu untuk pengeditan YAML, termasuk:

  • Process Preview: Menyediakan pratinjau visual dan kemampuan pengeditan sederhana untuk alur pipeline.

  • Task Template: Menyediakan serangkaian templat YAML untuk tugas umum.

Di pojok kanan atas bagian tersebut terdapat tiga tombol: Save, Full screen mode, dan Reset:

• Tombol Save menyimpan perubahan yang dilakukan pada file YAML di halaman dan menyinkronkannya ke file YAML pipeline.

• Tombol Full screen mode memperluas area pengeditan utama menjadi layar penuh.

• Tombol Reset membatalkan semua perubahan yang dilakukan sejak penyimpanan terakhir dan mengembalikannya ke kondisi awal.

Lihat riwayat eksekusi pipeline

Anda dapat mengklik versi eksekusi pipeline tertentu untuk melihat detailnya. Informasi ini memungkinkan Anda dengan cepat memeriksa log eksekusi dan status pipeline, sehingga memudahkan pemantauan progres atau pemecahan masalah.

Peningkatan runtime lingkungan build pipeline

Anda dapat mengatur versi runtime pipeline menggunakan plugin pipeline runtime-setup atau dengan memodifikasi variabel lingkungan dalam file deskripsi resource.