프로세스

1. 제공된 대로 다음 Dockerfile 콘텐츠를 복사합니다.

   # Use EAP 8 Builder image to create a JBoss EAP 8 server
   # with its default configuration
   
   FROM registry.redhat.io/jboss-eap-8/eap8-openjdk17-builder-openshift-rhel8:latest AS builder
   
   # Set up environment variables for provisioning. 1
   ENV GALLEON_PROVISION_FEATURE_PACKS org.jboss.eap:wildfly-ee-galleon-pack,org.jboss.eap.cloud:eap-cloud-galleon-pack
   ENV GALLEON_PROVISION_LAYERS cloud-default-config
   # Specify the JBoss EAP version  2
   ENV GALLEON_PROVISION_CHANNELS org.jboss.eap.channels:eap-8.0
   
   
   # Run the assemble script to provision the server.
   RUN /usr/local/s2i/assemble
   
   # Copy the JBoss EAP 8 server from the builder image to the runtime image.
   FROM registry.redhat.io/jboss-eap-8/eap8-openjdk17-runtime-openshift-rhel8:latest AS runtime
   
   # Set appropriate ownership and permissions.
   COPY --from=builder --chown=jboss:root $JBOSS_HOME $JBOSS_HOME
   
   # Steps to add:
   # (1) COPY the WAR/EAR to $JBOSS_HOME/standalone/deployments
   #       with the jboss:root user. For example:
   #     COPY --chown=jboss:root my-app.war $JBOSS_HOME/standalone/deployments 3
   # (2) (optional) server modification. You can modify EAP server configuration:
   #
   #       * invoke management operations. For example
   #
   #        RUN $JBOSS_HOME/bin/jboss-cli.sh --commands="embed-server,/system-property=Foo:add(value=Bar)"
   #
   #        First operation must always be embed-server.
   #
   #       * copy a modified standalone.xml in $JBOSS_HOME/standalone/configuration/
   #          for example
   #
   #      COPY --chown=jboss:root standalone.xml  $JBOSS_HOME/standalone/configuration
   
   # Ensure appropriate permissions for the copied files.
   RUN chmod -R ug+rwX $JBOSS_HOME

   1

   이미지 내에서 JBoss EAP Maven 플러그인에서 사용하는 MAVEN_MIRROR_URL 환경 변수를 지정할 수 있습니다. 자세한 내용은 Artifact 저장소 미러를 참조하십시오.

   2

   마이너 릴리스에 대해 이 Dockerfile을 업데이트할 필요가 없습니다. 특정 버전을 사용하려면 GALLEON_PROVISION_CHANNELS 환경 변수에 JBoss EAP 버전을 지정합니다. 자세한 내용은 환경 변수를 참조하십시오.

   3

   컨테이너에 WAR 파일을 포함하도록 복사한 Dockerfile을 수정합니다. 예를 들면 다음과 같습니다.

   COPY --chown=jboss:root <my-app.war> $JBOSS_HOME/standalone/deployments

   <myapp.war>를 이미지에 추가하려는 웹 아카이브 경로로 바꿉니다.

2. podman을 사용하여 애플리케이션 이미지를 빌드합니다.

   $ podman build -t my-app .

   명령이 실행되면 my-app 컨테이너 이미지를 OpenShift에 배포할 수 있습니다.

3. 다음 옵션 중 하나에 컨테이너 이미지를 업로드합니다.

   • OpenShift에서 액세스할 수 있는 내부 레지스트리입니다.
   • 빌드된 시스템에서 이미지를 직접 푸시하여 OpenShift 레지스트리입니다. 자세한 내용은 컨테이너 이미지를 Cryostat 4의 이미지 레지스트리로 내보내는 방법을 참조하십시오.
4. 레지스트리에서 이미지를 배포할 때 Helm 차트, Operator 또는 Deployment와 같은 배포 전략을 사용합니다. 선호하는 방법을 선택하고 요구 사항에 따라 전체 이미지 URL 또는 ImageStream을 사용합니다. 자세한 내용은 OpenShift에서 JBoss EAP 애플리케이션을 빌드 및 배포하기 위해 Helm 차트 사용을 참조하십시오.

프로세스

1. mvn 명령을 사용하여 Maven 프로젝트를 설정합니다. 명령은 프로젝트에 대한 디렉터리 구조와 pom.xml 구성 파일을 생성합니다.

   구문

   $ mvn archetype:generate \
   -DgroupId=${group-to-which-your-application-belongs} \
   -DartifactId=${name-of-your-application} \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

   예제

   $ mvn archetype:generate \
   -DgroupId=com.example.app \
   -DartifactId=simple-webapp-example \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

2. 애플리케이션 루트 디렉터리로 이동합니다.

   구문

   $ cd <name-of-your-application>

   예제

   $ cd simple-webapp-example

