Vì sao chiến lược phiên bản API quan trọng

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

Giới thiệu về phiên bản API

Giới thiệu phiên bản

Azure API Management

Nền tảng phiên bản API

Ẩn dụ phiên bản

  • Dùng khi thay đổi phá vỡ có thể gây rối cho hành khách

  • Khi tuyến mới đang xây, hành khách vẫn dùng tuyến cũ

  • Bản sửa giống bảo trì trên cùng tuyến

    • Sửa ray, thêm biển báo, làm êm chuyến đi

  • Trong APIM:

    • Phiên bản nằm trong một bộ phiên bản
    • Bản sửa cho phép chỉnh, thử, và đánh dấu một bản là hiện tại
Azure API Management

Cách hiển thị phiên bản

  • Hỗ trợ 3 cách hiển thị phiên bản:
    • Khai báo phiên bản trong đường dẫn URL
    • Chỉ định phiên bản trong header yêu cầu
    • Chỉ định phiên bản trong query string URL
  • Cần nhất quán chiến lược phiên bản

Phiên bản trong đường dẫn URL

Phiên bản trong header

Phiên bản trong query string

Azure API Management

Phiên bản vs bản sửa

Phiên bản vs bản sửa

Azure API Management

Phát hành canary

Phát hành canary

  • Kết quả:
    • Phản hồi tốt -> đánh dấu bản sửa là hiện tại
    • Xấu -> quay lại bản sửa trước

  • Như thử món trong bếp: phục vụ công thức mới cho vài bàn trước

  • Trong APIM:

    • Tạo bản sửa mới và thử nghiệm riêng tư
    • Mở cho nhóm người dùng giới hạn (sản phẩm pilot hoặc một phần người gọi)
    • Trỏ tới bản sửa cụ thể qua URL đặc biệt kèm số bản sửa

  • Ẩn dụ đường sắt: người thử đi trên “đường bảo trì” mà không ảnh hưởng tuyến chính

Azure API Management

Khái niệm chính cần nhớ

  • Khi nào dùng phiên bản so với bản sửa
  • Cấu hình sơ đồ phiên bản
  • Triển khai tiến/lùi thay đổi

Quản lý API

Azure API Management

Ayo berlatih!

Azure API Management

Preparing Video For Download...