1

STONmakers · Jul 12, 2020 · c716787 · c716787
1 parent 36645bb
commit c716787
Show file tree

Hide file tree

Showing 6 changed files with 63 additions and 10 deletions.
diff --git a/admin/access_control.rst b/admin/access_control.rst
@@ -201,10 +201,21 @@ Redirect된 요청에 대해서는 **302 Moved temporarily** 로 응답한다. :
    $HEADER[referer:], redirect, http://another-site.com
    !HEADER[referer], redirect, http://example.com#URL
 
-Redirect 할 때 클라이언트가 요청한 URL이 필요할 수 있다.
-이런 경우 ``#URL`` 키워드를 사용한다.
-
-HTTPS만을 지원하는 서비스의 경우 HTTP 요청에 대해 다음과 같이 ``$PROTOCOL[HTTP]`` 조건으로 HTTPS로 강제하도록 redirect시킬 수 있다. ::
+Redirect 시 클라이언트가 요청한 Host헤더나 URL이 필요할 수 있다.
+``#HOST`` , ``#URL`` 키워드를 사용한다. ::
 
+   # HTTP 요청이라면 HTTPS로 강제하도록 redirect시킨다.
    $PROTOCOL[HTTP], redirect, https://example.com#URL
 
+   # 모든 요청에 대해 8080 포트로 리다이렉트 시킨다.
+   $URL[/*], redirect, http://#HOST:8080#URL
+
+
+.. note::
+
+   ``#HOST`` 참조 시 포트는 제거한다. ::
+
+      Host: example.com:8080
+
+   위와 같이 요청된 경우 ``#HOST`` 의 값은 ``example.com`` 이다.
+
diff --git a/admin/caching_policy.rst b/admin/caching_policy.rst
@@ -438,7 +438,7 @@ QueryString-예외조건은 /svc/{가상호스트 이름}/querystring.txt에 설
 가급적 QueryString까지 붙은 명확한 URL로 :ref:`api-cmd-purge` API를 호출할 것을 권장한다.
 
 
-
+.. _caching-policy-vary-header:
 
 Vary 헤더
 ====================================

diff --git a/admin/caching_purge.rst b/admin/caching_purge.rst
@@ -2,10 +2,10 @@
 
 5장. Caching 무효화
 ******************
-
+
 이 장에서는 Caching된 콘텐츠를 무효화하는 방법에 대해 설명한다.
 업계용어로 Purge로 통칭하지만 다양한 상황과 환경으로 인해 세분화된 API가 필요하다.
-
+
 
 .. note::
 
@@ -25,6 +25,7 @@
    
    <Purge2Expire>NONE</Purge2Expire>
    <RootPurgeExpire>ON</RootPurgeExpire>
+   <RootHardPurge>ON</RootHardPurge>
    <ResCodeNoCtrlTarget>200</ResCodeNoCtrlTarget>
 
 -  ``<Purge2Expire> (기본: NONE)``
@@ -50,10 +51,17 @@
    - ``EXPIRE`` `Expire`_ 만 허용한다.
    - ``OFF`` 모든 `Purge`_ / `Expire`_ 를 금지한다.
 
+-  ``<RootHardPurge> (기본: ON)``
+
+   전체 콘텐츠( ``/*`` ) 에 대한 `HardPurge`_ 는 모든 캐싱을 삭제하기 때문에 매우 위험하다.
+
+   - ``ON`` 전체 콘텐츠의 `HardPurge`_ 를 허용한다.
+   - ``OFF`` 전체 콘텐츠의 `HardPurge`_ 를 금지한다.
+
+
 -  ``<ResCodeNoCtrlTarget> (기본: 200)``
 
-   `Purge`_ , `Expire`_ , `HardPurge`_ , `ExpireAfter`_ 의 대상객체가 없을 때의 
-   HTTP 응답코드를 설정한다.
+   `Purge`_ , `Expire`_ , `HardPurge`_ , `ExpireAfter`_ 의 대상객체가 없을 때의 HTTP 응답코드를 설정한다.
 
 
 대상 지정은 URL, 패턴 2가지로 표현한다. ::

diff --git a/admin/releasenote.rst b/admin/releasenote.rst
@@ -6,6 +6,23 @@ Appendix E: 릴리스 노트  ``[CDN]``
 v2.7.x
 ====================================
 
+2.7.7 (2020.7.12)
+----------------------------
+
+**기능개선/정책변경**
+
+ - HardPurge를 이용한 전체 콘텐츠 삭제 금지기능 ``<RootHardPurge>`` 추가 
+ - :ref:`access-control-vhost` - HTTP 요청의 Host헤더를 참조하는 ``#HOST`` 예약어 추가
+ - :ref:`adv_topics_volatile` 기능 추가
+ - 대량의 가상호스트 설정변경 성능 개선
+
+
+**버그수정**
+
+- 파일을 삭제 하는 중에 낮은 확률로 종료 되는 문제 수정
+- :ref:`caching-policy-vary-header` 사용시 HTTPS요청에 대해 가상호스트를 찾지 못하는 문제 수정
+
+
 2.7.6 (2020.6.10)
 ----------------------------
 

diff --git a/admin/releasenote_enterprise.rst b/admin/releasenote_enterprise.rst
@@ -6,6 +6,22 @@ Appendix F: 릴리스 노트  ``[Enterprise]``
 v20.x
 ====================================
 
+20.07.0 (2020.7.12)
+----------------------------
+
+**기능개선/정책변경**
+
+ - HardPurge를 이용한 전체 콘텐츠 삭제 금지기능 ``<RootHardPurge>`` 추가 
+ - :ref:`access-control-vhost` - HTTP 요청의 Host헤더를 참조하는 ``#HOST`` 예약어 추가
+ - 대량의 가상호스트 설정변경 성능 개선
+
+
+**버그수정**
+
+- 파일을 삭제 하는 중에 낮은 확률로 종료 되는 문제 수정
+- :ref:`caching-policy-vary-header` 사용시 HTTPS요청에 대해 가상호스트를 찾지 못하는 문제 수정
+
+
 20.06.0 (2020.6.10)
 ----------------------------
 

diff --git a/index.rst b/index.rst
@@ -9,7 +9,7 @@ STON Edge Server 완벽 가이드
 
 
 :저자: STON 개발팀
-:최신버전: ``[CDN]`` v2.7.6 / ``[Enterprise]`` v20.06.0
+:최신버전: ``[CDN]`` v2.7.7 / ``[Enterprise]`` v20.07.0
 
 
 1부. STON 기본: 설정 배우기
@@ -63,6 +63,7 @@ STON Edge Server 완벽 가이드
    admin/filesystem
    admin/adv_topics
    admin/enterprise
+   admin/prefetch
 
 
 5부. 부록