从源代码安装¶

已发布的包¶

本页面介绍如何使用官方发布的软件包下载并验证 apache-airflow-providers-ydb 提供者（provider）的 2.1.1 版本。您也可以通过 PyPI 安装该提供者软件包，这与大多数 Python 软件包一样。您可以通过选择页面左上角的下拉菜单中的不同版本来选择不同的提供者版本。

发布的 sdist 和 whl 软件包是“官方”的安装来源，如果您想验证软件包的来源并验证软件包的校验和和签名，则可以使用这些软件包。这些软件包可以通过 Apache Software Foundation 官方下载渠道获取。

下载地址如下：

Sdist 软件包 (asc, sha512) - 这些也是软件包的官方来源
Whl 软件包 (asc, sha512)

如果您想从源代码安装，可以从上面的源链接下载，其中包含一个 INSTALL 文件，详细说明了如何构建和安装该提供者（provider）。

版本完整性¶

PGP 签名 KEYS

使用 PGP 或 SHA 签名验证下载文件的完整性至关重要。PGP 签名可以使用 GPG 或 PGP 进行验证。请下载 KEYS 以及相关分发版本的 asc 签名文件。建议从主分发目录获取这些文件，而不是从镜像站点获取。

gpg -i KEYS

或

pgpk -a KEYS

或

pgp -ka KEYS

要验证二进制文件/源代码，您可以从主分发目录下载相应的 asc 文件，并按照以下指南进行操作。

gpg --verify apache-airflow-providers-********.asc apache-airflow-*********

或

pgpv apache-airflow-providers-********.asc

或

pgp apache-airflow-providers-********.asc

示例

$ gpg --verify apache-airflow-providers-ydb-2.1.1.tar.gz.asc apache-airflow-providers-ydb-2.1.1.tar.gz
  gpg: Signature made Sat 11 Sep 12:49:54 2021 BST
  gpg:                using RSA key CDE15C6E4D3A8EC4ECF4BA4B6674E08AD7DE406F
  gpg:                issuer "kaxilnaik@apache.org"
  gpg: Good signature from "Kaxil Naik <kaxilnaik@apache.org>" [unknown]
  gpg:                 aka "Kaxil Naik <kaxilnaik@gmail.com>" [unknown]
  gpg: WARNING: The key's User ID is not certified with a trusted signature!
  gpg:          There is no indication that the signature belongs to the owner.
  Primary key fingerprint: CDE1 5C6E 4D3A 8EC4 ECF4  BA4B 6674 E08A D7DE 406F

“Good signature from …” 表示签名是正确的。无需担心“not certified with a trusted signature”警告。大多数版本管理员使用的证书都是自签名的，因此会出现此警告。通过上一步导入服务器并从 KEYS 页面通过 ID 导入，您就知道这是一个有效的密钥了。

对于 SHA512 校验和检查，请下载相关的 sha512 文件并运行以下命令：

shasum -a 512 apache-airflow-providers-********  | diff - apache-airflow-providers-********.sha512

文件的 SHASUM 应与 .sha512 文件中提供的校验和一致。

示例

shasum -a 512 apache-airflow-providers-ydb-2.1.1.tar.gz  | diff - apache-airflow-providers-ydb-2.1.1.tar.gz.sha512

验证 PyPI 版本¶

您可以通过使用以下脚本在本地下载软件包、签名和 SHA 校验和文件来验证 PyPI 中的提供者（Provider）.whl 软件包：

#!/bin/bash
PACKAGE_VERSION=2.1.1
PACKAGE_NAME=apache-airflow-providers-ydb
provider_download_dir=$(mktemp -d)
pip download --no-deps "${PACKAGE_NAME}==${PACKAGE_VERSION}" --dest "${provider_download_dir}"
curl "https://downloads.apache.org/airflow/providers/apache_airflow_providers_ydb-2.1.1-py3-none-any.whl.asc" \
    -L -o "${provider_download_dir}/apache_airflow_providers_ydb-2.1.1-py3-none-any.whl.asc"
curl "https://downloads.apache.org/airflow/providers/apache_airflow_providers_ydb-2.1.1-py3-none-any.whl.sha512" \
    -L -o "${provider_download_dir}/apache_airflow_providers_ydb-2.1.1-py3-none-any.whl.sha512"
echo
echo "Please verify files downloaded to ${provider_download_dir}"
ls -la "${provider_download_dir}"
echo

按照上一章的说明验证文件后，您可以删除创建的临时文件夹。