홈
제품
Red Hat Fuse
7.12
OpenShift 기반 Fuse 가이드
12.4. Fabric8 Karaf 기능 사용

12.4. Fabric8 Karaf 기능 사용

Fabric8은 Apache Karaf를 지원하여 Kubernetes용 OSGi 앱을 더 쉽게 개발할 수 있도록 지원합니다.

Fabric8의 중요한 기능은 다음과 같습니다.

블루프린트 XML 파일에서 자리 표시자를 해결하기 위한 다양한 전략입니다.
환경 변수
시스템 속성
서비스
Kubernetes ConfigMap
Kubernetes 시크릿
Kubernetes 구성 맵을 사용하여 OSGi 구성 관리를 동적으로 업데이트합니다.
OSGi 서비스에 대한 Kubernetes heath 검사를 제공합니다.

12.4.1. Fabric8 Karaf 기능 추가
링크 복사

이 기능을 사용하려면 프로젝트 POM 파일에 fabric8-karaf-features 종속성을 추가합니다.

절차

프로젝트의 pom.xml 파일을 열고 fabric8-karaf-features 종속성을 추가합니다.

<dependency>
  <groupId>io.fabric8</groupId>
  <artifactId>fabric8-karaf-features</artifactId>
  <version>${fabric8.version}</version>
  <classifier>features</classifier>
  <type>xml</type>
</dependency>

<dependency>
  <groupId>io.fabric8</groupId>
  <artifactId>fabric8-karaf-features</artifactId>
  <version>${fabric8.version}</version>
  <classifier>features</classifier>
  <type>xml</type>
</dependency>

Copy to Clipboard

Toggle word wrap

fabric8 karaf 기능은 Karaf 서버에 설치됩니다.

12.4.2. Fabric8 Karaf Core 번들 기능 추가
링크 복사

bundle fabric8-karaf-core 는 블루프린트 및 ConfigAdmin 확장에서 사용하는 기능을 제공합니다.

절차

프로젝트의 pom.xml 을 열고 fabric8-karaf-core 를 startupFeatures 섹션에 추가합니다.
```
<startupFeatures>
  ...
  <feature>fabric8-karaf-core</feature>
  ...
</startupFeatures>
```
```
<startupFeatures>
  ...
  <feature>fabric8-karaf-core</feature>
  ...
</startupFeatures>
```
Copy to Clipboard Toggle word wrap
그러면 사용자 지정 Karaf 배포에 fabric8-karaf-core 기능이 추가됩니다.

12.4.3. Property Placeholder 서비스 옵션 설정
링크 복사

bundle fabric8-karaf-core 는 다음 인터페이스로 서비스 PlaceholderResolver 를 내보냅니다.

public interface PlaceholderResolver {
    /**
     * Resolve a placeholder using the strategy indicated by the prefix
     *
     * @param value the placeholder to resolve
     * @return the resolved value or null if not resolved
     */
    String resolve(String value);

    /**
     * Replaces all the occurrences of variables with their matching values from the resolver using the given source string as a template.
     *
     * @param source the string to replace in
     * @return the result of the replace operation
     */
    String replace(String value);

    /**
     * Replaces all the occurrences of variables within the given source builder with their matching values from the resolver.
     *
     * @param value the builder to replace in
     * @rerurn true if altered
     */
    boolean replaceIn(StringBuilder value);

    /**
     * Replaces all the occurrences of variables within the given dictionary
     *
     * @param dictionary the dictionary to replace in
     * @rerurn true if altered
     */
    boolean replaceAll(Dictionary<String, Object> dictionary);

    /**
     * Replaces all the occurrences of variables within the given dictionary
     *
     * @param dictionary the dictionary to replace in
     * @rerurn true if altered
     */
    boolean replaceAll(Map<String, Object> dictionary);
}

public interface PlaceholderResolver {
    /**
     * Resolve a placeholder using the strategy indicated by the prefix
     *
     * @param value the placeholder to resolve
     * @return the resolved value or null if not resolved
     */
    String resolve(String value);

    /**
     * Replaces all the occurrences of variables with their matching values from the resolver using the given source string as a template.
     *
     * @param source the string to replace in
     * @return the result of the replace operation
     */
    String replace(String value);