3. 생성된 pom.xml 파일의 내용을 다음 텍스트로 바꿉니다.

   <?xml version="1.0" encoding="UTF-8"?>
   
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.example.app</groupId>
     <artifactId>simple-webapp-example</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>war</packaging>
   
     <name>simple-webapp-example Maven Webapp</name>
     <!-- FIXME change it to the project's website -->
     <url>http://www.example.com</url>
   
     <properties>
       <maven.compiler.source>11</maven.compiler.source>
       <maven.compiler.target>11</maven.compiler.target>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       <version.maven.war.plugin>3.3.2</version.maven.war.plugin>
       <version.eap.plugin>1.0.0.Final-redhat-00014</version.eap.plugin>
       <version.server>8.0.0.GA-redhat-00009</version.server>
       <version.bom.ee>${version.server}</version.bom.ee>
     </properties>
   
   
     <repositories>
       <repository>
           <id>jboss</id>
           <url>https://maven.repository.redhat.com/ga/</url>
           <snapshots>
               <enabled>false</enabled>
           </snapshots>
       </repository>
     </repositories>
   
     <pluginRepositories>
       <pluginRepository>
           <id>jboss</id>
           <url>https://maven.repository.redhat.com/ga/</url>
           <snapshots>
               <enabled>false</enabled>
           </snapshots>
       </pluginRepository>
     </pluginRepositories>
   
     <dependencyManagement>
       <dependencies>
         <dependency>
           <groupId>org.jboss.bom</groupId>
           <artifactId>jboss-eap-ee-with-tools</artifactId>
           <version>${version.bom.ee}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
   
     <dependencies>
       <dependency>
         <groupId>jakarta.servlet</groupId>
         <artifactId>jakarta.servlet-api</artifactId>
         <scope>provided</scope>
       </dependency>
       <dependency>
         <groupId>org.wildfly.security</groupId>
         <artifactId>wildfly-elytron-auth-server</artifactId>
       </dependency>
     </dependencies>
   
   <build>
       <finalName>${project.artifactId}</finalName>
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-war-plugin</artifactId>
               <version>${version.maven.war.plugin}</version>
           </plugin>
           <plugin>
               <groupId>org.jboss.eap.plugins</groupId>
               <artifactId>eap-maven-plugin</artifactId>
               <version>${version.eap.plugin}</version>
               <configuration>
                   <channels>
                       <channel>
                           <manifest>
                               <groupId>org.jboss.eap.channels</groupId>
                               <artifactId>eap-8.0</artifactId>
                           </manifest>
                       </channel>
                   </channels>
                   <feature-packs>
                       <feature-pack>
                           <location>org.jboss.eap:wildfly-ee-galleon-pack</location>
                       </feature-pack>
                       <feature-pack>
                           <location>org.jboss.eap.cloud:eap-cloud-galleon-pack</location>
                       </feature-pack>
                   </feature-packs>
                   <layers>
                       <layer>cloud-server</layer>
                       <layer>elytron-oidc-client</layer>
                   </layers>
                   <galleon-options>
                           <jboss-fork-embedded>true</jboss-fork-embedded>
                   </galleon-options>
               </configuration>
               <executions>
                   <execution>
                       <goals>
                           <goal>package</goal>
                       </goals>
                   </execution>
               </executions>
           </plugin>
       </plugins>
   </build>
   </project>

   참고

   • < version.eap.plugin>1.0.0.Final-redhat-00014</version.eap.plugin >은 JBoss EAP Maven 플러그인의 예제 버전입니다. JBoss EAP Maven 플러그인 릴리스에 대한 자세한 내용은 Red Hat Maven 리포지토리를 참조하십시오. https://maven.repository.redhat.com/earlyaccess/all/org/jboss/eap/plugins/eap-maven-plugin/.

4. Java 파일을 저장할 디렉터리를 만듭니다.

   구문

   $ mkdir -p src/main/java/<path_based_on_artifactID>

   예제

   $ mkdir -p src/main/java/com/example/app

5. 새 디렉터리로 이동합니다.

   구문

   $ cd src/main/java/<path_based_on_artifactID>

   예제

   $ cd src/main/java/com/example/app

6. 다음 콘텐츠를 사용하여 SecuredServlet.java 파일을 생성합니다.

   package com.example.app;
   
   import java.io.IOException;
   import java.io.PrintWriter;
   import java.security.Principal;
   import java.util.ArrayList;
   import java.util.Collection;
   import java.util.Iterator;
   import java.util.List;
   import java.util.Set;
   
   import jakarta.servlet.ServletException;
   import jakarta.servlet.annotation.WebServlet;
   import jakarta.servlet.http.HttpServlet;
   import jakarta.servlet.http.HttpServletRequest;
   import jakarta.servlet.http.HttpServletResponse;
   import org.wildfly.security.auth.server.SecurityDomain;
   import org.wildfly.security.auth.server.SecurityIdentity;
   import org.wildfly.security.authz.Attributes;
   import org.wildfly.security.authz.Attributes.Entry;
   /**
    * A simple secured HTTP servlet. It returns the user name and
    * attributes obtained from the logged-in user's Principal. If
    * there is no logged-in user, it returns the text
    * "NO AUTHENTICATED USER".
    */
   
   @WebServlet("/secured")
   public class SecuredServlet extends HttpServlet {
   
       @Override
       protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
           try (PrintWriter writer = resp.getWriter()) {
   
           	Principal user = req.getUserPrincipal();
           	SecurityIdentity identity = SecurityDomain.getCurrent().getCurrentSecurityIdentity();
           	Attributes identityAttributes = identity.getAttributes();
           	Set <String> keys = identityAttributes.keySet();
           	String attributes = "<ul>";
   
           	for (String attr : keys) {
           		attributes += "<li> " +  attr + " : " + identityAttributes.get(attr).toString() + "</li>";
           	}
   
           	attributes+="</ul>";
           	writer.println("<html>");
           	writer.println("  <head><title>Secured Servlet</title></head>");
           	writer.println("  <body>");
           	writer.println("    <h1>Secured Servlet</h1>");
           	writer.println("    <p>");
           	writer.print(" Current Principal '");
           	writer.print(user != null ? user.getName() : "NO AUTHENTICATED USER");
           	writer.print("'");
           	writer.print(user != null ? "\n" + attributes : "");
           	writer.println("    </p>");
           	writer.println("  </body>");
           	writer.println("</html>");
           }
       }
   
   }

