安装依赖

本指南将介绍可通过 Apache Polaris 管理的几个关键实体，说明如何在本地构建并部署 Polaris，最后还会给出将 Polaris 与 Apache Spark™ 配合使用的示例。

如果你只需要 Polaris CLI，可以不必克隆代码库，直接安装它：

pip install apache-polaris

前置条件

本指南介绍如何构建 Polaris、通过本地或 Docker 部署它，以及如何使用命令行界面和 Apache Spark 与之交互。在开始使用 Polaris 之前，请确保满足此处列出的相关前置条件。

Git

要获取最新的 Polaris 代码，你需要使用 git 克隆代码仓库。在 MacOS 上，可以使用 homebrew 安装 git：

brew install git

有关在其他平台上安装 Git 的说明，请参阅 Git 官方文档。

然后，使用 git 克隆 Polaris 仓库：

git clone https://github.com/apache/polaris.git ~/polaris

Docker

建议在 Docker 中部署 Polaris，以使用快速开始工作流。在受支持的云服务提供商（AWS、Azure、GCP）上部署快速开始工作流的说明将仅提供 Docker 方式。不过，本地部署的非 Docker 部署说明同样适用于云服务提供商。

Docker 的安装说明可以在 Docker 官网 找到。请确保 Docker 和 Docker Compose 插件都已安装。

在 MacOS 上使用 Docker

可以使用 homebrew 安装 Docker：

brew install --cask docker

运行容器时可能会遇到与 seccomp 配置相关的 Docker 权限问题。要解决这些问题，请在运行容器时将 seccomp 配置文件设置为 “unconfined”。例如：

docker run --security-opt seccomp=unconfined apache/polaris:latest

注意：将 seccomp 配置文件设为 "unconfined" 会禁用默认的系统调用过滤，这可能带来安全风险。请谨慎使用此配置，尤其是在生产环境中。

在 Amazon Linux 上安装 Docker

可以通过修改 CentOS 的安装说明来安装 Docker。例如：

sudo dnf update -y
# Remove old version
sudo dnf remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
# Install dnf plugin
sudo dnf -y install dnf-plugins-core
# Add CentOS repository
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# Adjust release server version in the path as it will not match with Amazon Linux 2023
sudo sed -i 's/$releasever/9/g' /etc/yum.repos.d/docker-ce.repo
# Install as usual
sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

确认 Docker 安装

安装完成后，请确保 Docker 和 Docker Compose 插件都已安装：

docker version
docker compose version

同时请确保 Docker 正在运行，并且能够运行一个示例 Docker 容器：

docker run hello-world

Java

如果你打算自行从源码构建 Polaris，或按本教程的说明在云服务商上进行构建，首先需要满足一些前置要求。

Polaris 使用 gradle 构建，并兼容 Java 21。我们建议使用 jenv 来管理多个 Java 版本。例如，通过 homebrew 安装 Java 21 并使用 jenv 进行配置：

cd ~/polaris
brew install openjdk@21 jenv
jenv add $(brew --prefix openjdk@21)
jenv local 21

请确保 java --version 与 javac 均返回非零响应。

jq

大多数 Polaris 快速开始脚本都需要 jq。你可以使用 homebrew 来安装 jq：

brew install jq