CloudFlow：Penanganan kesalahan

Gambaran Umum

Kesalahan yang diharapkan atau tidak terduga mungkin terjadi selama integrasi alur kerja CloudFlow. Dalam situasi ini, Anda dapat melanjutkan operasi pada status saat ini atau beralih ke status berikutnya. Kata kunci FnF.ALL adalah opsi khusus yang menangkap semua jenis kesalahan. Untuk informasi lebih lanjut tentang penggunaan kebijakan ulang dan tangkap, lihat bagian Ulang dan Tangkap.

Status yang mendukung penanganan kesalahan

Anda dapat menggunakan bidang Ulang dan Tangkap dalam definisi status berikut untuk menentukan kebijakan ulang dan tangkap serta menangani kesalahan dalam status tersebut.

• Tugas

• Paralel

• Peta

Ulang

Tangkap

Parameter OutputConstructor digunakan bersama dengan parameter Next. Jika terjadi kesalahan dalam suatu status, tidak ada keluaran yang dihasilkan dalam status tersebut. Alur kerja tidak dapat dilanjutkan meskipun beralih ke status berikutnya. Dalam hal ini, Anda dapat menggunakan parameter OutputConstructor untuk membangun keluaran dan menggunakannya sebagai masukan untuk status berikutnya.

Jenis kesalahan umum

Jenis kesalahan umum berikut terjadi ketika CloudFlow diintegrasikan dengan Function Compute. Untuk informasi tentang jenis kesalahan yang terjadi ketika CloudFlow diintegrasikan dengan layanan cloud lainnya, lihat dokumentasi integrasi layanan yang sesuai.

Contoh penanganan kesalahan umum

• Ulang Dasar

• Ulang Mundur

• Kebijakan Ulang Kompleks

Ulang dasar

Dalam contoh ini, jika terjadi kesalahan yang memenuhi kebijakan ulang MyCustomException1 selama pemanggilan integrasi layanan bernama my-error-handle-example, sistem akan mencoba hingga tiga kali ulang berdasarkan kebijakan ulang. Setelah tiga percobaan ulang habis, kesalahan saat ini memenuhi kebijakan tangkap MyCustomException1. Sistem membangun keluaran kesalahan kustom menggunakan parameter OutputConstructor dan menggunakan keluaran tersebut sebagai masukan untuk status ErrorCatchExit. Kemudian, alur kerja beralih ke status ErrorCatchExit.

Type: StateMachine
Name: ErrorHandleExample
SpecVersion: v1
Description: an example of basic error handling
StartAt: my-error-handle-example
States:
  - Type: Task
    Name: my-error-handle-example
    Action: FC:InvokeFunction
    TaskMode: RequestComplete
    Parameters:
      resourceArn: acs:fc:{regionId}:{accountId}:functions/myfunction/LATEST
      invocationType: Sync
      body: |
        xxx
    Retry:
      - Errors:
          - MyCustomException1
        Description: retry policy 1
        MaxAttempts: 3
        IntervalSeconds: 2
    Catch:
      - Errors:
          - MyCustomException1
        Description: catch policy 1
        OutputConstructor:
          ErrorCode: MyCustomException1
          ErrorMessage: MyCustomException1
        Next: ErrorCatchExit
    Next: SucceededExit
  - Type: Pass
    Name: ErrorCatchExit
    End: true
  - Type: Pass
    Name: SucceededExit
    End: true

Sebelum menyimpan file konfigurasi YAML, Anda harus memverifikasi validitas resourceArn. Ganti resourceArn dalam resourceArn:acs:fc:{regionId}:{accountId}:functions/myfunction/LATEST dengan ARN fungsi aktual Anda. Untuk informasi lebih lanjut tentang cara memperoleh ARN fungsi, lihat Memperoleh ARN Fungsi.

• regionId: ID wilayah tempat fungsi Anda berada, seperti cn-beijing atau cn-hangzhou.

• accountId: ID akun Alibaba Cloud Anda.

• myfunction: nama fungsi Anda.

• LATEST: versi fungsi. Anda dapat mengganti LATEST dengan versi atau alias tertentu sesuai kebutuhan bisnis Anda.

MyCustomException1: Anda dapat memodifikasi pesan kesalahan sesuai kebutuhan bisnis Anda.

Ulang mundur

