4.4. 사용자 정의 3scale API Management APIcast 정책

프로세스

1. 3scale API Management Operator를 사용하여 사용자 지정 정책 삽입
2. 기본 OpenShift 클러스터에 APIcast 게이트웨이를 배포하지 않는 경우 기본 OpenShift 클러스터의 내부 레지스트리에 대한 액세스를 설정합니다.
3. 3scale 2.15 APIcast OpenShift 템플릿을 다운로드합니다. https://raw.githubusercontent.com/3scale/3scale-amp-openshift-templates/2.15.0.GA/apicast-gateway/apicast.yml

4. 템플릿을 수정하려면 기본 이미지 디렉터리를 내부 레지스트리의 전체 이미지 이름으로 교체합니다.

   image: <registry>/<project>/amp-apicast:latest

5. OpenShift 템플릿을 사용하여 APIcast를 배포하여 사용자 지정 이미지를 지정합니다.

   $ oc new-app -f customizedApicast.yml

프로세스

1. 사용자 지정 정책이 포함된 디렉터리에 외부 Lua 라이브러리를 식별하는 파일을 추가합니다.

   파일 이름은 Roverfile 이어야 합니다. JSON to XML 사용자 지정 정책 예에서 Roverfile 에는 다음 내용이 있습니다.

   luarocks {
   	group 'production' {
   		module { 'xml2lua' },
   	}
   }

   Lua-rover 는 LuaRocks 관련 래퍼입니다. Lua-rover 는 종속성에 대한 전송 잠금을 제공합니다. LuaRocks는 Lua 모듈용 패키지 관리자입니다.

2. 사용자 지정 정책이 포함된 디렉터리에 lua-rover 잠금 파일을 추가합니다.

   파일 이름은 Roverfile.lock 이어야 합니다. JSON to XML 사용자 지정 정책 예에서 Roverfile.lock 에는 다음 내용이 있습니다.

   xml2lua 1.5-2||productionbash-4.4

   Roverfile 및 Roverfile.lock 을 함께 사용하면 APIcast 또는 3scale Operator가 종속 라이브러리를 가져올 수 있습니다.

3. 사용자 지정 정책을 정의하는 파일에서 Lua 종속성을 지정하는 행을 추가합니다. JSON to XML 사용자 지정 정책 예제에서는 다음 행을 지정합니다.

   local xml2lua = require("xml2lua")

4. 사용자 지정 정책을 빌드하는 데 사용하는 Dockerfile에서 Roverfile 및 Roverfile.lock 을 복사하고 rover install 을 실행합니다. JSON to XML 사용자 지정 정책 예제에서는 Dockerfile에 다음 행을 추가합니다.

   COPY Roverfile .
   COPY Roverfile.lock .
   
   RUN rover install --roverfile=/opt/app-root/src/Roverfile

   Dockerfile은 APIcast 또는 3scale Operator를 사용하여 정책을 빌드할 수 있습니다.

5. 사용자 지정 정책의 Makefile 에서 사용자 지정 정책에 대해 원하는 대로 빌드 대상을 지정합니다.

   예를 들어 빌드 대상은 다음과 같을 수 있습니다.

   TARGET_IMAGE="apicast/json_to_xml:latest"
   # IP="http://localhost:8080"
   
   build:
   	docker build . --build-arg IMAGE=registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.15 -t $(TARGET_IMAGE)