Tham chiếu cấu hình gói luồng dùng chung

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Luồng dùng chung là chức năng có thể sử dụng lại, tương tự như proxy API. Phần lớn nội dung của tài liệu này tham chiếu sẽ quen thuộc nếu bạn đã làm quen với proxy API.

Nếu bạn đang tìm hiểu cách tạo luồng dùng chung, hãy bắt đầu với chủ đề Luồng chung có thể tái sử dụng.

Cấu trúc gói luồng dùng chung

Một gói luồng dùng chung bao gồm cấu hình sau:

Cấu hình cơ sở Chế độ cài đặt cấu hình chính. Xem phần Cấu hình cơ sở.
Chính sách Các tệp cấu hình có định dạng XML tuân thủ giản đồ chính sách Apigee Edge. Xem Chính sách.
Tài nguyên Các tập lệnh, tệp JAR và tệp XML được tham chiếu theo chính sách để thực thi logic tuỳ chỉnh. Xem Tài nguyên.
SharedFlows Các luồng được chia sẻ có trong gói này. Xem Luồng được chia sẻ.

Các thành phần trong bảng trên được xác định bởi các tệp cấu hình trong phần sau cấu trúc thư mục:

Tệp cấu hình và cấu trúc thư mục của gói luồng dùng chung

Phần này giải thích các tệp cấu hình và cấu trúc thư mục của luồng dùng chung gói.

Cấu hình cơ sở

Tệp cấu hình cơ sở nằm ở thư mục gốc của gói. Tên này là tên của gói.

/sharedflowbundle/traffic-management-shared.xml

Cấu hình cơ sở xác định nội dung của gói luồng dùng chung cùng với thông tin để theo dõi lịch sử sửa đổi của gói.

<SharedFlowBundle revision="2" name="traffic-management-shared">
    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
    <CreatedAt>1478637529218</CreatedAt>
    <CreatedBy>gladys@example.com</CreatedBy>
    <Description>Shared flow to moderate API traffic</Description>
    <DisplayName>traffic-management-shared</DisplayName>
    <LastModifiedAt>1481573374023</LastModifiedAt>
    <LastModifiedBy>gladys@example.com</LastModifiedBy>
    <Policies>
        <Policy>Auth-Flow-Callout</Policy>
        <Policy>Extract-Token</Policy>
        <Policy>Spike-Arrest</Policy>
    </Policies>
    <Resources>
        <Resource>jsc://extract-token.js</Resource>
    </Resources>
    <SharedFlows>
        <SharedFlow>default</SharedFlow>
    </SharedFlows>
</SharedFlowBundle>

Thuộc tính cấu hình cơ sở

Tên Mô tả Mặc định Bắt buộc?
SharedFlowBundle
name Tên của gói luồng dùng chung, phải là tên duy nhất trong một tổ chức. Chiến lược phát hành đĩa đơn các ký tự mà bạn được phép sử dụng trong tên được giới hạn ở các điều sau: A-Za-z0-9_- Không áp dụng Có
revision Số bản sửa đổi của cấu hình gói luồng dùng chung. Bạn không cần đặt rõ số sửa đổi vì Apigee Edge tự động theo dõi phiên bản bản sửa đổi luồng được chia sẻ. Không áp dụng Không

Phần tử cấu hình cơ sở

Tên Mô tả Mặc định Bắt buộc?
SharedFlowBundle
ConfigurationVersion Phiên bản của giản đồ cấu hình gói luồng dùng chung mà luồng chia sẻ này được sử dụng tuân thủ. Giá trị duy nhất được hỗ trợ hiện tại là largeVersion 4 và extraVersion 0. Chiến dịch này có thể được sử dụng trong tương lai để cho phép phát triển gói luồng dùng chung . 4 Không
CreatedAt và CreatedBy Ngày/giờ (theo thời gian bắt đầu của hệ thống) mà gói luồng dùng chung được tạo, cùng với địa chỉ email của người dùng đã tạo quảng cáo đó.
Description Nội dung mô tả bằng văn bản về quy trình được chia sẻ. Nếu được cung cấp, nội dung mô tả sẽ hiển thị bằng giao diện người dùng quản lý Edge. Không áp dụng Không
DisplayName Tên thân thiện với người dùng có thể khác với thuộc tính name của định cấu hình luồng chung. Không áp dụng Không
LastModifiedAt và LastModifiedBy Ngày/giờ (theo thời gian bắt đầu của hệ thống) mà gói luồng dùng chung được sửa đổi lần gần đây nhất, cùng với email của người dùng đã sửa đổi tệp đó.
Policies Danh sách các chính sách trong thư mục /policies của quy trình dùng chung này. Bạn thường sẽ chỉ nhìn thấy phần tử này khi luồng được chia sẻ được tạo bằng Edge giao diện người dùng quản lý. Đây chỉ là một "tệp kê khai" được thiết kế để giúp bạn nắm bắt thông tin nội dung của luồng được chia sẻ. Không áp dụng Không
Resources Danh sách tài nguyên (JavaScript, Python, Java, ValueTrack) trong /resources của luồng dùng chung này. Thông thường, bạn sẽ chỉ thấy phần tử này khi quy trình chung được tạo bằng giao diện người dùng quản lý Edge. Đây chỉ là một "tệp kê khai" được thiết kế để cho phép bạn xem nội dung của luồng được chia sẻ. Không áp dụng Không
SharedFlows Chỉ định quy trình chung có trong gói này.

