24.3. Infinispan

Infinispan은 캐시된 데이터를 관리하기 위해 Jakarta Persistence 2.2와 호환 가능한 캐시 인터페이스를 제공하는 Java 데이터 그리드 플랫폼입니다.

jenkinsfile 기능 및 구성 옵션에 대한 자세한 내용은 jenkinsfile 설명서를 참조하십시오.

infinispan 하위 시스템은 JBoss EAP에 대한 캐싱 지원을 제공합니다. 이를 통해 이름이 지정된 캐시 컨테이너 및 캐시에 대한 런타임 지표를 구성하고 볼 수 있습니다.

관리형 도메인의 ha 또는 full-ha 프로필 또는 독립 실행형 서버에 대한 standalone-ha.xml 또는 standalone-full-ha.xml 구성 파일과 같은 고가용성 기능을 제공하는 구성을 사용하는 경우 infinispan 하위 시스템은 캐싱, 상태 복제 및 상태 배포 지원을 제공합니다. 고가용성이 아닌 구성에서 infinispan 하위 시스템은 로컬 캐싱 지원을 제공합니다.

캐시 컨테이너는 하위 시스템에서 사용하는 캐시의 리포지토리입니다. 각 캐시 컨테이너는 사용할 기본 캐시를 정의합니다.

JBoss EAP 7은 다음과 같은 기본 Infinispan 캐시 컨테이너를 정의합니다.

<subsystem xmlns="urn:jboss:domain:infinispan:7.0">
  <cache-container name="server" aliases="singleton cluster" default-cache="default" module="org.wildfly.clustering.server">
    <transport lock-timeout="60000"/>
    <replicated-cache name="default">
      <transaction mode="BATCH"/>
    </replicated-cache>
  </cache-container>
  <cache-container name="web" default-cache="dist" module="org.wildfly.clustering.web.infinispan">
    <transport lock-timeout="60000"/>
    <distributed-cache name="dist">
      <locking isolation="REPEATABLE_READ"/>
      <transaction mode="BATCH"/>
      <file-store/>
    </distributed-cache>
  </cache-container>
  <cache-container name="ejb" aliases="sfsb" default-cache="dist" module="org.wildfly.clustering.ejb.infinispan">
    <transport lock-timeout="60000"/>
    <distributed-cache name="dist">
      <locking isolation="REPEATABLE_READ"/>
      <transaction mode="BATCH"/>
      <file-store/>
    </distributed-cache>
  </cache-container>
  <cache-container name="hibernate" default-cache="local-query" module="org.hibernate.infinispan">
    <transport lock-timeout="60000"/>
    <local-cache name="local-query">
      <object-memory size="1000"/>
      <expiration max-idle="100000"/>
    </local-cache>
    <invalidation-cache name="entity">
      <transaction mode="NON_XA"/>
      <object-memory size="1000"/>
      <expiration max-idle="100000"/>
    </invalidation-cache>
    <replicated-cache name="timestamps" mode="ASYNC"/>
  </cache-container>
</subsystem>

각 캐시 컨테이너에 정의된 기본 캐시를 확인합니다. 예를 들어 웹 캐시 컨테이너는 dist 분산 캐시를 기본값으로 정의합니다. 따라서 웹 세션을 클러스터링할 때 dist 캐시가 사용됩니다.

기본 캐시 변경 및 추가 캐시 추가에 대한 자세한 내용은 캐시 컨테이너 구성에서 참조하십시오.

batch
/subsystem=infinispan/cache-container=web/distributed-cache=concurrent:add
/subsystem=infinispan/cache-container=web:write-attribute(name=default-cache,value=concurrent)
/subsystem=infinispan/cache-container=web/distributed-cache=concurrent/store=file:add
run-batch

<cache-container name="web" default-cache="concurrent" module="org.wildfly.clustering.web.infinispan">
  ...
  <distributed-cache name="concurrent">
      <file-store/>
  </distributed-cache>
</cache-container>

<subsystem xmlns="urn:jboss:domain:ejb3:5.0">
    <passivation-stores>
        <passivation-store name="infinispan" cache-container="ejb-cltest" max-size="10000"/>
    </passivation-stores>

    <remote cluster="ejb-cltest" connectors="http-remoting-connector" thread-pool-name="default"/>
</subsystem>

<subsystem xmlns="urn:jboss:domain:infinispan:7.0">
    ...
    <cache-container name="ejb-cltest" aliases="sfsb" default-cache="dist" module="org.wildfly.clustering.ejb.infinispan">
</subsystem>

@Resource(lookup = "java:jboss/infinispan/cache/foo/bar")
private org.infinispan.Cache<Integer, Object> cache;

@Resource(lookup = "java:jboss/infinispan/cache/foo/default")