7. 애플리케이션 리소스를 보호하도록 애플리케이션의 web.xml 을 구성합니다.

   예제

   <?xml version="1.0" encoding="UTF-8"?>
   
   <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
       metadata-complete="false">
   
       <security-constraint>
           <web-resource-collection>
               <web-resource-name>secured</web-resource-name>
               <url-pattern>/secured</url-pattern>
           </web-resource-collection>
   
           <auth-constraint>
               <role-name>Users</role-name>
           </auth-constraint>
       </security-constraint>
   
       <login-config>
           <auth-method>OIDC</auth-method>
       </login-config>
   
       <security-role>
           <role-name>*</role-name>
       </security-role>
   </web-app>

   이 예에서는 사용자가 역할이 있는 사용자만 애플리케이션에 액세스할 수 있습니다.

프로세스

1. 애플리케이션 코드를 Git 리포지토리에 배포합니다.

2. OIDC 구성이 포함된 보안을 생성합니다.

   1. 다음 콘텐츠를 사용하여 oidc-secret.yaml 이라는 파일을 생성합니다.

      apiVersion: v1
      kind: Secret
      metadata:
        name: oidc-secret
      type: Opaque
      stringData:
        OIDC_PROVIDER_NAME: rh-sso
        OIDC_USER_NAME: demo
        OIDC_USER_PASSWORD: demo
        OIDC_SECURE_DEPLOYMENT_SECRET: mysecret

   2. 다음 명령을 사용하여 보안을 생성합니다.

      $ oc apply -f oidc-secret.yaml

3. 다음 콘텐츠를 사용하여 helm.yaml 이라는 파일을 생성합니다.

   build:
     uri: [URL TO YOUR GIT REPOSITORY]
   deploy:
     envFrom:
   	- secretRef:
       	  name: oidc-secret

4. JBoss EAP Helm 차트를 사용하여 예제 애플리케이션을 배포합니다.

   $ helm install eap-oidc-test-app -f helm.yaml jboss-eap/eap8

5. oidc-secret.yaml 파일에 환경 변수를 추가하여 OIDC 공급자 URL 및 애플리케이션 호스트 이름을 구성합니다.

   yaml
   stringData:
     ...
     OIDC_HOSTNAME_HTTPS: <host of the application>
     OIDC_PROVIDER_URL: https://<host of the SSO provider>/realms/JBossEAP

   OIDC_HOSTNAME_HTTPS 의 값은 다음 출력에 해당합니다.

   echo $(oc get route eap-oidc-test-app --template='{{ .spec.host }}')

   OIDC_PROVIDER_URL 값은 다음 출력에 해당합니다.

   echo https://$(oc get route sso --template='{{ .spec.host }}')/realms/JBossEAP

   OIDC_HOSTNAME_HTTP(S) 가 설정되지 않은 경우 경로 검색 시도가 수행됩니다. 경로 검색을 활성화하려면 OpenShift 사용자가 경로 리소스를 나열할 수 있어야 합니다. 예를 들어 routeview 역할을 생성하고 view 사용자와 연결하려면 다음 oc 명령을 사용합니다.

   $ oc create role <role-name> --verb=list --resource=route
   
   $ oc adm policy add-role-to-user <role-name> <user-name> --role-namespace=<your namespace>

6. oc apply -f oidc-secret.yaml 을 사용하여 시크릿을 업데이트합니다.

7. 애플리케이션을 다시 배포하여 OpenShift에서 새 환경 변수를 사용하는지 확인합니다.

   $ oc rollout restart deploy eap-oidc-test-app

검증

1. 브라우저에서 https://<eap-oidc-test-app route>/ 로 이동합니다.

   Red Hat build of Keycloak 로그인 페이지로 리디렉션됩니다.

2. 보안 서블릿에 액세스합니다.

3. 다음 인증 정보로 로그인합니다.

   username: demo
   password: demo

   보안 주체 ID가 포함된 페이지가 나타납니다.

프로세스

1. Single Sign-On 영역, 사용자 및 역할을 생성합니다.

2. Java keytool 명령을 사용하여 키 및 인증서를 생성합니다.

   keytool -genkeypair -alias saml-app -storetype PKCS12 -keyalg RSA -keysize 2048 -keystore keystore.p12 -storepass password -dname "CN=saml-basic-auth,OU=EAP SAML Client,O=Red Hat EAP QE,L=MB,S=Milan,C=IT" -ext ku:c=dig,keyEncipherment -validity 365

3. 키 저장소를 JKS(Java KeyStore) 형식으로 가져옵니다.

   keytool -importkeystore -deststorepass password -destkeystore keystore.jks -srckeystore keystore.p12 -srcstoretype PKCS12 -srcstorepass password

4. OpenShift에서 키 저장소에 대한 시크릿을 생성합니다.

   $ oc create secret generic saml-app-secret --from-file=keystore.jks=./keystore.jks --type=opaque

프로세스

1. mvn 명령을 사용하여 Maven 프로젝트를 설정합니다. 이 명령은 프로젝트에 대한 디렉터리 구조와 pom.xml 구성 파일을 둘 다 생성합니다.

   구문

   $ mvn archetype:generate \
   -DgroupId=${group-to-which-your-application-belongs} \
   -DartifactId=${name-of-your-application} \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

   예제

   $ mvn archetype:generate \
   -DgroupId=com.example.app \
   -DartifactId=simple-webapp-example \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

