AWSSupport-CheckAndMountEFS - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-CheckAndMountEFS

説明

AWSSupport-CheckAndMountEFS ランブックでは、Amazon Elastic File System (Amazon EFS) ファイルシステムをマウントするための前提条件を確認し、指定した Amazon Elastic Compute Cloud (Amazon EC2) インスタンスにファイルシステムをマウントします。このランブックでは、Amazon EFS ファイルシステムをマウントする際に、DNS 名、またはマウントのターゲットとなる IP アドレスを使用することができます。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

所有者

Amazon

[Platforms] (プラットフォーム)

Linux

パラメータ

  • AutomationAssumeRole

    型: 文字列

    説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

  • [アクション]

    型: 文字列

    有効な値: Check | CheckAndMount

    説明: (必須) ランブックが前提条件のみを確認するのか、前提条件を確認した後でファイルシステムをマウントするのかを決定します。

  • EfsId

    型: 文字列

    説明: (必須) マウントするファイルシステムの ID。

  • InstanceId

    型: 文字列

    説明: (必須) ファイルシステムをマウントする Amazon EC2 インスタンスの ID。

  • MountOptions

    型: 文字列

    説明: (オプション) ファイルシステムのマウントに使用する Amazon EFS マウントヘルパーでサポートされるオプション。tls オプションを指定する場合は、ターゲットのインスタンスで stunnel がアップグレードされていることを確認します。

  • MountPoint

    型: 文字列

    説明: (オプション) ファイルシステムをマウントするディレクトリ。Action パラメータで Check 値を指定する場合は、このパラメータを指定しないでください。

  • MountTargetIP

    型: 文字列

    説明: (オプション) マウントのターゲットとなる IP アドレス。IP アドレスによるマウントは、DNS ホスト名が無効化されている仮想プライベートクラウド (VPC) などの、DNS が無効な環境で機能します。また、Amazon Route 53 (Route 53) 以外の DNS プロバイダーを使用している環境でも、このオプションを使用できます。

  • リージョン

    型: 文字列

    説明: (必須) AWS リージョン Amazon EC2 インスタンスとファイルシステムがある 。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • ssm:DescribeAutomationExecutions

  • ssm:DescribeAutomationStepExecutions

  • ssm:DescribeAutomationStepExecutions

  • ssm:DescribeInstanceInformation

  • ssm:DescribeInstanceProperties

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:GetDocument

  • ssm:ListCommands

  • ssm:ListCommandInvocations

  • ssm:ListDocuments

  • ssm:StartAutomationExecution

  • iam:ListRoles

  • ec2:DescribeInstances

  • ec2:DescribeSecurityGroups

  • elasticfilesystem:DescribeFileSystemPolicy

  • elasticfilesystem:DescribeMountTargets

  • elasticfilesystem:DescribeMountTargetSecurityGroups

  • resource-groups:*

ドキュメントステップ

  • aws:executeScript - InstanceId パラメータで指定された Amazon EC2 インスタンスの詳細を収集します。

  • aws:executeScript - EfsId パラメータで指定されたファイルシステムの詳細を収集します。

  • aws:executeScript - ファイルシステムに関連付けられたセキュリティグループが、InstanceId パラメータで指定された Amazon EC2 インスタンスからのポート 2049 でのトラフィックを許可しているかを確認します。

  • aws:assertAwsResourceProperty - InstanceId パラメータで指定した Amazon EC2 インスタンスが Systems Manager によって管理されており、ステータスが Online であることを確認します。

  • aws:branch - Action パラメータで指定した値に基づいて分岐させます。

  • aws:runCommand - EfsId パラメータで指定されたファイルシステムをマウントするための前提条件を確認します。

  • aws:runCommand - EfsId パラメータで指定されたファイルシステムをマウントするための前提条件を確認し、このファイルシステムを、InstanceId パラメータで指定された Amazon EC2 インスタンスにマウントします。