@Resource(lookup = "java:jboss/infinispan/container/foo")
private org.infinispan.manager.EmbeddedCacheManager manager;

  <cache-container name="hibernate" default-cache="local-query" module="org.hibernate.infinispan">
    <transport lock-timeout="60000"/>
    <local-cache name="local-query">
      <object-memory size="1000"/>
      <expiration max-idle="100000"/>

Infinispan을 사용하여 JBoss EAP의 두 가지 방법으로 클러스터링을 구성할 수 있습니다. 애플리케이션에 가장 적합한 방법은 요구 사항에 따라 달라집니다. 각 모드에 따라 가용성, 일관성, 안정성 및 확장성 사이에는 장단점이 있습니다. 클러스터링 모드를 선택하기 전에 네트워크의 가장 중요한 기능을 확인하고 해당 요구 사항의 균형을 조정해야 합니다.

캐시 모드

동기 및 비동기 복제

복제는 동기 또는 비동기 모드에서 수행할 수 있으며 선택한 모드는 요구 사항과 애플리케이션에 따라 달라집니다.

<cache-container name="web" default-cache="scattered" module="org.wildfly.clustering.web.infinispan">
    ...
    <scattered-cache name="scattered" bias-lifespan="1800000"/>
    ...
</cache-container>

상태 전송은 기본 데이터 그리드와 클러스터형 캐시 기능입니다. 상태 전송이 없으면 노드가 클러스터에 추가되거나 제거되므로 데이터가 손실됩니다.

상태 전송은 캐시 멤버십 변경에 대한 응답으로 캐시의 내부 상태를 조정합니다. 이 변경은 노드가 클러스터에 참여하거나 나가는 경우 두 개 이상의 클러스터 파티션이 병합되거나 이러한 이벤트를 조합한 후에 자동으로 발생합니다. 아래에 설명된 대로 새 캐시에서 최대 상태의 상태를 수신해야 하므로 새로 시작한 캐시의 초기 상태 전송이 가장 비용이 높습니다.

timeout 속성을 사용하여 새로 시작된 캐시가 상태를 수신 대기하는 기간을 제어할 수 있습니다. 시간 초과 특성이 양수인 경우 캐시는 서비스 요청에 사용할 수 있도록 모든 초기 상태를 수신하도록 기다립니다. 지정된 시간 내에 상태 전송이 완료되지 않으면 기본값은 240000 밀리초이며 캐시에서 오류가 발생하고 시작을 취소합니다. 시간 초과 가 0 으로 설정되면 캐시를 즉시 사용할 수 있으며 백그라운드 작업 중에 초기 상태가 수신됩니다. 초기 상태 전송이 완료될 때까지 캐시가 아직 수신되지 않은 캐시 항목에 대한 모든 요청을 원격 노드에서 가져와야 합니다.

다음 명령을 사용하여 timeout 특성을 0 으로 설정할 수 있습니다.

/subsystem=infinispan/cache-container=server/CACHE_TYPE=CACHE/component=state-transfer:write-attribute(name=timeout,value=0)

상태 전송 동작은 캐시 모드에 따라 결정됩니다.

상태 전송은 기본적으로 메모리 내 및 영구 상태를 모두 전송하지만 구성에서 둘 다 비활성화할 수 있습니다. 상태 전송이 비활성화되면 ClusterLoader 를 구성해야 합니다. 그렇지 않으면 데이터가 캐시에 로드되지 않고 노드가 키의 소유자 또는 백업 소유자가 됩니다. 또한 배포 모드에서 상태 전송이 비활성화된 경우 키에 캐시에 소유자 사본보다 적은 경우가 있습니다.

infinispan 하위 시스템에는 async-operations,expiration,listener,persistence,remote-command,state-transfer 및 transport 스레드 풀이 포함되어 있습니다. 이러한 풀은 Infinispan 캐시 컨테이너에 대해 구성할 수 있습니다.

다음 표에는 infinispan 하위 시스템의 각 스레드 풀에 대해 구성할 수 있는 속성과 각각의 기본값이 나열되어 있습니다.

다음 구문을 사용하여 관리 CLI를 사용하여 Infinispan 스레드 풀을 구성합니다.

/subsystem=infinispan/cache-container=CACHE_CONTAINER_NAME/thread-pool=THREAD_POOL_NAME:write-attribute(name=ATTRIBUTE_NAME, value=ATTRIBUTE_VALUE)

다음은 서버 캐시 컨테이너의 지속성 스레드 풀에서 max-threads 값을 10 으로 설정하는 관리 CLI 명령의 예입니다.

/subsystem=infinispan/cache-container=server/thread-pool=persistence:write-attribute(name="max-threads", value="10")

Infinispan 캐시 및 캐시 컨테이너에 대한 런타임 통계는 모니터링 목적으로 활성화할 수 있습니다. 통계 수집은 성능상의 이유로 기본적으로 활성화되어 있지 않습니다.