2. 애플리케이션 루트 디렉터리로 이동합니다.

   구문

   $ cd <name-of-your-application>

   예제

   $ cd simple-webapp-example

3. 생성된 pom.xml 파일의 내용을 다음 텍스트로 바꿉니다.

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.example.app</groupId>
     <artifactId>simple-webapp-example</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>war</packaging>
   
     <name>simple-webapp-example Maven Webapp</name>
     <!-- FIXME change it to the project's website -->
     <url>http://www.example.com</url>
   
     <properties>
       <maven.compiler.source>11</maven.compiler.source>
       <maven.compiler.target>11</maven.compiler.target>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       <version.maven.war.plugin>3.3.2</version.maven.war.plugin>
       <version.eap.plugin>1.0.0.Final-redhat-00014</version.eap.plugin>
       <version.server>8.0.0.GA-redhat-00009</version.server>
       <version.bom.ee>${version.server}</version.bom.ee>
     </properties>
   
     <repositories>
       <repository>
           <id>jboss</id>
           <url>https://maven.repository.redhat.com/ga/</url>
           <snapshots>
               <enabled>false</enabled>
           </snapshots>
       </repository>
     </repositories>
   
     <pluginRepositories>
       <pluginRepository>
           <id>jboss</id>
           <url>https://maven.repository.redhat.com/ga/</url>
           <snapshots>
               <enabled>false</enabled>
           </snapshots>
       </pluginRepository>
     </pluginRepositories>
   
     <dependencyManagement>
       <dependencies>
         <dependency>
           <groupId>org.jboss.bom</groupId>
           <artifactId>jboss-eap-ee-with-tools</artifactId>
           <version>${version.bom.ee}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
   
     <dependencies>
       <dependency>
         <groupId>jakarta.servlet</groupId>
         <artifactId>jakarta.servlet-api</artifactId>
         <scope>provided</scope>
       </dependency>
       <dependency>
         <groupId>org.wildfly.security</groupId>
         <artifactId>wildfly-elytron-auth-server</artifactId>
       </dependency>
     </dependencies>
   
     <build>
       <finalName>${project.artifactId}</finalName>
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-war-plugin</artifactId>
               <version>${version.maven.war.plugin}</version>
           </plugin>
           <plugin>
               <groupId>org.jboss.eap.plugins</groupId>
               <artifactId>eap-maven-plugin</artifactId>
               <version>${version.eap.plugin}</version>
               <configuration>
                   <channels>
                       <channel>
                           <manifest>
                               <groupId>org.jboss.eap.channels</groupId>
                               <artifactId>eap-8.0</artifactId>
                           </manifest>
                       </channel>
                   </channels>
                   <feature-packs>
                       <feature-pack>
                           <location>org.jboss.eap:wildfly-ee-galleon-pack</location>
                       </feature-pack>
                       <feature-pack>
                           <location>org.jboss.eap.cloud:eap-cloud-galleon-pack</location>
                       </feature-pack>
                       <feature-pack>
                           <location>org.keycloak:keycloak-saml-adapter-galleon-pack</location>
                       </feature-pack>
                   </feature-packs>
                   <layers>
                       <layer>cloud-server</layer>
                       <layer>keycloak-saml</layer>
                   </layers>
                   <galleon-options>
                       <jboss-fork-embedded>true</jboss-fork-embedded>
                   </galleon-options>
               </configuration>
               <executions>
                   <execution>
                       <goals>
                           <goal>package</goal>
                       </goals>
                   </execution>
               </executions>
           </plugin>
       </plugins>
     </build>
   </project>

   참고

   • < version.eap.plugin>1.0.0.Final-redhat-00014</version.eap.plugin >은 JBoss EAP Maven 플러그인의 예제 버전입니다. JBoss EAP Maven 플러그인 릴리스에 대한 자세한 내용은 Red Hat Maven 리포지토리를 참조하십시오. https://maven.repository.redhat.com/earlyaccess/all/org/jboss/eap/plugins/eap-maven-plugin/.

4. Java 파일을 저장할 디렉터리를 만듭니다.

   구문

   $ mkdir -p src/main/java/<path_based_on_artifactID>

   예제

   $ mkdir -p src/main/java/com/example/app

5. 새 디렉터리로 이동합니다.

   구문

   $ cd src/main/java/<path_based_on_artifactID>

   예제

   $ cd src/main/java/com/example/app

6. 다음 설정이 포함된 SecuredServlet.java 파일을 생성합니다.

   package com.example.app;
   
   import java.io.IOException;
   import java.io.PrintWriter;
   import java.security.Principal;
   import java.util.Set;
   
   import jakarta.servlet.ServletException;
   import jakarta.servlet.annotation.WebServlet;
   import jakarta.servlet.http.HttpServlet;
   import jakarta.servlet.http.HttpServletRequest;
   import jakarta.servlet.http.HttpServletResponse;
   import org.wildfly.security.auth.server.SecurityDomain;
   import org.wildfly.security.auth.server.SecurityIdentity;
   import org.wildfly.security.authz.Attributes;
   /**
    * A simple secured HTTP servlet. It returns the user name and
    * attributes obtained from the logged-in user's Principal. If
    * there is no logged-in user, it returns the text
    * "NO AUTHENTICATED USER".
    */
   
   @WebServlet("/secured")
   public class SecuredServlet extends HttpServlet {
   
       @Override
       protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
           try (PrintWriter writer = resp.getWriter()) {
   
           	Principal user = req.getUserPrincipal();
           	SecurityIdentity identity = SecurityDomain.getCurrent().getCurrentSecurityIdentity();
           	Attributes identityAttributes = identity.getAttributes();
           	Set <String> keys = identityAttributes.keySet();
           	String attributes = "<ul>";
   
           	for (String attr : keys) {
           		attributes += "<li> " +  attr + " : " + identityAttributes.get(attr).toString() + "</li>";
           	}
   
           	attributes+="</ul>";
           	writer.println("<html>");
           	writer.println("  <head><title>Secured Servlet</title></head>");
           	writer.println("  <body>");
           	writer.println("    <h1>Secured Servlet</h1>");
           	writer.println("    <p>");
           	writer.print(" Current Principal '");
           	writer.print(user != null ? user.getName() : "NO AUTHENTICATED USER");
           	writer.print("'");
           	writer.print(user != null ? "\n" + attributes : "");
           	writer.println("    </p>");
           	writer.println("  </body>");
           	writer.println("</html>");
           }
       }
   
   }

