Red Hat Summit1.6. 기본 실행 파일에 컴파일된 Quarkus 애플리케이션 배포
Docker 빌드 전략을 사용하여 네이티브 Quarkus 애플리케이션을 OpenShift에 배포할 수 있습니다. Linux X86_64 운영 체제를 대상으로 하는 애플리케이션에 대한 기본 실행 파일을 생성해야 합니다. 호스트 운영 체제가 이와 다른 경우 Docker 또는 Podman과 같은 컨테이너 런타임을 사용하여 기본 Linux 실행 파일을 생성해야 합니다.
Quarkus 프로젝트에는 지침이 포함된 사전 생성된 Dockerfile이 포함되어 있습니다. 사용자 지정 Dockerfile을 사용하려면 src/main/docker 디렉터리에 또는 모듈 내의 모든 위치에 파일을 추가해야 합니다. 또한 quarkus.openshift.native-dockerfile 속성을 사용하여 Dockerfile의 경로를 설정해야 합니다.
사전 요구 사항
- Linux X86_64 운영 체제 또는 Podman 또는 Docker와 같은 OCI(Open Container Initiative) 호환 컨테이너 런타임
-
quarkus-openshift확장을 포함하는 Quarkus Maven 프로젝트를 준비합니다.
프로세스
oc를 사용하여 OpenShift에 로그인한 다음 Quarkus Maven 프로젝트가 포함된 디렉터리로 변경합니다.- 올바른 OpenShift 프로젝트 네임스페이스에서 작업 중인지 확인하려면 필요한 OpenShift 프로젝트로 전환을 참조하십시오.
application.properties파일에서 다음 속성을 구성합니다.Docker 빌드 전략을 설정합니다.
quarkus.openshift.build-strategy=docker
컨테이너 런타임을 설정합니다.
quarkus.native.container-build=true
(선택 사항) 신뢰할 수 없는 인증서를 사용하는 경우
KubernetesClient를 구성합니다.quarkus.kubernetes-client.trust-certs=true
(선택 사항) 서비스를 노출하여 OpenShift 경로를 생성합니다.
quarkus.openshift.route.expose=true
(선택 사항) 사용자 지정 Dockerfile의 경로를 설정합니다.
quarkus.openshift.native-dockerfile=<path_to_your_dockerfile>
다음 예제에서는
Dockerfile.custom-native의 경로를 보여줍니다.quarkus.openshift.jvm-dockerfile=src/main/docker/Dockerfile.custom-native
(선택 사항) 컨테이너 엔진을 지정합니다.
Podman을 사용하여 기본 실행 파일을 빌드하려면 다음을 수행합니다.
quarkus.native.container-runtime=podman
Docker를 사용하여 기본 실행 파일을 빌드하려면 다음을 수행합니다.
quarkus.native.container-runtime=docker
네이티브 실행 파일을 빌드하고 OpenShift에 애플리케이션을 배포합니다.
./mvnw clean package -Pnative -Dquarkus.kubernetes.deploy=true
검증
현재 OpenShift 프로젝트와 연결된 Pod 목록을 보려면 다음을 수행합니다.
oc get pods
애플리케이션 Pod의 로그 출력을 검색하려면 다음 명령을 입력합니다. 여기서 <
pod_name>은 애플리케이션 이름이 접두사가 지정된 최신 Pod의 이름입니다.oc logs -f <pod_name>
