Đối chiếu tổ chức

Quy trình đối chiếu 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 for Private Cloud hiện có vào API hub. Thông thường, bạn 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ộ các đị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 sử dụng 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 sử dụng lại ngay lập tức

Trình tự này 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 chiếu

Để đối chiếu một tổ chức, bạn phải sửa đổi tệp cấu hình của trình kết nối 2 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 sử dụng.
Khởi động lại dịch vụ trình kết nối uapim.
Chọn sử dụng tổ chức hiện tại bằng cách khôi phục cá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 sử dụng 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 ngừ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 (Chọn không sử dụng organization1):

{
  "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 sử dụng):

Áp dụng thay đổi bằng cách khởi động lại trình kết nối Apigee API Hub for Private Cloud:
```
apigee-service edge-uapim-connector restart
```

Chọn sử dụng 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 vào các chủ đề Pub/Sub. Để báo hiệu cho trình kết nối bắt đầu đồ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 (Chọn sử dụng organization1):
```
{
  "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 một lần nữa để kích hoạt quá trình đồng bộ hoá lại siêu dữ liệu đầy đủ:
```
apigee-service edge-uapim-connector restart
```

Trình kết nối hiện thực hiện thao tác chọn sử dụng đầy đủ 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 chiếu

Chọn không sử dụng tổ chức (Xoá chủ đề Pub/Sub)

Chọn sử dụng tổ chức (Khôi phục chủ đề Pub/Sub)

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