本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 AWS-维护了中节点生命周期操作的脚本 AWS PCS

AWS 为常见的生命周期操作发布维护的脚本。您可以直接从计算节点组配置中引用维护的脚本。这些脚本是等效的，每次启动时都可以安全运行。

AWS 将来自公共、 AWS托管的 Amazon S3 存储桶中的脚本分发到每个存储桶中。 AWS 区域您可以通过脚本的 Amazon S3 URI 来引用脚本。引用维护的脚本的方式与引用自己的脚本的方式相同。您可以直接从 AWS-managed 存储桶中引用脚本。

可用脚本

引用脚本

在生命周期操作scriptLocation字段中按脚本的 Amazon S3 URI 引用脚本。脚本存储在每个 AWS 区域脚本中 AWS-managed aws-pcs-repo-region 存储桶aws-pcs-node-lifecycle-scripts的前缀下。使用与您的集群 AWS 区域 相同的存储桶。

s3://aws-pcs-repo-region/aws-pcs-node-lifecycle-scripts/script-vversion.sh

每个脚本都使用语义版本控制进行版本控制。您可以固定特定版本或跟踪主要版本中的最新版本：

每个脚本在同一个位置都有一个带有.sha256后缀（例如）的配套 SHA-256 校验和文件。mount-efs-v1.0.0.sh.sha256读取该.sha256值并将其设置为脚本的checksum。然后，代理会在下载时验证脚本的完整性。有关更多信息，请参阅 脚本完整性（校验和）。

可用的脚本版本

AWS 独立版本每个脚本。下表列出了每个脚本的可用版本。使用脚本的 Amazon S3 URI 中的版本，如中所述引用脚本。

mount-efs.sh

mount-fsx-lustre.sh

configure-efs-homes.sh

configure-ldaps.sh

configure-cloudwatch-logs.sh

示例：使用维护的脚本挂载 EFS 文件系统

以下示例引用了中维护的mount-efs.sh脚本us-west-2 AWS 区域。您可以将参数作为命名标志传递。有关脚本的参数，请参见脚本参数。

aws pcs update-compute-node-group \
  --cluster-identifier my-cluster \
  --compute-node-group-identifier my-cng \
  --node-lifecycle-actions '{
    "stages": {
      "nodeBootstrapped": [
        {
          "name": "Mount EFS home directory",
          "scriptSource": {
            "scriptLocation": "s3://aws-pcs-repo-us-west-2/aws-pcs-node-lifecycle-scripts/mount-efs-v1.0.0.sh"
          },
          "arguments": ["--file-system-id", "fs-12345678", "--mount-point", "/shared"],
          "onError": "TERMINATE",
          "executionPolicy": "EVERY_BOOT"
        }
      ]
    }
  }'

节点的实例角色必须具有脚本对象的s3:GetObject权限。私有子网中的节点可以通过 S3 网关 VPC 终端节点访问存储桶。有关更多信息，请参阅 脚本存储位置。

脚本参数

每个脚本都采用命名标志参数。将每个标志及其值作为arguments数组的单独元素传递（例如，["--file-system-id", "fs-12345678"]）。所有脚本均以 AL2、AL2023、RHEL、Ubuntu 和 Rocky Linux 操作系统运行并支持。root

mount-efs.sh

使用默认iam选项时，节点的实例角色必须允许elasticfilesystem:ClientMount和elasticfilesystem:ClientWrite。该节点的子网必须有一个 EFS 挂载目标，其安全组允许来自该节点的入站 NFS (TCP 2049)。

mount-fsx-lustre.sh

节点的子网必须到达文件系统，文件系统的安全组必须允许来自该节点的入站 Lustre 流量（对于使用预留源端口的客户端，TCP 988 和 1018—1023）。

configure-efs-homes.sh

此脚本需要amazon-efs-utilsnfs-utils、和 PAM mkhomedir 支持。在 RHEL-family 节点上，安装oddjoboddjob-mkhomedir、和authselect。在 AL2023 上，authselect明确安装。在 Ubuntu 上，安装libpam-modules。IAM 和网络要求相匹配mount-efs.sh。

configure-ldaps.sh

此脚本需要sssdsssd-ldap、和sssd-tools。在 RHEL-family 节点上，它还需要authselect或authconfig和oddjob-mkhomedir。在 Ubuntu 上，它需要libpam-modules。

使用时--secret-arn，节点的实例角色必须允许secretsmanager:GetSecretValue使用密钥，并且该节点需要awscli和python3包。机密的值必须是格式的 JSON {"username": "<bind-dn>", "password": "<bind-password>"}。匿名绑定不进行 AWS API 调用，也不需要 IAM 权限。

configure-cloudwatch-logs.sh

该脚本转发生命周期操作日志目录 (/var/log/amazon/pcs/lifecycle/actions)。节点的实例角色必须在目标日志组logs:PutLogEvents上允许logs:CreateLogGrouplogs:CreateLogStream、和。使用此脚本将日志转发到实例外以进行事后调试。