Dalam contoh ini, jika terjadi kesalahan yang memenuhi kebijakan ulang MyCustomException2 atau MyCustomException3 selama pemanggilan integrasi layanan bernama my-error-handle-example, sistem akan mencoba hingga tiga kali ulang berdasarkan kebijakan ulang. Interval ulang awal adalah 5 detik. Sistem mencoba ulang pada interval 5, 10, 20, dan 40 detik berdasarkan laju mundur 2.0. Setelah tiga percobaan ulang habis, kesalahan saat ini memenuhi kebijakan tangkap MyCustomException2 atau MyCustomException3. Sistem membangun keluaran kesalahan kustom menggunakan parameter OutputConstructor dan menggunakan keluaran tersebut sebagai masukan untuk status ErrorCatchExit. Kemudian, alur kerja beralih ke status ErrorCatchExit.

Type: StateMachine
Name: ErrorHandleExample
SpecVersion: v1
Description: an example of backoff error handling
StartAt: my-error-handle-example
States:
  - Type: Task
    Name: my-error-handle-example
    Action: FC:InvokeFunction
    TaskMode: RequestComplete
    Parameters:
      resourceArn: acs:fc:{regionId}:{accountId}:functions/myfunction/LATEST
      body: xxx
    Retry:
      - Errors:
          - MyCustomException2
          - MyCustomException3
        Description: retry policy 2
        MaxAttempts: 3
        IntervalSeconds: 5
        BackoffRate: 2.0
    Catch:
      - Errors:
          - MyCustomException2
          - MyCustomException3
        Description: catch policy 2
        Next: ErrorCatchExit
    Next: SucceededExit
  - Type: Pass
    Name: ErrorCatchExit
    End: true
  - Type: Pass
    Name: SucceededExit
    End: true

Kebijakan ulang kompleks

Dalam contoh ini, kebijakan ulang dan kebijakan tangkap ditentukan untuk jenis kesalahan FnF.ALL. Jika terjadi kesalahan selain MyCustomException1, MyCustomException2, dan MyCustomException3 selama pemanggilan integrasi layanan bernama my-error-handle-example, sistem akan mencoba hingga tiga kali ulang berdasarkan kebijakan ulang. Interval ulang awal adalah 5 detik. Interval mundur terakhir berdasarkan laju mundur 2.0 adalah 40 detik. Namun, interval mundur maksimum diatur menjadi 30 detik. Sistem mencoba ulang pada interval 5, 10, 20, dan 30 detik. Setelah tiga percobaan ulang habis, kesalahan saat ini memenuhi kebijakan tangkap FnF.ALL. Tidak ada keluaran kesalahan kustom yang dibangun menggunakan parameter OutputConstructor. Secara default, alur kerja beralih ke status ErrorCatchExit.

Type: StateMachine
Name: ErrorHandleExample
SpecVersion: v1
Description: an example of error handling
StartAt: my-error-handle-example
States:
  - Type: Task
    Name: my-error-handle-example
    Action: FC:InvokeFunction
    TaskMode: RequestComplete
    Parameters:
      resourceArn: acs:fc:{regionId}:{accountId}:functions/myfunction/LATEST
      body: xxx
    Retry:
      - Errors:
          - MyCustomException1
        Description: retry policy 1
        MaxAttempts: 3
        IntervalSeconds: 2
      - Errors:
          - MyCustomException2
          - MyCustomException3
        Description: retry policy 2
        MaxAttempts: 3
        IntervalSeconds: 5
        BackoffRate: 2.0
      - Errors:
          - FnF.ALL
        Description: retry policy 2
        MaxAttempts: 3
        IntervalSeconds: 5
        BackoffRate: 2.0
        MaxBackoffSeconds: 30
    Catch:
      - Errors:
          - MyCustomException1
        Description: catch policy 1
        OutputConstructor:
         ErrorCode: MyCustomException1
          ErrorMessage: MyCustomException1
        Next: ErrorCatchExit
      - Errors:
          - MyCustomException2
          - MyCustomException3
        Description: catch policy 2
        Next: ErrorCatchExit
      - Errors:
          - FnF.ALL
        Description: catch policy 3
        Next: ErrorCatchExit
    Next: SucceededExit
  - Type: Pass
    Name: ErrorCatchExit
    End: true
  - Type: Pass
    Name: SucceededExit
    End: true