조직 조정

조정 프로세스를 사용하면 기존 Apigee Edge for Private Cloud 조직의 모든 API 메타데이터 (프록시, 환경 등)를 API 허브에 다시 동기화할 수 있습니다. 일반적으로 데이터 불일치가 의심되거나 모든 API 정의의 전체 재동기화가 필요한 경우 이 프로세스를 사용합니다.

이 프로세스에는 두 가지 주요 작업이 포함됩니다.

커넥터의 구성을 수정하여 특정 조직을 일시적으로 선택 해제
즉시 다시 선택

이 시퀀스는 커넥터가 해당 조직의 모든 메타데이터를 다시 완전히 가져오고 업로드하도록 트리거합니다.

조정 단계

조직을 조정하려면 커넥터의 구성 파일을 두 번 수정하고 각 수정 후 커넥터 서비스를 다시 시작합니다.

현재 구성 파일을 백업합니다.
선택 해제하려는 조직에서 runtimeDataPubsub 및 metadataPubsub만 삭제합니다.
uapim 커넥터 서비스를 다시 시작합니다.
1단계에서 가져온 백업으로 원래 uapim 커넥터 설정을 복원하여 현재 조직을 선택합니다.
uapim 커넥터 서비스를 다시 시작합니다.

조직 선택 해제 (Pub/Sub 주제 삭제)

이 단계에서는 Pub/Sub 주제에서 조직을 삭제합니다. 커넥터가 대상 조직의 메타데이터 동기화를 중지하도록 일시적으로 신호를 보냅니다.

커넥터 구성 수정: 커넥터 VM에서 구성 파일을 엽니다. /opt/apigee/customer/application/uapim-connector.properties
conf_uapim_connector.uapim.settings.json 수정: connectorConfig 섹션에서 조정하려는 조직 (예: organization1)의 runtimeDataPubsub 및 metadataPubsub 값을 삭제합니다. serviceAccount 및 pluginInstanceId는 그대로 유지해야 합니다.

수정 전 (예):

{
  "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"
}

수정 후 (조직1 선택 해제):

{
  "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"
}

커넥터 서비스 다시 시작 (선택 해제):

프라이빗 클라우드용 Apigee API 허브 커넥터를 다시 시작하여 변경사항을 적용합니다.
```
apigee-service edge-uapim-connector restart
```

조직 선택 (Pub/Sub 주제 복원)

이 단계에서는 조직을 Pub/Sub 주제로 복원합니다. 커넥터가 메타데이터의 새로운 전체 동기화를 시작하도록 신호를 보냅니다.

커넥터 구성 수정: 구성 파일을 다시 엽니다./opt/apigee/customer/application/uapim-connector.properties
conf_uapim_connector.uapim.settings.json 수정: connectorConfig 섹션에서 조정하려는 조직 (예: organization1)의 runtimeDataPubsub 및 metadataPubsub 값을 복원합니다.

수정 후 (조직1 선택):

{
  "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"
}

복원된 구성

커넥터 서비스 다시 시작 (선택):

커넥터 서비스를 다시 시작하여 전체 메타데이터 재동기화를 트리거합니다.
```
apigee-service edge-uapim-connector restart
```

이제 커넥터가 대상 조직의 모든 API 메타데이터를 전체 선택합니다. 상태 엔드포인트(curl localhost:8080/v1/uapim/status)를 사용하여 진행 상황을 모니터링할 수 있습니다.

조직 조정

조정 단계

조직 선택 해제 (Pub/Sub 주제 삭제)

조직 선택 (Pub/Sub 주제 복원)

복원된 구성