bitnamisecure/postgresql

Bitnami PostgreSQL 镜像

什么是 PostgreSQL？

PostgreSQL（Postgres）是一款开源对象关系型数据库，以可靠性和数据完整性著称。它支持ACID事务、外键、连接、视图、触发器和存储过程。

PostgreSQL 概述
商标说明：本软件列表由Bitnami打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速启动

console
docker run --name postgresql REGISTRY_NAME/bitnami/postgresql:latest

警告：此快速设置仅适用于开发环境。建议您更改不安全的默认凭据，并查看配置部分中的可用配置选项，以实现更安全的部署。

为什么使用 Bitnami 安全镜像？

• Bitnami 安全镜像和 Helm 图表旨在提高开源软件的安全性和企业就绪性。
• 通过行业标准漏洞可利用性交换（VEX）、KEV 和 EPSS 评分，更快地分类安全漏洞，透明呈现 CVE 风险。
• 强化镜像使用最小化操作系统（Photon Linux），减少***面，同时通过行业标准包格式保持可扩展性。
• 持续构建的镜像在上游补丁发布后数小时内更新，确保更高的安全性和合规性。
• Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方法，便于根据项目需求在不同格式间切换。
• 强化镜像附带证明签名（Notation）、SBOM、病毒扫描报告和其他元数据，这些均在符合 SLSA-3 标准的软件工厂中生成。

仅部分 BSI 应用可免费使用。想要访问完整的应用目录并获得企业支持？立即尝试 Bitnami 安全镜像商业版。

如何在 Kubernetes 中部署 PostgreSQL？

将 Bitnami 应用部署为 Helm 图表是在 Kubernetes 上使用我们应用的最简单方法。有关安装详情，请参阅 https://github.com/bitnami/charts/tree/master/bitnami/postgresql%E3%80%82

为什么使用非 root 容器？

非 root 容器镜像增加了额外的安全层，通常推荐用于生产环境。然而，由于它们以非 root 用户运行，通常无法执行特权任务。在我们的文档中了解更多关于非 root 容器的信息 in our docs。

支持的标签及对应的 Dockerfile 链接

了解更多关于 Bitnami 标签策略以及滚动标签和不可变标签之间的区别，请参阅我们的文档页面 in our documentation page。

您可以通过查看分支文件夹中的 tags-info.yaml 文件（即 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）来了解不同标签之间的对应关系。

通过关注 https://github.com/bitnami/containers 订阅项目更新。

获取此镜像

获取 Bitnami PostgreSQL Docker 镜像的推荐方式是从 https://hub.docker.com/r/bitnami/postgresql 拉取预构建镜像。

console
docker pull REGISTRY_NAME/bitnami/postgresql:latest

要使用特定版本，您可以拉取带版本的标签。您可以在 Docker Hub Registry 中查看 https://hub.docker.com/r/bitnami/postgresql/tags/%E3%80%82

console
docker pull REGISTRY_NAME/bitnami/postgresql:[TAG]

如果需要，您也可以通过克隆仓库、进入包含 Dockerfile 的目录并执行 docker build 命令来自行构建镜像。请记住在下面的示例命令中用正确的值替换 APP、VERSION 和 OPERATING-SYSTEM 路径占位符。

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

持久化数据库数据

如果删除容器，所有数据和配置都将丢失，下次运行镜像时数据库将重新初始化。为避免数据丢失，您应该挂载一个即使容器被删除后仍能保留的卷。

要实现持久化，您应该在 /bitnami/postgresql 路径挂载一个目录。如果挂载的目录为空，将在首次运行时初始化。

console
docker run \
    -v /path/to/postgresql-persistence:/bitnami/postgresql \
    REGISTRY_NAME/bitnami/postgresql:latest

或修改此仓库中提供的 https://github.com/bitnami/containers/tree/main/bitnami/postgresql/docker-compose.yml 文件：

yaml
services:
  postgresql:
  ...
    volumes:
      - /path/to/postgresql-persistence:/bitnami/postgresql
  ...

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

连接到其他容器

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

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

使用命令行

在此示例中，我们将创建一个 PostgreSQL 客户端实例，该实例将连接到与客户端在同一 Docker 网络上运行的服务器实例。

步骤 1：创建网络

console
docker network create app-tier --driver bridge

步骤 2：启动 PostgreSQL 服务器实例

使用 --network app-tier 参数执行 docker run 命令，将 PostgreSQL 容器附加到 app-tier 网络。

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

步骤 3：启动 PostgreSQL 客户端实例

最后，我们创建一个新的容器实例来启动 PostgreSQL 客户端并连接到上一步创建的服务器：

console
docker run -it --rm \
    --network app-tier \
    REGISTRY_NAME/bitnami/postgresql:latest psql -h postgresql-server -U postgres

使用 Docker Compose 文件

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

yaml
version: '2'

networks:
  app-tier:
    driver: bridge

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

重要：

1. 请将上述代码段中的 YOUR_APPLICATION_IMAGE 占位符更新为您的应用镜像
2. 在应用容器中，使用主机名 postgresql 连接到 PostgreSQL 服务器

使用以下命令启动容器：

console
docker-compose up -d

配置

环境变量

可自定义环境变量