통계 수집은 각 캐시 컨테이너, 캐시 또는 둘 다에 대해 활성화할 수 있습니다. 각 캐시의 statistics 옵션은 캐시 컨테이너의 옵션을 덮어씁니다. 캐시 컨테이너에 대한 통계 컬렉션을 활성화하거나 비활성화하면 자체를 명시적으로 지정하지 않는 한 해당 컨테이너의 모든 캐시가 설정을 상속합니다.

/subsystem=infinispan/cache-container=CACHE_CONTAINER:write-attribute(name=statistics-enabled,value=true)

/subsystem=infinispan/cache-container=CACHE_CONTAINER/CACHE_TYPE=CACHE:write-attribute(name=statistics-enabled,value=true)

/subsystem=infinispan/cache-container=CACHE_CONTAINER/CACHE_TYPE=CACHE:undefine-attribute(name=statistics-enabled)

Infinispan 클러스터는 데이터가 저장된 여러 노드에서 빌드됩니다. 여러 노드가 실패하는 경우 데이터 손실을 방지하기 위해 Infinispan은 여러 노드에 동일한 데이터를 복사합니다. 이 수준의 데이터 중복은 owner 특성을 사용하여 구성됩니다. 구성된 노드 수만큼 동시에 충돌하는 경우 Infinispan에 사용 가능한 데이터의 복사본이 있습니다.

그러나 클러스터에서 너무 많은 노드가 사라질 때 발생할 수 있는 치명적인 상황이 있습니다.

목표는 스플릿 블록 또는 여러 노드가 빠르게 충돌하여 잘못된 데이터가 사용자에게 반환되는 상황을 방지하는 것입니다.

/subsystem=infinispan/cache-container=web/distributed-cache=dist/component=partition-handling:write-attribute(name=enabled, value=true)

관리형 도메인의 모든 서버 그룹에 대해 원격 캐시를 구성해야 합니다. 지정된 remote-cache-container에 대한 지표 컬렉션을 활성화하고 statistics- enabled 특성과 연결된 런타임 캐시를 활성화할 수 있습니다.

/subsystem=infinispan/remote-cache-container=foo:write-attribute(name=statistics-enabled, value=true)

/subsystem=infinispan/remote-cache-container=foo:read-attribute(name=connections)
/subsystem=infinispan/remote-cache-container=foo:read-attribute(name=active-connections)
/subsystem=infinispan/remote-cache-container=foo:read-attribute(name=idle-connections)

/subsystem=infinispan/remote-cache-container=foo:read-resource-description

/subsystem=infinispan/remote-cache-container=foo/remote-cache=bar.war:read-resource(include-runtime=true, recursive=true)
{
    "average-read-time" : 1,
    "average-remove-time" : 0,
    "average-write-time" : 2,
    "hits" : 9,
    "misses" : 0,
    "near-cache-hits" : 7,
    "near-cache-invalidations" : 8,
    "near-cache-misses" : 9,
    "near-cache-size" : 1,
    "removes" : 0,
    "time-since-reset" : 82344,
    "writes" : 8
}

/subsystem=infinispan/remote-cache-container=foo/remote-cache=bar.war:read-resource-description

/subsystem=infinispan/remote-cache-container=foo/remote-cache=bar.war:reset-statistics()

Red Hat Data Grid는 HTTP 세션과 같이 JBoss EAP의 애플리케이션별 데이터를 위한 외부 캐시 컨테이너로 사용할 수 있습니다. 이를 통해 애플리케이션과는 별도로 데이터 계층을 확장할 수 있으며 다양한 도메인에 있을 수 있는 다양한 JBoss EAP 클러스터가 동일한 Red Hat Data Grid 클러스터에서 데이터에 액세스할 수 있습니다. 또한 다른 애플리케이션은 Red Hat Data Grid에서 제공하는 캐시와 상호 작용할 수 있습니다.

다음 예제에서는 HTTP 세션을 외부화하는 방법을 보여줍니다. JBoss EAP의 독립 실행형 인스턴스와 관리형 도메인 모두에 적용됩니다.

원격 캐시 컨테이너 보안

SSL을 사용하여 원격 Red Hat Data Grid 인스턴스와의 통신을 보호할 수 있습니다. 이 작업은 JBoss EAP 인스턴스에서 remote-cache-container 를 구성하고 활성 보안 영역을 사용하도록 Red Hat Data Grid 인스턴스의 hotrod 커넥터를 조정하여 수행됩니다.

이 지침은 이전의 세션을 외부화하는 방법을 나타냅니다. JBoss EAP 7.2는 elytron 하위 시스템과 통합된 HotRod 프로토콜을 기반으로 사용자 지정 최적화된 캐시 저장소를 도입했습니다. HTTP 세션을 Red Hat Data Grid로 외부화하는 방법에 설명된 대로 새로운 핫로드 저장소를 사용하는 것이 좋습니다.

HTTP 세션을 외부화하려면 다음을 수행합니다.