1

1

admin/caching_policy.rst

@@ -151,10 +151,39 @@ URL마다 별도로 TTL을 설정한다.
     $URL[*.jpg] & $ORGSTATUS[200], 3600
     $URL[/image/ad.jpg] & $ORGSTATUS[4xx], 10
 
+    // CDN v2.7.30 부터 지원
+    // 원본이 304 Not Modified로 응답할 경우 기존 콘텐츠의 TTL을 설정된 시간으로 설정한다.
+    $URL[*] & $ORGSTATUS[304], 1000
+
+
 ``$ORGSTATUS[ ]`` 표현의 값은 명시적인 원본 응답코드(200, 404) 또는 응답코드 그룹(2xx, 3xx, 4xx, 5xx)으로 설정 가능하다. 
 결합조건(&)을 지원하며, 부정조건(!)은 지원하지 않는다.
 
 
+.. _caching-policy-base:
+
+TTL 기준시점
+---------------------
+
+TTL을 결정하는 기준 시점을 설정한다. ::
+
+    # server.xml - <Server><VHostDefault><Options>
+    # vhosts.xml - <Vhosts><Vhost><Options>
+
+    <TTL Base="response">
+      ...
+   </TTL>
+
+
+
+-  ``Base``
+
+   -  ``response (기본)`` 원본으로부터 응답을 받은 시점에 TTL을 계산한다.
+
+   -  ``request`` 원본으로 요청을 보내는 시점에 TTL을 계산한다.
+
+
+
 .. _caching-policy-customttl-cron:
 
 TTL 만료시간 지정

admin/caching_purge.rst

@@ -207,6 +207,7 @@ HardPurge는 가장 강력한 삭제방법이지만 삭제한 컨텐츠는 원
     http://127.0.0.1:10040/command/hardpurge?url=...
 
 
+
 Purge 기본동작
 ====================================
 
@@ -223,6 +224,7 @@ Purge API가 호출될 때 컨텐츠 복구 여부를 선택한다. ::
    - ``Hard`` `HardPurge`_ 로 동작한다. (원본장애 시 복구하지 않음)
 
 
+
 .. _caching-purge-http-method:
 
 HTTP Method
@@ -237,6 +239,7 @@ HTTP Method는 기본적으로 Manager포트와 서비스(80)포트에서 동작
 서비스포트로 요청되는 HTTP Method의 :ref:`env-host` 에서 설정한다.
 
 
+
 .. _api-etc-post:
 
 POST 규격
@@ -250,3 +253,51 @@ POST 규격
    url=http://ston.winesoft.co.kr/sample.dat
     
 
+
+.. _caching-purge-async:
+
+동기/비동기 무효화
+====================================
+
+무효화 API의 기본동작은 동기방식이다. 
+설정을 통해 비동기로 동작하도록 설정할 수 있다. ::
+
+   #server.xml
+
+   <Cache>
+      <ControlAPI>sync</ControlAPI>
+   </Cache>
+
+
+-  ``<ControlAPI>`` 
+
+   - ``sync (기본)`` 무효화 API가 동기로 동작한다.
+
+   - ``async`` 무효화 API가 비동기로 동작한다.
+
+
+비동기로 동작하는 경우 무효화 요청은 큐에 저장되며 백그라운드로 수행된다. 
+
+.. note::
+
+   백그라운드 수행 이전이라도 접근되는 콘텐츠가 무효화 대상이라면 즉시 만료된다.
+
+
+비동기 무효화 동작의 세부 설정은 다음과 같다. ::
+
+   # server.xml - <Server><Cache>
+
+   <Performance>
+      <MaxAsyncCacheCtrl>100000</MaxAsyncCacheCtrl>
+      <PreCacheControl Max="5000" FirstOnly="OFF">ON</PreCacheControl>
+   </Performance>
+
+
+-  ``<MaxAsyncCacheCtrl> (기본: 100000)`` 비동기 무효화 최대 저장개수
+
+-  ``<PreCacheControl> (기본: ON)`` 접근되는 콘텐츠에 대해 저장된 비동기 무효화를 매칭한다.
+
+   -  ``Max (기본: 5000)`` 가상호스트별로 매칭할 비동기 무효화 최대 개수
+
+   -  ``FirstOnly (기본: OFF)`` ON인 경우 첫번째 미칭에 대해서 반영하며, OFF인 경우 전체 무효화를 검사해 가장 강한 표현을 반영한다.
+

admin/releasenote.rst

@@ -6,6 +6,27 @@ Appendix E: 릴리스 노트
 v2.7.x
 ====================================
 
+
+.. _release-enterprise-2-7-30:
+
+2.7.30 (2022.01.12)
+----------------------------
+
+**기능개선/정책변경**
+
+-  캐싱 - :ref:`caching-policy-base` 설정 기능
+-  캐싱 - 원본 ``304 Not Modified`` 응답 코드 TTL 별도 설정 기능
+-  캐싱관리 - :ref:`caching-purge-async` 기능추가
+-  WM - httpd 보안 취약점 개선을 위한 버전 업데이트 ``v2.4.41`` → ``v2.4.51``
+
+
+**버그수정**
+
+-  설정 변경 시 서비스 응답이 지연 될 수 있는 문제 수정
+-  낮은 확률로 ``500 Internal Error`` 가 응답 될 수 있는 문제 수정
+
+
+
 2.7.27 (2021.11.04)
 ----------------------------
 

admin/releasenote_enterprise.rst

@@ -12,6 +12,30 @@ Appendix F: 릴리스 노트  ``[Enterprise]``
 v21.x
 ====================================
 
+
+.. _release-enterprise-21-12-1:
+
+21.12.1 (2022.01.12)
+----------------------------
+
+**기능개선/정책변경**
+
+-  캐싱 - :ref:`caching-policy-base` 설정 기능
+-  캐싱 - 원본 ``304 Not Modified`` 응답 코드 TTL 별도 설정 기능
+-  캐싱관리 - :ref:`caching-purge-async` 기능추가
+-  이미지툴 - cropc 명령어 추가
+-  WM - httpd 보안 취약점 개선을 위한 버전 업데이트 ``v2.4.41`` → ``v2.4.51``
+
+
+**버그수정**
+
+-  설정 변경 시 서비스 응답이 지연 될 수 있는 문제 수정
+-  낮은 확률로 ``500 Internal Error`` 가 응답 될 수 있는 문제 수정
+-  MP4HLS - 캐싱 되지 않은 ts 파일을 요청 할 경우 ``415 Unsupported Media Type`` 에러가 응답되는 문제 수정
+
+
+
+
 21.12.0 (2021.12.03)
 ----------------------------
 

index.rst

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