Kuruluşu uzlaştırma

Mutabakat süreci, mevcut bir Apigee Edge for Private Cloud kuruluşu için tüm API meta verilerini (proxy'ler, ortamlar vb.) API Hub ile yeniden senkronize etmenize olanak tanır. Bu işlemi genellikle veri tutarsızlıklarından şüphelendiğinizde veya tüm API tanımlarının tamamen yeniden senkronize edilmesini istediğinizde kullanırsınız.

Bu süreçte iki temel işlem yapılır:

  • Bağlayıcının yapılandırmasını değiştirerek belirli bir kuruluşu geçici olarak kapsam dışında bırakma
  • Hemen yeniden etkinleştirme
Bu sıra, bağlayıcının söz konusu kuruluşun tüm meta verilerini tekrar tam olarak getirmesini ve yüklemesini tetikler.

Mutabakat adımları

Bir kuruluşu uzlaştırmak için bağlayıcının yapılandırma dosyasını iki kez değiştirir ve her değişiklikten sonra bağlayıcı hizmetini yeniden başlatırsınız.

  1. Mevcut yapılandırma dosyasının yedeğini alın.
  2. Yalnızca kapsamı dışında kalmayı seçmek istediğiniz kuruluştaki runtimeDataPubsub ve metadataPubsub'ı kaldırın.
  3. uapim bağlayıcı hizmetini yeniden başlatın.
  4. 1. adımda alınan yedeği geri yükleyerek mevcut kuruluşu etkinleştirin.
  5. uapim bağlayıcı hizmetini yeniden başlatın.
  1. Kuruluşu kapsam dışında bırakma (Pub/Sub konularını kaldırma)

    Bu adımda, kuruluşu Pub/Sub konularından kaldıracaksınız. Bağlayıcıya, hedef kuruluşun üst verilerini senkronize etmeyi geçici olarak durdurması için sinyal göndermek üzere kullanılır.

    • Bağlayıcı yapılandırmasını düzenleme: Bağlayıcı VM'sinde yapılandırma dosyasını açın: /opt/apigee/customer/application/uapim-connector.properties
    • conf_uapim_connector.uapim.settings.json dosyasını değiştirin: connectorConfig bölümünde, eşleştirmek istediğiniz kuruluş için (ör. organization1) runtimeDataPubsub ve metadataPubsub değerlerini kaldırın. serviceAccount ve pluginInstanceId'yi değiştirmeyin.
    • Değişiklikten önce (örnek):
      {
        "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"
      }
      
    • Değişiklikten sonra (Kuruluş1'in kapsam dışında kalmayı seçmesi):

      {
        "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"
      }
      
    • Bağlayıcı hizmetini yeniden başlatma (kapsamı dışında kalmayı seçme):

      Apigee API Hub for Private Cloud bağlayıcısını yeniden başlatarak değişikliği uygulayın:

      apigee-service edge-uapim-connector restart
      
  2. Kuruluşu etkinleştirme (Pub/Sub konularını geri yükleme)

    Bu adımda, kuruluşu Pub/Sub konularına geri yüklersiniz. Bağlayıcıya, meta verilerin yeni ve tam bir senkronizasyonunu başlatması için sinyal göndermek üzere kullanılır.

    • Bağlayıcı yapılandırmasını düzenleme: Yapılandırma dosyasını tekrar açın:/opt/apigee/customer/application/uapim-connector.properties
    • conf_uapim_connector.uapim.settings.json dosyasını değiştirin: connectorConfig bölümünde, eşleştirmeyi planladığınız kuruluş (ör. organization1) için runtimeDataPubsub ve metadataPubsub değerlerini geri yükleyin.
    • Değişiklikten sonra (1. kuruluşu etkinleştirme):
      {
        "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"
      }
      
  3. Geri yüklenen yapılandırma

    Bağlayıcı hizmetini yeniden başlatın (Etkinleştirme):

    Tam meta veri yeniden senkronizasyonunu tetiklemek için bağlayıcı hizmetini tekrar başlatın:

    apigee-service edge-uapim-connector restart
    

Bağlayıcı artık hedef kuruluş için tüm API meta verilerinin tam olarak etkinleştirilmesini sağlıyor. İlerleme durumunu curl localhost:8080/v1/uapim/status durum uç noktasını kullanarak izleyebilirsiniz.