bitnami/opensearch

Bitnami OpenSearch 镜像文档

镜像概述和主要用途

关于 OpenSearch

OpenSearch 是一个可扩展的开源解决方案，用于搜索、分析和可观测性。它支持全文查询、自然语言处理、自定义词典等功能。

OpenSearch 概述

商标声明：本软件列表由 Bitnami 打包。产品中提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

Bitnami OpenSearch 镜像概述

Bitnami OpenSearch 镜像是一个预配置、随时可用的容器化版本，旨在简化 OpenSearch 的部署和管理。该镜像遵循行业最佳实践，提供安全、可靠且易于使用的 OpenSearch 环境，适用于开发和生产场景。

核心功能和特性

• 开箱即用：预配置的 OpenSearch 环境，无需复杂设置
• 安全强化：基于最小化操作系统，减少***面
• 持久化存储：支持数据持久化，确保容器重启后数据不丢失
• 灵活配置：通过环境变量轻松自定义 OpenSearch 配置
• 集群支持：简化的集群部署和配置选项
• 安全功能：内置 TLS 加密和访问控制
• 非 root 用户：以非特权用户运行，增强安全性
• 可观测性：支持集成监控和日志工具

使用场景和适用范围

• 搜索引擎部署：快速搭建全文搜索引擎
• 日志和指标分析：集中存储和分析应用日志与指标
• 企业搜索解决方案：构建内部文档和数据搜索系统
• 开发和测试环境：为开发团队提供一致的 OpenSearch 环境
• 微服务架构：作为分布式系统的搜索和分析组件
• 可观测性平台：与日志收集器和可视化工具集成，构建可观测性平台

快速入门

基本使用方法

console
docker run --name opensearch bitnami/opensearch:latest

Docker Compose 示例

yaml
version: '2'

services:
  opensearch:
    image: bitnami/opensearch:latest
    ports:
      - "9200:9200"
      - "9300:9300"
    environment:
      - OPENSEARCH_PASSWORD=your_password
      - OPENSEARCH_ENABLE_SECURITY=true
    volumes:
      - opensearch_data:/bitnami/opensearch/data

volumes:
  opensearch_data:
    driver: local

启动服务:

console
docker-compose up -d

获取镜像

从 Docker Hub 拉取

推荐的获取 Bitnami OpenSearch Docker 镜像的方法是从 Docker Hub registry 拉取预构建的镜像:

console
docker pull bitnami/opensearch:latest

如需使用特定版本，可拉取带版本标签的镜像。您可以在 https://hub.docker.com/r/bitnami/opensearch/tags/ 查看可用版本列表:

console
docker pull bitnami/opensearch:[TAG]

构建自定义镜像

如果需要，您也可以通过克隆仓库、进入包含 Dockerfile 的目录并执行 docker build 命令来自行构建镜像:

console
git clone https://github.com/bitnami/containers.git
cd bitnami/opensearch/[VERSION]/[OPERATING-SYSTEM]
docker build -t bitnami/opensearch:latest .

持久化应用数据

如果删除容器，所有数据都将丢失，下次运行镜像时应用将重新初始化。为避免数据丢失，应挂载一个即使容器被删除也能持久化的卷。

单卷持久化

应在 /bitnami 路径挂载一个目录。如果挂载的目录为空，将在首次运行时初始化:

console
docker run \
    -v /path/to/opensearch-data-persistence:/bitnami/opensearch/data \
    bitnami/opensearch:latest

或对仓库中提供的 https://github.com/bitnami/containers/blob/main/bitnami/opensearch/docker-compose.yml 文件进行微调:

yaml
opensearch:
  ...
  volumes:
    - /path/to/opensearch-data-persistence:/bitnami/opensearch/data
  ...

注意：由于这是一个非 root 容器，挂载的文件和目录必须对 UID 1001 具有适当的权限。

多卷持久化

还可以使用 OPENSEARCH_DATA_DIR_LIST 环境变量实现多卷数据持久化:

yaml
opensearch:
  ...
  volumes:
    - /path/to/opensearch-data-persistence-1:/opensearch/data-1
    - /path/to/opensearch-data-persistence-2:/opensearch/data-2
  environment:
    - OPENSEARCH_DATA_DIR_LIST=/opensearch/data-1,/opensearch/data-2
  ...

连接到其他容器

使用 Docker 容器网络，在容器内运行的 OpenSearch 服务器可以轻松被其他应用容器访问。

连接到同一网络的容器可以使用容器名称作为主机名相互通信。

使用命令行

步骤 1: 创建网络

console
docker network create app-tier --driver bridge

步骤 2: 启动 OpenSearch 服务器实例

使用 --network app-tier 参数将 OpenSearch 容器附加到 app-tier 网络:

console
docker run -d --name opensearch-server \
    --network app-tier \
    bitnami/opensearch:latest

步骤 3: 启动应用容器

console
docker run -d --name myapp \
    --network app-tier \
    YOUR_APPLICATION_IMAGE

重要提示:

1. 请将上述代码段中的 YOUR_APPLICATION_IMAGE 占位符替换为您的应用程序镜像
2. 在应用容器中，使用主机名 opensearch-server 连接到 OpenSearch 服务器

使用 Docker Compose 文件

未指定时，Docker Compose 会自动设置一个新网络并将所有部署的服务附加到该网络。以下示例中，我们显式定义一个名为 app-tier 的新 bridge 网络，并假设您希望从自己的自定义应用程序镜像（在以下代码段中由服务名称 myapp 标识）连接到 OpenSearch 服务器:

yaml
version: '2'

networks:
  app-tier:
    driver: bridge

services:
  opensearch:
    image: bitnami/opensearch:latest
    networks:
      - app-tier
  myapp:
    image: YOUR_APPLICATION_IMAGE
    networks:
      - app-tier

重要提示:

1. 请将上述代码段中的 YOUR_APPLICATION_IMAGE 占位符替换为您的应用程序镜像
2. 在应用容器中，使用主机名 opensearch 连接到 OpenSearch 服务器

启动容器:

console
docker-compose up -d

详细配置说明

环境变量

可自定义环境变量

只读环境变量

在 Kubernetes 中部署

将 Bitnami 应用部署为 Helm Charts 是在 Kubernetes 上使用我们的应用程序的最简单方法。有关安装的更多信息，请参阅 https://github.com/bitnami/charts/tree/master/bitnami/opensearch%E3%80%82

为什么使用非 root 容器?

非 root 容器镜像增加了一层安全性，通常推荐用于生产环境。但是，由于它们以非 root 用户身份运行，通常无法执行特权任务。在我们的 文档 中了解有关非 root 容器的更多信息。