Đối chiếu tổ chức

Quy trình điều chỉnh cho phép bạn đồng bộ hoá lại tất cả siêu dữ liệu API (proxy, môi trường, v.v.) cho một tổ chức Apigee Edge cho Đám mây riêng hiện có vào API Hub. Bạn thường sử dụng quy trình này nếu nghi ngờ dữ liệu không nhất quán hoặc cần đồng bộ hoá lại toàn bộ định nghĩa API.

Quy trình này bao gồm 2 hành động chính:

Tạm thời chọn không tham gia tổ chức cụ thể bằng cách sửa đổi cấu hình của trình kết nối
Chọn tham gia lại ngay lập tức

Trình tự này sẽ kích hoạt trình kết nối để thực hiện thao tác tìm nạp và tải lên toàn bộ siêu dữ liệu cho tổ chức đó một lần nữa.

Các bước điều chỉnh

Để điều chỉnh một tổ chức, bạn sửa đổi tệp cấu hình của trình kết nối hai lần và khởi động lại dịch vụ trình kết nối sau mỗi lần sửa đổi.

Sao lưu tệp cấu hình hiện tại.
Chỉ xoá runtimeDataPubsub và metadataPubsub khỏi tổ chức mà bạn muốn chọn không tham gia.
Khởi động lại dịch vụ trình kết nối uapim.
Chọn tham gia tổ chức hiện tại bằng cách khôi phục chế độ cài đặt trình kết nối uapim ban đầu vào bản sao lưu được thực hiện ở Bước 1.
Khởi động lại dịch vụ trình kết nối uapim.

Chọn không tham gia tổ chức (Xoá chủ đề Pub/Sub)

Trong bước này, bạn sẽ xoá tổ chức khỏi các chủ đề Pub/Sub. Tạm thời báo hiệu cho trình kết nối dừng đồng bộ hoá siêu dữ liệu cho tổ chức mục tiêu.

Chỉnh sửa cấu hình trình kết nối: Mở tệp cấu hình trên VM trình kết nối: /opt/apigee/customer/application/uapim-connector.properties
Sửa đổi conf_uapim_connector.uapim.settings.json: Trong phần connectorConfig, đối với tổ chức mà bạn dự định đối chiếu (ví dụ: organization1), hãy xoá các giá trị cho runtimeDataPubsub và metadataPubsub. Đảm bảo bạn giữ nguyên serviceAccount và pluginInstanceId.

Trước khi sửa đổi (ví dụ):

{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
      "metadataPubsub":"projects/p1/topics/md-topic-org1",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}

Sau khi sửa đổi (Tổ chức 1 chọn không tham gia):

{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "", 
      "metadataPubsub":"",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}

Khởi động lại dịch vụ trình kết nối (chọn không tham gia):

Áp dụng thay đổi bằng cách khởi động lại trình kết nối Apigee API Hub cho Đám mây riêng tư:
```
apigee-service edge-uapim-connector restart
```

Chọn tham gia tổ chức (Khôi phục chủ đề Pub/Sub)

Trong bước này, bạn sẽ khôi phục tổ chức cho các chủ đề Pub/Sub. Để báo hiệu cho trình kết nối bắt đầu quá trình đồng bộ hoá siêu dữ liệu mới và đầy đủ.
- Chỉnh sửa cấu hình trình kết nối: Mở lại tệp cấu hình:/opt/apigee/customer/application/uapim-connector.properties
- Sửa đổi conf_uapim_connector.uapim.settings.json: Trong phần connectorConfig, đối với tổ chức mà bạn dự định đối chiếu (ví dụ: organization1), hãy khôi phục các giá trị cho runtimeDataPubsub và metadataPubsub.
- Sau khi sửa đổi (Tổ chức 1 chọn sử dụng):
```
{
  "connectorConfig" : { 
    "organization1" : { 
      "runtimeDataPubsub" : "projects/p1/topics/rt-topic-org1", 
      "metadataPubsub":"projects/p1/topics/md-topic-org1",
      "serviceAccount": "mysa1@in.myfirstProject",
      "pluginInstanceId":"aaaa"
    }, 
    "organization2" : { 
      "runtimeDataPubsub" : "projects/p2/topics/rt-topic-org2", 
      "metadataPubsub":"projects/p2/topics/md-topic-org2",
      "serviceAccount": "mysa2@in.mySecondProject",
      "pluginInstanceId":"bbbbb"
    }
  },
  "runtimeDataPath":"/the/nfs/mounted/path",
  "managementServer": "hostname"
}
```
Cấu hình đã khôi phục

Khởi động lại dịch vụ trình kết nối (Chọn sử dụng):

Khởi động lại dịch vụ trình kết nối để kích hoạt quá trình đồng bộ hoá lại toàn bộ siêu dữ liệu:
```
apigee-service edge-uapim-connector restart
```

Giờ đây, trình kết nối sẽ thực hiện một quy trình chọn sử dụng đầy đủ đối với tất cả siêu dữ liệu API cho tổ chức mục tiêu. Bạn có thể theo dõi tiến trình bằng điểm cuối trạng thái: curl localhost:8080/v1/uapim/status.

Đối chiếu tổ chức

Các bước điều chỉnh

Chọn không tham gia tổ chức (Xoá chủ đề Pub/Sub)

Chọn tham gia tổ chức (Khôi phục chủ đề Pub/Sub)

Cấu hình đã khôi phục