Quarkus 및 AMQ Online을 사용하는 Red Hat OpenShift 플랫폼의 클라우드 네이티브 메시징

안녕하세요 여러분! 여기 있습니다 - Quarkus 시리즈의 마지막 게시물입니다! (그나저나 웹 세미나를 시청해 보세요. "이것이 Quarkus입니다. Kubernetes 네이티브 Java 프레임워크입니다.". 처음부터 시작하거나 기성 솔루션을 전송하는 방법을 알려 드리겠습니다)

В 이전 이 게시물에서는 Java 애플리케이션 현대화의 결과로 얻은 개선 사항을 정량화하는 데 사용할 수 있는 관련 도구를 살펴보았습니다.

버전 0.17.0부터, 쿼쿠스 Advanced Message Queuing Protocol(AMQP)은 애플리케이션이나 조직 간에 비즈니스 메시지를 전송하기 위한 개방형 표준입니다.

레드햇 AMQ 온라인 오픈소스 프로젝트를 기반으로 구축된 서비스입니다. 엔마세 플랫폼 기반 메시징 메커니즘 구현 Red Hat OpenShift. 작동 방식에 대한 자세한 내용은 다음을 참조하세요. 여기 (EN). 오늘은 AMQ Online과 Quarkus를 결합하여 두 가지 새로운 메시징 기술을 사용하여 최신 OpenShift 기반 메시징 시스템을 구축하는 방법을 보여 드리겠습니다.

OpenShift 플랫폼에 AMQ Online을 이미 배포했다고 가정합니다(그렇지 않은 경우 다음을 참조하세요). 설치 설명서).

먼저 반응형 메시징을 사용하는 간단한 주문 처리 시스템이 될 Quarkus 애플리케이션을 만듭니다. 이 애플리케이션에는 고정된 간격으로 메시지 대기열에 주문을 보내는 주문 생성기와 대기열의 메시지를 처리하고 브라우저에서 볼 수 있는 확인 메시지를 생성하는 주문 프로세서가 포함됩니다.

애플리케이션을 만든 후에는 메시징 시스템 구성을 애플리케이션에 포함하고 AMQ Online을 사용하여 시스템에 필요한 리소스를 프로비저닝하는 방법을 보여 드리겠습니다.

Quarkus 앱

Quarkus 애플리케이션은 OpenShift에서 실행되며 프로그램의 수정된 버전입니다. amqp-빠른 시작. 클라이언트 측의 전체 예를 찾을 수 있습니다. 여기에.

주문 생성기

생성기는 5초마다 증가하는 주문 ID를 "주문" 주소로 단조롭게 보냅니다.

@ApplicationScoped
public class OrderGenerator {
 
    private int orderId = 1;
 
    @Outgoing("orders")
    public Flowable<Integer> generate() {
        return Flowable.interval(5, TimeUnit.SECONDS)
        .map(tick -> orderId++);
    }
}

주문 처리자

주문 처리기는 훨씬 더 간단합니다. 확인 ID를 "확인" 주소로 반환하기만 하면 됩니다.

@ApplicationScoped
public class OrderProcessor {
    @Incoming("orders")
    @Outgoing("confirmations")
    public Integer process(Integer order) {
        // Идентификатор подтверждения равен удвоенному идентификатору заказа <img draggable="false" class="emoji" alt=":-)" src="https://s.w.org/images/core/emoji/11.2.0/svg/1f642.svg">
        return order * 2;
    }
}

확인 자료

확인 리소스는 애플리케이션에서 생성된 확인을 나열하기 위한 HTTP 엔드포인트입니다.

@Path("/confirmations")
public class ConfirmationResource {
 
    @Inject
    @Stream("confirmations") Publisher<Integer> orders;
 
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "hello";
    }
 
 
    @GET
    @Path("/stream")
    @Produces(MediaType.SERVER_SENT_EVENTS)
    public Publisher<Integer> stream() {
        return orders;
    }
}

조정

AMQ Online에 연결하려면 애플리케이션에 Quarkus 커넥터 구성, AMQP 엔드포인트 정보 및 클라이언트 자격 증명과 같은 일부 구성 데이터가 필요합니다. 물론 모든 구성 데이터를 한 곳에 보관하는 것이 더 좋지만 Quarkus 애플리케이션 구성에 가능한 옵션을 보여주기 위해 의도적으로 데이터를 분리할 것입니다.

