12.4. 使用 Fabric8 Karaf 功能

12.4.1. 添加 Fabric8 Karaf 功能
复制链接

要使用功能，请将 fabric8-karaf-features 依赖项添加到项目 POM 文件中。

流程

打开项目的 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 核心捆绑包功能
复制链接

捆绑包 fabric8-karaf-core 提供 Blueprint 和 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 服务选项
复制链接

捆绑包 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 服务充当不同属性占位符解析策略的收集器。默认情况下，它提供的解析策略列在表解析策略中。要设置属性占位符服务选项，您可以使用系统属性或环境变量或两者。

流程

要访问 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

将 secret 挂载到 Pod，因为通过 API 访问 secret 可能会被限制。

Pod 上作为卷挂载提供的 secret 映射到名为 secret 的目录，如下所示

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 服务使解析器可用于 Blueprint 和 ConfigAdmin。

流程

将以下 mvn 依赖项添加到项目 pom.xml 中。

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

您可以在 Configuration management 中引用解析器，如下所示：
属性
```
my.property = $[myResolver:value-to-resolve]
```
```
my.property = $[myResolver:value-to-resolve]
```
Copy to Clipboard Toggle word wrap

12.4.5. 解析策略列表
复制链接

PlaceholderResolver 服务充当不同属性占位符解析策略的收集器。表中列出了它默认提供的解析策略。

解析策略列表

Expand

prefix	Example	描述
`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 Secret （通过 API 或卷挂载）中查找属性。

12.4.6. Property Placeholder 服务选项列表
复制链接

属性占位符服务支持以下选项：

属性占位符服务选项列表

Expand

Name	default	描述
`fabric8.placeholder.prefix`	$[	占位符的前缀
`fabric8.placeholder.suffix`	]	占位符的后缀
`fabric8.k8s.secrets.path`	null	以逗号分隔的 secret 的路径列表
`fabric8.k8s.secrets.api.enabled`	false	通过 API 启用/禁用消耗 secret

12.4.1. 添加 Fabric8 Karaf 功能
复制链接

12.4.2. 添加 Fabric8 Karaf 核心捆绑包功能
复制链接

12.4.3. 设置 Property Placeholder 服务选项
复制链接

12.4.4. 添加自定义属性占位符解析器
复制链接

12.4.5. 解析策略列表
复制链接

12.4.6. Property Placeholder 服务选项列表
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

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 核心捆绑包功能复制链接链接已复制到粘贴板!

12.4.3. 设置 Property Placeholder 服务选项复制链接链接已复制到粘贴板!

12.4.4. 添加自定义属性占位符解析器复制链接链接已复制到粘贴板!

12.4.5. 解析策略列表复制链接链接已复制到粘贴板!

12.4.6. Property Placeholder 服务选项列表复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

12.4.1. 添加 Fabric8 Karaf 功能
复制链接

12.4.2. 添加 Fabric8 Karaf 核心捆绑包功能
复制链接

12.4.3. 设置 Property Placeholder 服务选项
复制链接

12.4.4. 添加自定义属性占位符解析器
复制链接

12.4.5. 解析策略列表
复制链接

12.4.6. Property Placeholder 服务选项列表
复制链接