7. web.xml 파일의 디렉터리 구조를 생성합니다.

   mkdir -p src/main/webapp/WEB-INF
   cd src/main/webapp/WEB-INF

8. 애플리케이션 리소스를 보호하도록 애플리케이션의 web.xml 파일을 구성합니다.

   예제

   <?xml version="1.0" encoding="UTF-8"?>
   <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
       metadata-complete="false">
   
       <security-constraint>
           <web-resource-collection>
               <web-resource-name>secured</web-resource-name>
               <url-pattern>/secured</url-pattern>
           </web-resource-collection>
   
           <auth-constraint>
               <role-name>user</role-name>
           </auth-constraint>
       </security-constraint>
   
       <login-config>
           <auth-method>KEYCLOAK-SAML</auth-method>
       </login-config>
   
       <security-role>
           <role-name>user</role-name>
       </security-role>
   </web-app>

   이 예에서는 사용자 역할이 있는 사용자만 애플리케이션에 액세스할 수 있습니다.

1. https://github.com/your-username/simple-webapp-example 과 같은 Git 리포지토리를 생성합니다. 원격 리포지토리 및 Git에 대한 자세한 내용은 Git 시작하기 - 원격 리포지토리 정보를 참조하십시오.

2. 애플리케이션의 루트 폴더에서 다음 Git 명령을 실행합니다.

   git init -b main
   git add pom.xml src
   git commit -m "First commit"
   git remote add origin git@github.com:your-username/simple-webapp-example.git
   git remote -v
   git push -u origin main

프로세스

1. 애플리케이션 코드를 Git 리포지토리에 배포합니다.

2. 필요한 환경 변수가 포함된 OpenShift 시크릿을 생성합니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: saml-secret
   type: Opaque
   stringData:
     SSO_REALM: "saml-basic-auth"
     SSO_USERNAME: "client-admin"
     SSO_PASSWORD: "client-admin"
     SSO_SAML_CERTIFICATE_NAME: "saml-app"
     SSO_SAML_KEYSTORE: "keystore.jks"
     SSO_SAML_KEYSTORE_PASSWORD: "password"
     SSO_SAML_KEYSTORE_DIR: "/etc/sso-saml-secret-volume"
     SSO_SAML_LOGOUT_PAGE: "/simple-webapp-example"
     SSO_DISABLE_SSL_CERTIFICATE_VALIDATION: "true"

3. 제공된 YAML 콘텐츠를 saml-secret.yaml 과 같은 파일에 저장합니다.

4. 다음 명령을 사용하여 저장된 YAML 파일을 적용합니다.

   oc apply -f saml-secret.yaml

5. 다음 설정이 포함된 helm.yaml 파일을 생성합니다.

   build:
     uri: [WEB ADDRESS TO YOUR GIT REPOSITORY]
   deploy:
     volumes:
       - name: saml-keystore-volume
         secret:
           secretName: saml-app-secret
     volumeMounts:
       - name: saml-keystore-volume
         mountPath: /etc/sso-saml-secret-volume
         readOnly: true
     envFrom:
       - secretRef:
           name: saml-secret

   참고

   http://www.redhat.com 과 같은 HTTP 형식으로 웹 주소를 지정합니다. maven 미러를 사용하는 경우 다음과 같이 웹 주소를 지정합니다.

   build:
     uri: [WEB ADDRESS TO YOUR GIT REPOSITORY]
     env:
       - name: "MAVEN_MIRROR_URL"
         value: "http://..."

6. JBoss EAP Helm 차트를 사용하여 예제 애플리케이션을 배포합니다.

   $ helm install saml-app -f helm.yaml jboss-eap/eap8

7. saml-secret.yaml 파일에 환경 변수를 추가하여 Keycloak 서버 URL 및 애플리케이션 경로를 구성합니다.

   stringData:
     ...
     HOSTNAME_HTTPS: <saml-app application route>
     SSO_URL: https://<host of the Keycloak server>

   &lt ;saml-app 애플리케이션 route > 및 < host of the Keycloak server >를 적절한 값으로 바꿉니다.

   HOSTNAME_HTTPS 의 값은 다음 출력에 해당합니다.

   echo $(oc get route saml-app --template='{{ .spec.host }}')

   SSO_URL 의 값은 다음 출력에 해당합니다.

   echo https://$(oc get route sso --template='{{ .spec.host }}')

   참고

   이 명령을 사용할 수 없는 경우 oc get routes 를 사용하여 사용 가능한 경로를 나열하고 Keycloak 인스턴스의 Red Hat 빌드 경로를 선택합니다.