커넥터

애플리케이션 속성 파일을 사용하여 컴파일 타임에 커넥터 구성을 제공할 수 있습니다.

mp.messaging.outgoing.orders.connector=smallrye-amqp
mp.messaging.incoming.orders.connector=smallrye-amqp

일을 단순하게 유지하기 위해 "주문" 주소에 대해서만 메시지 대기열을 사용하겠습니다. 그리고 우리 애플리케이션의 "확인" 주소는 메모리의 대기열을 사용합니다.

AMQP 엔드포인트

컴파일 타임에는 AMQP 엔드포인트의 호스트 이름과 포트 번호를 알 수 없으므로 삽입해야 합니다. 엔드포인트는 AMQ Online에서 생성된 configmap에서 설정할 수 있으므로 애플리케이션 매니페스트의 환경 변수를 통해 엔드포인트를 정의합니다.

spec:
  template:
    spec:
      containers:
      - env:
        - name: AMQP_HOST
          valueFrom:
            configMapKeyRef:
              name: quarkus-config
              key: service.host
        - name: AMQP_PORT
          valueFrom:
            configMapKeyRef:
              name: quarkus-config
              key: service.port.amqp

신임장

서비스 계정 토큰은 OpenShift에 대한 애플리케이션을 인증하는 데 사용될 수 있습니다. 이렇게 하려면 먼저 포드의 파일 시스템에서 인증 토큰을 읽는 사용자 지정 ConfigSource를 생성해야 합니다.

public class MessagingCredentialsConfigSource implements ConfigSource {
    private static final Set<String> propertyNames;
 
    static {
        propertyNames = new HashSet<>();
        propertyNames.add("amqp-username");
        propertyNames.add("amqp-password");
    }
 
    @Override
    public Set<String> getPropertyNames() {
        return propertyNames;
    }
 
    @Override
    public Map<String, String> getProperties() {
        try {
            Map<String, String> properties = new HashMap<>();
            properties.put("amqp-username", "@@serviceaccount@@");
            properties.put("amqp-password", readTokenFromFile());
            return properties;
        } catch (IOException e) {
            throw new UncheckedIOException(e);
        }
    }
 
    @Override
    public String getValue(String key) {
        if ("amqp-username".equals(key)) {
            return "@@serviceaccount@@";
        }
        if ("amqp-password".equals(key)) {
            try {
                return readTokenFromFile();
            } catch (IOException e) {
                throw new UncheckedIOException(e);
            }
        }
        return null;
    }
 
    @Override
    public String getName() {
        return "messaging-credentials-config";
    }
 
    private static String readTokenFromFile() throws IOException {
        return new String(Files.readAllBytes(Paths.get("/var/run/secrets/kubernetes.io/serviceaccount/token")), StandardCharsets.UTF_8);
    }
}

애플리케이션 빌드 및 배포

애플리케이션을 실행 파일로 컴파일해야 하므로 GraalVM 가상 머신이 필요합니다. 이에 대한 환경을 설정하는 방법에 대한 자세한 내용은 해당 지침을 참조하세요. 쿼커스 가이드.

그런 다음 거기에 제공된 지침에 따라 소스를 다운로드하고 애플리케이션을 빌드 및 배포해야 합니다.

git clone https://github.com/EnMasseProject/enmasse-example-clients
cd enmasse-example-clients/quarkus-example-client
oc new-project myapp
mvn -Pnative -Dfabric8.mode=openshift -Dfabric8.build.strategy=docker package fabric8:build fabric8:resource fabric8:apply

이러한 명령 후에 애플리케이션이 배포되지만 AMQ Online에 필요한 메시징 리소스를 구성할 때까지는 시작되지 않습니다.

메시징 시스템 설정

이제 남은 것은 메시징 시스템에서 애플리케이션에 필요한 리소스를 설정하는 것입니다. 이렇게 하려면 다음을 만들어야 합니다. 1) 메시징 시스템 끝점을 초기화하기 위한 주소 공간 2) 애플리케이션에서 사용하는 주소를 구성하기 위한 주소 3) 사용자에게 클라이언트 자격 증명을 설정하라는 메시지를 보냅니다.

