Invalidate Cache ポリシーのデプロイエラーのトラブルシューティング

InvalidCacheResourceReference

エラー メッセージ

Edge UI または Edge 管理 API で API プロキシのデプロイに失敗し、次のエラー メッセージが表示されます。

    Error Deploying Revision revision_number to environment
    Invalid cache resource reference [cache_resource] in Step definition [invalidate_cache_policy_name]. Context Revision:[revision_number];APIProxy:[apiproxy_name];Organization:[organization];Environment:[environment]
    

エラー メッセージの例

Error Deploying Revision 2 to test
    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    

エラーのスクリーンショットの例

原因

API プロキシがデプロイされている環境に存在しない名前が InvalidateCache ポリシーの <CacheResource> 要素に設定されていると、このエラーが発生します。

診断

  1. InvalidateCache ポリシー名、InvalidateCache ポリシーの <CacheResource> 要素で使用されている無効なキャッシュ、エラーが発生した環境を特定します。これらはすべてエラー メッセージで確認できます。たとえば、次のエラーの場合、InvalidateCache-Token が InvalidateCache ポリシー名、tokencache が無効なキャッシュ名、test が環境名です。

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
        
  2. エラーが発生した InvalidateCache ポリシーの XML を調べて、<CacheResource> 要素に指定されたキャッシュ名がエラー メッセージの内容と一致しているかどうかを確認します。

    この例では、<CacheResource> 要素で指定されたキャッシュ名は tokencache です。

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <InvalidateCache async="false" continueOnError="false" enabled="true" name="InvalidateCache-Token">
            <DisplayName>InvalidateCache-Token</DisplayName>
            <Properties/>
            <CacheKey>
                <Prefix/>
                <KeyFragment ref=""/>
            </CacheKey>
            <CacheResource>tokencache</CacheResource>
            <Scope>Exclusive</Scope>
            <CacheContext>
                <APIProxyName/>
                <ProxyName>default</ProxyName>
                <TargetName>default</TargetName>
            </CacheContext>
            <PurgeChildEntries>false</PurgeChildEntries>
        </InvalidateCache>
        
  3. 手順 1 で確認したキャッシュが手順 1 で特定した環境に定義されているかどうか確認します。

    Edge UI で、[ADMIN] > [Environment] > [test] の順に移動し、[Environment Configuration] の [Caches] タブにキャッシュが表示されているかどうか確認します。キャッシュが存在しない場合、これがエラーの原因です。

    たとえば、次のスクリーンショットでは、tokencache という名前のキャッシュがありません。

    tokencache という名前のキャッシュが test 環境で定義されていないため、次のエラーが発生します。

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
        

解決策

API プロキシをデプロイする環境に、InvalidateCache ポリシーの <CacheResource> 要素で指定されたキャッシュを作成します。

キャッシュの作成方法については、環境キャッシュの作成と編集をご覧ください。

CacheNotFound

エラー メッセージ

Edge UI または Edge 管理 API による API プロキシのデプロイで、次のようなエラー メッセージが表示され、API プロキシのデプロイ ステータスが「部分的なデプロイ」になります。

    Error: Cache : cache_resource, not found in organization : organization__environment.

エラー メッセージの例

Error Cache : configCache, not found in organization : kkalckstein-eval__test
    

原因

エラー メッセージにあるキャッシュが特定の Message Processor コンポーネントに作成されていないと、このエラーが発生します。Message Processor は、Apigee Edge を介して API トラフィックのフローを処理する Edge 内部のコンポーネントです。

解決策

Private Cloud を利用している場合は、次の操作を行います。

  1. deployments 管理 API を実行して、steps.cache.CacheNotFound エラーが発生している Message Processor を特定します。

        curl -u $USERID:$USERPASSWORD http://:8080/v1/organizations//environments//apis//revisions//deployments

    出力例

      {
            "aPIProxy" : "TestCache",
            "environment" : [ {
              "configuration" : {
                "basePath" : "/",
                "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6",
                "steps" : [ ]
              },
              "name" : "prod",
              "server" : [ {
                "pod" : {
                  "name" : "pod1",
                  "region" : "us-central1"
                },
                "status" : "deployed",
                "type" : [ "message-processor" ],
                "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1"
              }, {
                "pod" : {
                  "name" : "pod1",
                  "region" : "us-central1"
                },
                "status" : "deployed",
                "type" : [ "message-processor" ],
                "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d"
              }, {
              "error" : "Cache : configCache, not found in organization : kkalckstein-eval__test",
              "errorCode" : "steps.cache.CacheNotFound",
              "status" : "error",
              "type" : [ "message-processor" ],
               "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d"
          },
          ...
              "state" : "deployed"
            } ],
            "name" : "2",
            "organization" : "kkalckstein-eval"
            ...
        
  2. エラー steps.cache.CacheNotFound を確認した Message Processor の UUID をメモします。この UUID に対応する Message Processor のホスト名 / IP アドレスを特定します。

  3. 特定の Message Processor にログインして、次のコマンドで再起動します。

    apigee-service edge-message-processor restart

Public Cloud を使用している場合、または Private Cloud で問題が解決しない場合は、Apigee サポートにご連絡ください。