Xin lưu ý rằng hiện tại, phần tử này chỉ hỗ trợ một phần tử con <SharedFlow>. Chỉ một Bạn có thể thêm luồng chung vào một gói luồng dùng chung.

 Không áp dụng Có

Luồng được chia sẻ

/sharedflowbundle/sharedflows/default.xml

Cấu hình SharedFlow xác định trình tự thực thi các phần tử luồng. <SharedFlow> <Bước> của phần tử mỗi phần tử con chỉ định một phần của trình tự, chẳng hạn như lời kêu gọi chính sách.

Cấu hình SharedFlow sau đây chỉ định ba chính sách sẽ được thực thi trong một từ trên xuống dưới (từ trái sang phải trong bảng điều khiển quản lý), trong đó có chính sách về chính sách Bắt giữ SIP và Chính sách về chú thích flow cuối cùng.

<SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
    <Step>
        <Name>Extract-Token</Name>
    </Step>
    <Step>
        <Name>Auth-Flow-Callout</Name>
    </Step>
</SharedFlow>

Thuộc tính cấu hình luồng chia sẻ

Tên Mô tả Mặc định Bắt buộc?
SharedFlow
name Tên của quy trình chung, phải là tên duy nhất trong một tổ chức. Chiến lược phát hành đĩa đơn các ký tự mà bạn được phép sử dụng trong tên được giới hạn ở các điều sau: A-Za-z0-9_- Không áp dụng Có
revision Số bản sửa đổi của cấu hình luồng dùng chung. Bạn không cần phải đặt rõ ràng số bản sửa đổi này, vì Apigee Edge tự động theo dõi bản sửa đổi hiện tại của quy trình chung. Không áp dụng Không

Phần tử cấu hình luồng chia sẻ

Tên Mô tả Mặc định Bắt buộc?
SharedFlow Xác định trình tự của các chính sách trong luồng dùng chung. Không áp dụng Có
Step Xác định một bước -- một giai đoạn trong trình tự của luồng. Không áp dụng Có
Name Chỉ định tên của mục được tham chiếu theo bước này. Giá trị của phần tử này phải là giống với mã nhận dạng duy nhất của mặt hàng, chẳng hạn như giá trị thuộc tính tên của một chính sách. Không áp dụng Có

Chính sách

/sharedflowbundle/policies

Như trong proxy API, trong gói luồng dùng chung, thư mục /policies chứa XML cấu hình cho tất cả các chính sách có sẵn được đính kèm vào quy trình chia sẻ trong gói. Các chính sách có chung một tập hợp con các phần tử, mặc dù tập hợp con này được bổ sung với các phần tử riêng đối với chính sách. Để biết thêm về cách thiết lập chính sách, hãy xem chủ đề về chính sách đó bạn muốn. Bạn cũng có thể xem những vấn đề này trong phần Tài liệu tham khảo về chính sách tổng quan.

Tài nguyên

/sharedflowbundle/resources

Tài nguyên là các tập lệnh, mã và phép biến đổi {8/} có thể đính kèm vào các luồng dùng chung chính sách. Các mã này xuất hiện trong phần Tập lệnh của trình chỉnh sửa luồng được chia sẻ trong phần quản lý Giao diện người dùng.

Xem Tệp tài nguyên để biết tài nguyên.

Đăng câu hỏi lên Diễn đàn của nhà phát triển Apigee.