주소 공간

AMQ Online의 AddressSpace 개체는 연결 끝점과 인증 및 권한 부여 정책을 공유하는 주소 그룹입니다. 주소 공간을 만들 때 메시징 끝점이 노출되는 방법을 지정할 수 있습니다.

apiVersion: enmasse.io/v1beta1
kind: AddressSpace
metadata:
  name: quarkus-example
spec:
  type: brokered
  plan: brokered-single-broker
  endpoints:
  - name: messaging
    service: messaging
    exports:
    - name: quarkus-config
      kind: configmap

주소

주소는 메시지를 보내고 받는 데 사용됩니다. 각 주소에는 의미를 결정하는 유형과 예약할 리소스 수를 지정하는 계획이 있습니다. 주소는 예를 들어 다음과 같이 확인할 수 있습니다.

apiVersion: enmasse.io/v1beta1
kind: Address
metadata:
  name: quarkus-example.orders
spec:
  address: orders
  type: queue
  plan: brokered-queue

메시징 사용자

신뢰할 수 있는 응용 프로그램만 해당 주소로 메시지를 보내고 받을 수 있도록 하려면 메시징 시스템에서 사용자를 만들어야 합니다. 클러스터에서 실행되는 애플리케이션의 경우 OpenShift 서비스 계정을 사용하여 클라이언트를 인증할 수 있습니다. 예를 들어, "serviceaccount" 사용자는 다음과 같이 정의할 수 있습니다.

apiVersion: user.enmasse.io/v1beta1
kind: MessagingUser
metadata:
  name: quarkus-example.app
spec:
  username: system:serviceaccount:myapp:default
  authentication:
    type: serviceaccount
  authorization:
  - operations: ["send", "recv"]
    addresses: ["orders"]

애플리케이션을 구성할 수 있는 권한

AMQ Online에서 AMQP 엔드포인트 정보를 포함하는 데 사용한 configmap을 생성하려면 Role 및 RoleBinding을 설정해야 합니다.

---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: quarkus-config
spec:
  rules:
  - apiGroups: [ "" ]
    resources: [ "configmaps" ]
    verbs: [ "create" ]
  - apiGroups: [ "" ]
    resources: [ "configmaps" ]
    resourceNames: [ "quarkus-config" ]
    verbs: [ "get", "update", "patch" ]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: quarkus-config
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: quarkus-config
subjects:
- kind: ServiceAccount
  name: address-space-controller
  namespace: amq-online-infra

구성을 적용하는 방법

다음과 같이 메시징 시스템 구성을 적용할 수 있습니다.

cd enmasse-example-clients/quarkus-example-client
oc project myapp
oc apply -f src/main/resources/k8s/addressspace
oc apply -f src/main/resources/k8s/address

신청서 확인

애플리케이션이 시작되었는지 확인하기 위해 먼저 해당 주소가 생성되었고 활성화되었는지 확인하겠습니다.

until [[ `oc get address quarkus-example.prices -o jsonpath='{.status.phase}'` == "Active" ]]; do echo "Not yet ready"; sleep 5; done

그런 다음 애플리케이션 경로 URL을 확인해 보겠습니다(브라우저에서 이 주소를 열면 됩니다).

echo "http://$(oc get route quarkus-example-client -o jsonpath='{.spec.host}')/prices.html"

브라우저는 AMQ Online에서 메시지를 보내고 받을 때 티켓이 주기적으로 업데이트된다는 것을 표시해야 합니다.

합산

그래서 우리는 메시징에 AMQP를 사용하는 Quarkus 애플리케이션을 작성하고, Red Hat OpenShift 플랫폼에서 실행되도록 애플리케이션을 구성하고, AMQ Online 구성을 기반으로 해당 구성을 구현했습니다. 그런 다음 애플리케이션의 메시징 시스템을 초기화하는 데 필요한 매니페스트를 만들었습니다.

이것으로 Quarkus에 대한 시리즈가 끝났습니다. 앞으로 새롭고 흥미로운 일이 많이 있을 것이므로 계속 지켜봐 주시기 바랍니다!

출처 : habr.com