8. oc apply -f saml-secret.yaml 을 사용하여 시크릿을 업데이트합니다.

검증

1. 애플리케이션을 다시 배포하여 OpenShift에서 새 환경 변수를 사용하는지 확인합니다.

   $ oc rollout restart deploy saml-app

2. 브라우저에서 애플리케이션 URL로 이동합니다. 예를 들어 https://<saml-app route>/simple-webapp-example.

   Keycloak 로그인 페이지의 Red Hat 빌드로 리디렉션됩니다.

3. 웹 주소를 가져오려면 다음 명령을 사용하여 보안 서블릿에 액세스합니다.

   echo https://$(oc get route saml-app --template='{{ .spec.host }}')/simple-webapp-example/secured

4. 다음 인증 정보로 로그인합니다.

   username: demo
   password: demo

   보안 주체 ID가 포함된 페이지가 표시됩니다.

프로세스

1. URL을 사용하여 Keycloak 관리 콘솔의 Red Hat 빌드에 로그인합니다. https://<SSO route>/.

2. Red Hat build of Keycloak에 영역을 만듭니다(예: saml-basic-auth ). 나중에 이 영역을 사용하여 필요한 사용자, 역할 및 클라이언트를 생성할 수 있습니다.

   자세한 내용은 영역 생성을 참조하십시오.

3. saml-basic-auth 영역에 역할을 생성합니다. 예를 들어 사용자.

   자세한 내용은 영역 역할 생성을 참조하십시오.

4. 사용자를 생성합니다. 예를 들면 데모 입니다.

   자세한 내용은 사용자 생성 을 참조하십시오.

5. 사용자의 암호를 만듭니다. 예를 들면 데모 입니다.

   암호가 임시가 아닌지 확인합니다. 자세한 내용은 사용자의 암호 설정을 참조하십시오.

6. 로그인 액세스를 위해 사용자 역할을 데모 사용자에게 할당합니다.

   자세한 내용은 역할 매핑 할당을 참조하십시오.

7. 사용자를 생성합니다. 예를 들어 client-admin 은 다음과 같습니다.

   JBoss EAP 서버가 시작될 때 Keycloak 서버에서 SAML 클라이언트를 생성하려면 추가 권한이 필요한 client-admin 사용자를 사용할 수 있습니다. 자세한 내용은 사용자 생성 을 참조하십시오.

8. 사용자의 암호를 만듭니다. 예를 들어 client-admin 은 다음과 같습니다.

   암호가 임시가 아닌지 확인합니다. 자세한 내용은 사용자의 암호 설정을 참조하십시오.

9. 클라이언트 역할 드롭다운 목록에서 realm-management 를 선택합니다.

10. create-client,manage-clients, manage-realm 역할을 client-admin 사용자에게 할당합니다.

    자세한 내용은 역할 매핑 할당을 참조하십시오.

프로세스

1. deploy.volumes 필드에 볼륨을 지정하고 사용할 시크릿을 구성합니다. 볼륨 이름과 시크릿의 secretName 을 제공해야 합니다.

   volumes:
     - name: eap-jgroups-keystore-volume
       secret:
         secretName: eap-app-secret

2. 배포 구성에서 deploy.volumeMounts 를 사용하여 파일 시스템에 볼륨을 마운트합니다.

   volumeMounts:
     - name: eap-jgroups-keystore-volume
       mountPath: /etc/jgroups-encrypt-secret-volume
       readOnly: true

프로세스

1. OpenShift Container Platform 웹 콘솔에서 Operator→ OperatorHub 로 이동합니다.
2. 아래로 스크롤하거나 키워드로 필터링 상자에 EAP 를 입력하여 EAP Operator를 찾습니다.
3. JBoss EAP Operator를 선택하고 설치를 클릭합니다.

4. Create Operator Subscription 페이지에서 다음을 수행합니다.

   1. 다음 명령 중 하나를 선택합니다.

      • 클러스터의 모든 네임스페이스(기본값) 는 기본 openshift-operators 네임스페이스에 Operator를 설치하여 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있게 합니다. 이 옵션을 항상 사용할 수있는 것은 아닙니다.
      • 클러스터의 특정 네임스페이스 는 선택한 특정 단일 네임스페이스에 Operator를 설치합니다. Operator는 이 단일 네임스페이스에서만 사용할 수 있습니다.
   2. Update Channel을 선택합니다.
   3. 앞에서 설명한 대로 자동 또는 수동 승인 전략을 선택합니다.

5. 서브스크립션을 클릭하여 이 OpenShift Container Platform 클러스터에서 선택한 네임스페이스에서 EAP Operator를 사용할 수 있도록 합니다.

   1. 수동 승인 전략을 선택한 경우 설치 계획을 검토하고 승인할 때까지 서브스크립션의 업그레이드 상태가 Upgrading 으로 유지됩니다. 설치 계획 페이지에서 설치 계획을 승인한 후 서브스크립션 업그레이드 상태가 Up to date 로 이동합니다.
   2. 자동 승인 전략을 선택한 경우 업그레이드 상태가 개입 없이 최신 상태로 이동합니다.

6. 서브스크립션의 업그레이드 상태가 최신 버전이면 Operator → 설치된 Operator를 선택하여 CSV(EAP ClusterServiceVersion)가 표시되고 해당 상태가 관련 네임스페이스에 InstallSucceeded 로 변경되었는지 확인합니다.

   참고

   All namespaces…​ 설치 모드의 경우 openshift-operators 네임스페이스에 표시되는 상태가 InstallSucceeded 입니다. 다른 네임스페이스에서 상태가 Copied 입니다. . . Status 필드가 InstallSucceeded 로 변경되지 않는 경우 문제를 보고하는 워크로드 → Pod 페이지에서 openshift-operators 프로젝트(또는 특정 네임스페이스…​ 설치 모드가 선택된 경우 기타 관련 네임스페이스)의 모든 Pod 의 로그를 확인합니다.