    /**
     * Replaces all the occurrences of variables within the given source builder with their matching values from the resolver.
     *
     * @param value the builder to replace in
     * @rerurn true if altered
     */
    boolean replaceIn(StringBuilder value);

    /**
     * Replaces all the occurrences of variables within the given dictionary
     *
     * @param dictionary the dictionary to replace in
     * @rerurn true if altered
     */
    boolean replaceAll(Dictionary<String, Object> dictionary);

    /**
     * Replaces all the occurrences of variables within the given dictionary
     *
     * @param dictionary the dictionary to replace in
     * @rerurn true if altered
     */
    boolean replaceAll(Map<String, Object> dictionary);
}

Copy to Clipboard

Toggle word wrap

PlaceholderResolver 서비스는 다양한 속성 자리 표시자 확인 전략에 대해 수집기 역할을 합니다. 기본적으로 제공되는 해결 전략은 표 Resolution Strategies 에 나열되어 있습니다. 속성 자리 표시자 서비스 옵션을 설정하려면 시스템 속성 또는 환경 변수 또는 둘 다를 사용할 수 있습니다.

절차

OpenShift의 ConfigMap에 액세스하려면 서비스 계정에 보기 권한이 필요합니다. 서비스 계정에 보기 권한을 추가합니다.
```
oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default -n $(oc project -q)
```
```
oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default -n $(oc project -q)
```
Copy to Clipboard Toggle word wrap
API를 통해 보안에 대한 액세스가 제한될 수 있으므로 Pod에 보안을 마운트합니다.

Pod에서 볼륨 마운트로 사용 가능한 시크릿은 다음과 같이 시크릿이라는 디렉터리에 매핑됩니다.

containers:
  -
   env:
   - name: FABRIC8_K8S_SECRETS_PATH
     value: /etc/secrets
     volumeMounts:
   - name: activemq-secret-volume
     mountPath: /etc/secrets/activemq
     readOnly: true
   - name: postgres-secret-volume
     mountPath: /etc/secrets/postgres
     readOnly: true

volumes:
  - name: activemq-secret-volume
  secret:
  secretName: activemq
  - name: postgres-secret-volume
   secret:
  secretName: postgres

containers:
  -
   env:
   - name: FABRIC8_K8S_SECRETS_PATH
     value: /etc/secrets
     volumeMounts:
   - name: activemq-secret-volume
     mountPath: /etc/secrets/activemq
     readOnly: true
   - name: postgres-secret-volume
     mountPath: /etc/secrets/postgres
     readOnly: true

volumes:
  - name: activemq-secret-volume
  secret:
  secretName: activemq
  - name: postgres-secret-volume
   secret:
  secretName: postgres

Copy to Clipboard

Toggle word wrap

12.4.4. 사용자 정의 속성 자리 표시자 확인기 추가
링크 복사

사용자 지정 암호화와 같은 특정 요구 사항을 지원하기 위해 사용자 지정 자리 표시자 확인자를 추가할 수 있습니다. 또한 PlaceholderResolver 서비스를 사용하여 블루프린트 및 ConfigAdmin에서 해결자를 사용할 수 있습니다.

절차

pom.xml 프로젝트에 다음 mvn 종속성을 추가합니다.

pom.xml

---
<dependency>
  <groupId>io.fabric8</groupId>
  <artifactId>fabric8-karaf-core</artifactId>
</dependency>
---

---
<dependency>
  <groupId>io.fabric8</groupId>
  <artifactId>fabric8-karaf-core</artifactId>
</dependency>
---

Copy to Clipboard

Toggle word wrap

PropertiesFunction 인터페이스를 구현하고 SCR을 사용하여 OSGi 서비스로 등록합니다.

import io.fabric8.karaf.core.properties.function.PropertiesFunction;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.ConfigurationPolicy;
import org.apache.felix.scr.annotations.Service;

@Component(
    immediate = true,
    policy = ConfigurationPolicy.IGNORE,
    createPid = false
)
@Service(PropertiesFunction.class)
public class MyPropertiesFunction implements PropertiesFunction {
    @Override
    public String getName() {
        return "myResolver";
    }

    @Override
    public String apply(String remainder) {
        // Parse and resolve remainder
        return remainder;
    }
}

import io.fabric8.karaf.core.properties.function.PropertiesFunction;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.ConfigurationPolicy;
import org.apache.felix.scr.annotations.Service;

