先决条件

在 Kubernetes 上部署 Neo4j 集群之前,您需要

一般先决条件

  • 配置 Neo4j Helm 图表存储库.

  • 如果您想安装 Neo4j Enterprise Edition,则需要获得有效的许可证,或者将配置参数 edition: "enterprise" 设置为 "eval",如果您想接受 Neo4j 评估许可证
    有关如何获得商业许可证的更多信息,请参见 https://neo4j.ac.cn/licensing/ 和 link:https://neo4j.ac.cn/terms/licensing/,或使用表单 联系 Neo4j

  • 安装 Kubernetes 客户端命令行工具 kubectl (https://kubernetes.ac.cn/docs/tasks/tools/).

  • 设置具有足够 CPU 和内存的 Kubernetes 集群,以满足您的 Neo4j 部署需求。

    本指南适用于每个 Neo4j 实例分配的最小 CPU 和内存。但是,Neo4j 的系统要求在很大程度上取决于软件的使用情况。因此,在开发或生产环境中运行 Neo4j 时,请参阅 系统要求

    如果您没有 Kubernetes 集群,您可以根据您的环境配置一个多节点集群,请参阅下一节 环境特定前提条件

环境特定前提条件

根据您的 Kubernetes 环境选择选项卡,并在其中完成所有前提条件。

  1. 安装 gcloud 命令行界面 (CLI) (https://cloud.google.com/sdk/docs/install).

  2. 本指南中的所有 shell 命令都假设已使用 CLOUDSDK_CORE_PROJECTCLOUDSDK_COMPUTE_ZONECLOUDSDK_COMPUTE_REGION 环境变量设置了要使用的 GCP 项目、计算区域和区域,例如

    export CLOUDSDK_CORE_PROJECT="neo4j-helm"
    export CLOUDSDK_COMPUTE_ZONE="europe-west6-c"
    export CLOUDSDK_COMPUTE_REGION="europe-west6"
    export CLOUDSDK_CONTAINER_CLUSTER="my-neo4j-gke-cluster"
  3. 如果您没有 Google Kubernetes Engine (GKE) 集群,可以使用以下方法创建一个多节点集群(每个 Neo4j 实例一个节点)

    gcloud container clusters create my-neo4j-gke-cluster --num-nodes=<num> --machine-type "e2-standard-2"

    e2-standard-2 是在 GKE 上运行本入门指南示例所需的最小实例类型。

  4. 配置 kubectl 以使用您的 GKE 集群,方法是

    gcloud container clusters get-credentials my-neo4j-gke-cluster
    Fetching cluster endpoint and auth data.
    kubeconfig entry generated for my-neo4j-gke-cluster.
  1. 安装 aws 命令行界面 (CLI) (https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)。确保您完成了 AWS 配置步骤 (https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html).

  2. 安装 eksctl 命令行界面 (CLI) (https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html).

  3. 本指南中的所有 shell 命令都假设已使用 AWS_DEFAULT_REGION 环境变量设置了要使用的 AWS 区域,例如

    export AWS_DEFAULT_REGION="eu-west-1"
  4. 如果您没有 AWS Elastic Kubernetes Service (EKS) 集群,可以使用以下命令创建一个多节点集群(每个 Neo4j 实例一个节点)

    此命令要求您有一个名为 id_rsa.pub 的公钥。如果您没有公钥,可以通过运行以下命令生成它

    ssh-keygen -t rsa -C "your-name@example.com"
    eksctl create cluster --name "my-neo4j-eks-cluster" --region "${AWS_DEFAULT_REGION}" --nodegroup-name "neo4j-nodes" --nodes-min 1 --nodes-max 4 --node-type c4.xlarge --nodes 4 --node-volume-size 10 --ssh-access --with-oidc
  5. 创建一个 IAM 角色(例如,AmazonEKS_EBS_CSI_DriverRole)并将所需的 AWS 托管策略附加到它(例如,AmazonEBSCSIDriverPolicy)。

    eksctl create iamserviceaccount \
      --name ebs-csi-controller-sa \
      --namespace kube-system \
      --cluster my-neo4j-eks-cluster \
      --attach-policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \
      --approve \
      --role-only \
      --role-name AmazonEKS_EBS_CSI_DriverRole
  6. 将 EBS CSI 驱动程序作为 Amazon EKS 附加组件添加到您的集群

    eksctl create addon \
      --name aws-ebs-csi-driver \
      --cluster my-neo4j-eks-cluster \
      --service-account-role-arn arn:aws:iam::<aws-account-id>:role/AmazonEKS_EBS_CSI_DriverRole \
      --force

    确保将 <aws-account-id> 替换为您的 AWS 帐户 ID。

  7. 配置 kubectl 以使用您的 EKS 集群,方法是

    aws eks update-kubeconfig --name my-neo4j-eks-cluster
  1. 安装 az 命令行界面 (CLI) (https://docs.microsoft.com/en-us/cli/azure/install-azure-cli).

  2. 验证您是否有一个包含以下内容的资源组

    • Azure Kubernetes Service (AKS) 集群。

    • AKS 集群主体需要被分配允许它在资源组中管理 Microsoft.Compute/disks 的角色。

  3. 使用以下方法设置资源组和要使用的区域作为默认值

    az configure --defaults group=<MyResourceGroup>
    az configure --defaults location=<MyAzureLocation>

    如果您没有 AKS 集群,请按照步骤创建多节点集群(每个 Neo4j 实例一个节点)。

    1. 通过运行以下命令创建集群

      az aks create --name my-neo4j-aks-cluster --node-count=<num>
    2. 配置 kubectl 以使用您的 AKS 集群,方法是

      az aks get-credentials --name my-neo4j-aks-cluster --admin