프로세스

1. OperatorHub에서 클러스터에서 사용할 수 있는 Operator 목록을 확인합니다.

   $ oc get packagemanifests -n openshift-marketplace | grep eap
   NAME        CATALOG               AGE
   ...
   eap         Red Hat Operators     43d
   ...

2. 서브스크립션 오브젝트 YAML 파일(예: Cryostat -operator-sub.yaml)을 생성하여 네임스페이스를 EAP Operator에 서브스크립션합니다. 다음은 Subscription 오브젝트 YAML 파일의 예입니다.

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: eap
     namespace: openshift-operators
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: eap 1
     source:  redhat-operators 2
     sourceNamespace: openshift-marketplace

   1

   등록할 Operator의 이름입니다.

   2

   EAP Operator는 redhat-operators CatalogSource에서 제공합니다.

   채널 및 승인 전략에 대한 자세한 내용은 이 절차의 웹 콘솔 버전을 참조하십시오.

3. YAML 파일에서 Subscription 오브젝트를 생성합니다.

   $ oc apply -f eap-operator-sub.yaml
   $ oc get csv -n openshift-operators
   NAME                  DISPLAY     VERSION   REPLACES   PHASE
   eap-operator.v1.0.0   JBoss EAP   1.0.0                Succeeded

   EAP Operator가 성공적으로 설치되었습니다. 이 시점에서 OLM은 EAP Operator를 알고 있습니다. Operator의 ClusterServiceVersion (CSV)이 대상 네임스페이스에 표시되고 EAP Operator에서 제공하는 API를 생성할 수 있습니다.

프로세스

1. 웹 브라우저를 열고 OperatorHub에 로그인합니다.
2. Java 애플리케이션에 사용할 프로젝트 또는 네임스페이스를 선택합니다.
3. Installed Operator 로 이동하여 JBoss EAP operator 를 선택합니다.
4. 개요 탭에서 인스턴스 생성 링크를 클릭합니다.

5. 애플리케이션 이미지 세부 정보를 지정합니다.

   애플리케이션 이미지는 Java 애플리케이션이 포함된 Docker 이미지를 지정합니다. 이미지는 JBoss EAP for OpenShift S2I(Source-to-Image) 빌드 이미지를 사용하여 빌드해야 합니다. applicationImage 필드가 imagestreamtag에 해당하는 경우 이미지에 대한 모든 변경으로 애플리케이션의 자동 업그레이드가 트리거됩니다.

   다음 참조 중 하나로 OpenShift 애플리케이션 이미지에 대한 JBoss EAP를 제공할 수 있습니다.

   • 이미지 이름: mycomp/myapp
   • 태그: mycomp/myapp:1.0
   • A digest: mycomp/myapp:@sha256:0af38bc38be93116b6a1d86a9c78bd14cd527121970899d719baf78e5dc7bfd2
   • imagestreamtag: my-app:latest

6. 애플리케이션 크기를 지정합니다. 예를 들면 다음과 같습니다.

   spec:
     replicas:2

7. env 사양 을 사용하여 애플리케이션 환경을 구성합니다. 환경 변수는 POSTGRESQL_SERVICE_HOST 또는 POSTGRESQL_USER와 같은 Secret 오브젝트에서 직접 가져올 수 있습니다. 예를 들면 다음과 같습니다.

   spec:
     env:
     - name: POSTGRESQL_SERVICE_HOST
       value: postgresql
     - name: POSTGRESQL_SERVICE_PORT
       value: '5432'
     - name: POSTGRESQL_DATABASE
       valueFrom:
         secretKeyRef:
           key: database-name
           name: postgresql
     - name: POSTGRESQL_USER
       valueFrom:
         secretKeyRef:
           key: database-user
           name: postgresql
     - name: POSTGRESQL_PASSWORD
       valueFrom:
         secretKeyRef:
           key: database-password
           name: postgresql