@Component(
    immediate = true,
    policy = ConfigurationPolicy.IGNORE,
    createPid = false
)
@Service(PropertiesFunction.class)
public class MyPropertiesFunction implements PropertiesFunction {
    @Override
    public String getName() {
        return "myResolver";
    }

    @Override
    public String apply(String remainder) {
        // Parse and resolve remainder
        return remainder;
    }
}

Copy to Clipboard

Toggle word wrap

다음과 같이 구성 관리에서 해결자를 참조할 수 있습니다.
속성
```
my.property = $[myResolver:value-to-resolve]
```
```
my.property = $[myResolver:value-to-resolve]
```
Copy to Clipboard Toggle word wrap

12.4.5. 해결 전략 목록
링크 복사

PlaceholderResolver 서비스는 다양한 속성 자리 표시자 확인 전략에 대해 수집기 역할을 합니다. 기본적으로 제공되는 해결 전략은 표에 나열되어 있습니다.

해결 전략 목록

Expand

접두사	예제	설명
`env`	`env:JAVA_HOME`	OS 환경 변수에서 속성을 조회합니다.
`sys	`sys:java.version`	Java JVM 시스템 속성에서 속성을 조회합니다.
`service	`service:amq`	서비스 이름 지정 규칙을 사용하여 OS 환경 변수에서 속성을 조회합니다.
`service.host`	`service.host:amq`	hostname 부분만 반환하는 서비스 이름 지정 규칙을 사용하여 OS 환경 변수에서 속성을 조회합니다.
`service.port`	`service.port:amq`	포트 부분만 반환하는 서비스 이름 지정 규칙을 사용하여 OS 환경 변수에서 속성을 조회합니다.
`k8s:map`	`k8s:map:myMap/myKey`	Kubernetes ConfigMap에서 속성 검색(API를 통해)
`k8s:secret`	`k8s:secret:amq/password`	Kubernetes Secrets에서 속성 검색(API 또는 볼륨 마운트를 통해)

12.4.6. Property Placeholder 서비스 옵션 목록
링크 복사

속성 자리 표시자 서비스는 다음 옵션을 지원합니다.

속성 자리 표시자 서비스 옵션 목록

Expand

이름	기본	설명
`fabric8.placeholder.prefix`	$[	자리 표시자의 접두사
`fabric8.placeholder.suffix`	]	자리 표시자의 접미사
`fabric8.k8s.secrets.path`	null	보안이 매핑되는 쉼표로 구분된 경로 목록
`fabric8.k8s.secrets.api.enabled`	false	API를 통해 시크릿 활성화/비활성화

맨 위로 이동

12.4. Fabric8 Karaf 기능 사용

12.4.1. Fabric8 Karaf 기능 추가
링크 복사

12.4.2. Fabric8 Karaf Core 번들 기능 추가
링크 복사

12.4.3. Property Placeholder 서비스 옵션 설정
링크 복사

12.4.4. 사용자 정의 속성 자리 표시자 확인기 추가
링크 복사

12.4.5. 해결 전략 목록
링크 복사

12.4.6. Property Placeholder 서비스 옵션 목록
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

12.4. Fabric8 Karaf 기능 사용

12.4.1. Fabric8 Karaf 기능 추가링크 복사링크가 클립보드에 복사되었습니다!

12.4.2. Fabric8 Karaf Core 번들 기능 추가링크 복사링크가 클립보드에 복사되었습니다!

12.4.3. Property Placeholder 서비스 옵션 설정링크 복사링크가 클립보드에 복사되었습니다!

12.4.4. 사용자 정의 속성 자리 표시자 확인기 추가링크 복사링크가 클립보드에 복사되었습니다!

12.4.5. 해결 전략 목록링크 복사링크가 클립보드에 복사되었습니다!

12.4.6. Property Placeholder 서비스 옵션 목록링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

12.4.1. Fabric8 Karaf 기능 추가
링크 복사

12.4.2. Fabric8 Karaf Core 번들 기능 추가
링크 복사

12.4.3. Property Placeholder 서비스 옵션 설정
링크 복사

12.4.4. 사용자 정의 속성 자리 표시자 확인기 추가
링크 복사

12.4.5. 해결 전략 목록
링크 복사

12.4.6. Property Placeholder 서비스 옵션 목록
링크 복사