1

1

admin/caching_policy.rst

@@ -537,6 +537,43 @@ QueryString-예외조건은 /svc/{가상호스트 이름}/querystring.txt에 설
 가급적 QueryString까지 붙은 명확한 URL로 :ref:`api-cmd-purge` API를 호출할 것을 권장한다.
 
 
+.. _caching-policy-applyquerystring-match:
+
+QueryString 재조합
+---------------------------
+
+.. note::
+
+    ``v2.8.4`` 부터 지원
+
+
+::
+
+    # server.xml - <Server><VHostDefault><Options>
+    # vhosts.xml - <Vhosts><Vhost><Options>
+
+    <ApplyQueryString>MATCH</ApplyQueryString>
+
+
+설정이 ``MATCH`` 인 경우 ``querystring.txt`` 를 참고하여 쿼리스트링을 재조합한다. ::
+
+   # ./svc/www.example.com/querystring.txt
+
+   # 쿼리스트링 중 token, key만 유지한다.
+   /private/personal.jsp, +token&key
+   /private/personal1.jsp, token&key
+
+   # 쿼리스트링 중 dummy, ts만 제거한다.
+   /image/ad.jpg, -dummy&ts
+
+
+-  ``/private/personal.jsp?key=a&name=b&token=c`` 라고 입력 했다면 ``/private/personal.jsp?token=c&key=a`` 로 캐싱키가 생성된다.
+
+-  ``/image/ad.jpg?var=1&dummy=000000&ts=3&name=john`` 라고 입력 했다면 ``/image/ad.jpg?var=1&name=john`` 로 캐싱키가 생성된다.
+
+-  조건(url)에 매칭되지 않을 경우 모든 ``ON`` 과 동일하게 동작한다.
+
+
 .. _caching-policy-vary-header:
 
 Vary 헤더

admin/origin.rst

@@ -360,7 +360,7 @@ API를 통해 가상호스트의 원본서버 배제/복구를 초기화한다.
 .. _origin-balancemode-url-suffix-ignore:
 
 ``Hash`` 분산 - Suffix 무시
----------------------
+-----------------------------------
 
 STON의 많은 기능은 기존 URL 뒤에 명령어를 붙이는 형식이다. ::
 
@@ -402,6 +402,29 @@ STON의 많은 기능은 기존 URL 뒤에 명령어를 붙이는 형식이다.
 ``<BalanceHashRules>`` 은 원본서버 선택에만 관여할 뿐 URL을 변형시키는 것은 아니다.
 
 
+.. _origin-retry:
+
+원본 재시도
+====================================
+
+캐싱요청이 실패했을 때(=트랜잭션 전개되지 않음) 시도하지 않은 다른 원본이 존재한다면 재시도한다. ::
+
+   # server.xml - <Server><VHostDefault><OriginOptions>
+   # vhosts.xml - <Vhosts><Vhost><OriginOptions>
+
+   <Retry>0</Retry>
+
+
+-  ``Retry (기본: 0회)``
+
+   -  ``0`` 재시도하지 않는다.
+   -  ``1 이상`` 원본 실패 시 설정된 횟수만큼 다른 서버로 요청을 재시도한다.
+   -  ``all`` 모든 서버 IP를 순차적으로 재시도한다.
+
+.. warning::
+
+   재시도하는 만큼 클라이언트 대기 시간이 지연되어 서비스 품질에 악영향을 줄 우려가 있음에 주의한다.
+
 
 세션 재사용
 ====================================

admin/releasenote.rst

@@ -7,9 +7,18 @@ Appendix E: 릴리스 노트
 v2.8.x
 ====================================
 
+.. _release-cdn-2-8-4:
+
+2.8.4 (2023.06.12)
+----------------------------
+
+-  :ref:`caching-policy-applyquerystring-match` 기능 추가
+-  :ref:`origin-retry` 기능 추가
+
+
 .. _release-cdn-2-8-3:
 
-2.8.3 (2023.05.2)
+2.8.3 (2023.05.02)
 ----------------------------
 
 -  더 큰 디스크 공간지원을 위한 :ref:`adv_topics_perf_securedisk` 고도화

index.rst

@@ -9,7 +9,7 @@ STON Edge Server 완벽 가이드
 
 
 :저자: STON 개발팀
-:최신버전: v2.8.3
+:최신버전: v2.8.4
 
 
 1부. STON 기본: 설정 배우기