8. 애플리케이션 배포와 관련된 다음 선택적 구성을 완료합니다.

   • 서버 데이터 디렉터리에 대한 스토리지 요구 사항을 지정합니다. 자세한 내용은 애플리케이션용 영구 스토리지 구성을 참조하십시오.

   • WildFlyServerSpec 에서 생성한 시크릿 이름을 지정하여 애플리케이션을 실행하는 Pod의 볼륨으로 마운트합니다. 예를 들면 다음과 같습니다.

     spec:
       secrets:
         - my-secret

     Secret 은 /etc/secrets/<secret name >에 마운트되며 각 키/값은 파일로 저장됩니다. 파일 이름은 키이고 콘텐츠는 값입니다. 시크릿 은 Pod 내부에 볼륨으로 마운트됩니다. 다음 예제에서는 키 값을 찾는 데 사용할 수 있는 명령을 보여줍니다.

     $ ls /etc/secrets/my-secret/
     my-key  my-password
     $ cat /etc/secrets/my-secret/my-key
     devuser
     $ cat /etc/secrets/my-secret/my-password
     my-very-secure-pasword

     참고

     Secret 오브젝트를 수정하면 프로젝트 불일치가 발생할 수 있습니다. 기존 Secret 오브젝트를 수정하는 대신 Red Hat은 이전 오브젝트와 동일한 콘텐츠를 사용하여 새 오브젝트를 생성하는 것이 좋습니다. 그런 다음 필요에 따라 콘텐츠를 업데이트하고 operator CR(사용자 정의 리소스)의 참조를 old에서 new로 변경할 수 있습니다. 이는 새 CR 업데이트로 간주되며 Pod가 다시 로드됩니다.

   • WildFlyServerSpec 에서 생성한 ConfigMap 의 이름을 지정하여 애플리케이션을 실행하는 Pod의 볼륨으로 마운트합니다. 예를 들면 다음과 같습니다.

     spec:
       configMaps:
       - my-config

     ConfigMap 은 /etc/configmaps/<configmap name >에 마운트되며 각 키/값은 파일로 저장됩니다. 파일 이름은 키이고 콘텐츠는 값입니다. ConfigMap 은 Pod 내부에 볼륨으로 마운트됩니다. 키 값을 찾으려면 다음을 수행합니다.

     $ ls /etc/configmaps/my-config/
     key1 key2
     $ cat /etc/configmaps/my-config/key1
     value1
     $ cat /etc/configmaps/my-config/key2
     value2

     참고

     ConfigMap 을 수정하면 프로젝트 불일치가 발생할 수 있습니다. 기존 ConfigMap 을 수정하는 대신 Red Hat은 이전 ConfigMap 과 동일한 콘텐츠를 사용하여 새 ConfigMap을 생성하는 것이 좋습니다. 그런 다음 필요에 따라 콘텐츠를 업데이트하고 operator CR(사용자 정의 리소스)의 참조를 old에서 new로 변경할 수 있습니다. 이는 새 CR 업데이트로 간주되며 Pod가 다시 로드됩니다.

   • 고유한 독립 실행형 ConfigMap 을 사용하도록 선택하는 경우 ConfigMap 의 이름과 standalone.xml 파일의 키를 제공합니다.

       standaloneConfigMap:
         name: clusterbench-config-map
         key: standalone.xml

     참고

     JBoss EAP 8.0에서는 standalone.xml 파일에서 ConfigMap 을 생성할 수 없습니다.

   • OpenShift에서 기본 HTTP 경로 생성을 비활성화하려면 disableHTTPRoute 를 true 로 설정합니다.

     spec:
       disableHTTPRoute: true

프로세스

1. OpenShift Container Platform 웹 콘솔에서 모니터링→ 메트릭 으로 이동합니다.
2. 메트릭 화면에서 텍스트 상자에 애플리케이션 이름을 입력하여 애플리케이션을 선택합니다. 애플리케이션의 메트릭이 화면에 표시됩니다.

프로세스

1. Operator→ 설치된 Operator 페이지에서 JBoss EAP 를 선택합니다.
2. Operator 상세 정보 페이지 오른쪽에 있는 작업 드롭다운 메뉴에서 Operator 제거를 선택합니다.
3. Operator 서브스크립션 제거 창에서 프롬프트가 표시되면 설치와 관련된 모든 구성 요소를 제거하려는 경우 선택적으로 선택한 네임스페이스 Operator 완전히 제거 확인란을 선택합니다. 이렇게 하면 CSV가 제거되어 Operator와 연결된 Pod, 배포, CRD(사용자 정의 리소스 정의) 및 CR(사용자 정의 리소스)이 제거됩니다.
4. 제거를 클릭합니다. EAP Operator는 실행을 중지하고 더 이상 업데이트를 수신하지 않습니다.

프로세스

1. currentCSV 필드에서 EAP Operator 서브스크립션의 현재 버전을 확인합니다.

   $ oc get subscription eap-operator -n openshift-operators -o yaml | grep currentCSV
     currentCSV: eap-operator.v1.0.0

2. EAP Operator의 서브스크립션을 삭제합니다.

   $ oc delete subscription eap-operator -n openshift-operators
   subscription.operators.coreos.com "eap-operator" deleted

3. 이전 단계의 currentCSV 값을 사용하여 대상 네임스페이스에서 EAP Operator의 CSV를 삭제합니다.

   $ oc delete clusterserviceversion eap-operator.v1.0.0 -n openshift-operators
   clusterserviceversion.operators.coreos.com "eap-operator.v1.0.0" deleted

프로세스

1. 리소스를 구성합니다.

   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: eap-helloworld
   spec:
     applicationImage: 'eap-helloworld:latest'
     replicas: 1
     resources:
       limits:
         cpu: 500m
         memory: 2Gi
       requests:
         cpu: 100m
         memory: 1Gi

   중요

   자동 스케일링이 예상대로 작동하려면 Pod에서 컨테이너의 리소스 제한 및 요청을 지정해야 합니다.

2. Horizontal Pod 자동 스케일러를 생성합니다.

   oc autoscale wildflyserver/eap-helloworld --cpu-percent=50 --min=1 --max=10

1. MAVEN_MIRROR_URL 변수를 적용할 빌드 구성의 이름을 식별합니다.

   oc get bc -o name
   buildconfig/eap

2. MAVEN_MIRROR_URL 환경 변수를 사용하여 build 구성을 업데이트합니다.

   oc env bc/eap MAVEN_MIRROR_URL="https://10.0.0.1:8443/repository/internal/"
   buildconfig "eap" updated

3. 설정을 확인합니다.

   oc env bc/eap --list
   # buildconfigs eap
   MAVEN_MIRROR_URL=https://10.0.0.1:8443/repository/internal/

4. 애플리케이션의 새 빌드를 예약합니다.