ocf_heartbeat_aws-vpc-route53(7)

1OCF_HEARTBEAT_AWS-V(7)        OCF resource agents       OCF_HEARTBEAT_AWS-V(7)
2
3
4

NAME

6       ocf_heartbeat_aws-vpc-route53 - Update Route53 VPC record for AWS EC2
7

SYNOPSIS

9       aws-vpc-route53 [start | stop | monitor | meta-data | validate-all]
10

DESCRIPTION

12       Update Route53 record of Amazon Webservices EC2 by updating an entry in
13       a hosted zone ID table.
14
15       AWS instances will require policies which allow them to update Route53
16       ARecords: { "Version": "2012-10-17", "Statement": [ { "Sid":
17       "Stmt1471878724000", "Effect": "Allow", "Action": [
18       "route53:ChangeResourceRecordSets", "route53:GetChange",
19       "route53:ListResourceRecordSets", ], "Resource": [ "*" ] } ] }
20
21       Example Cluster Configuration:
22
23       Use a configuration in "crm configure edit" which looks as follows.
24       Replace hostedzoneid, fullname and profile with the appropriate values:
25
26       primitive res_route53 ocf:heartbeat:aws-vpc-route53 params
27       hostedzoneid=EX4MPL3EX4MPL3 fullname=service.cloud.example.corp.
28       profile=cluster op start interval=0 timeout=180 op stop interval=0
29       timeout=180 op monitor interval=300 timeout=180 meta
30       target-role=Started
31

SUPPORTED PARAMETERS

33       hostedzoneid
34           Hosted zone ID of Route 53. This is the table of the Route 53
35           record.
36
37           (required, string, no default)
38
39       fullname
40           The full name of the service which will host the IP address.
41           Example: service.cloud.example.corp. Note: The trailing dot is
42           important to Route53!
43
44           (required, string, no default)
45
46       ttl
47           Time to live for Route53 ARECORD
48
49           (optional, string, default "10")
50
51       profile
52           The name of the AWS CLI profile of the root account. This profile
53           will have to use the "text" format for CLI output. The file
54           /root/.aws/config should have an entry which looks like:
55
56           [profile cluster] region = us-east-1 output = text
57
58           "cluster" is the name which has to be used in the cluster
59           configuration. The region has to be the current one. The output has
60           to be "text".
61
62           (required, string, no default)
63

SUPPORTED ACTIONS

65       This resource agent supports the following actions (operations):
66
67       start
68           Starts the resource. Suggested minimum timeout: 180s.
69
70       stop
71           Stops the resource. Suggested minimum timeout: 180s.
72
73       monitor
74           Performs a detailed status check. Suggested minimum timeout: 180s.
75           Suggested interval: 300s.
76
77       validate-all
78           Performs a validation of the resource configuration. Suggested
79           minimum timeout: 5s.
80
81       meta-data
82           Retrieves resource agent metadata (internal use only). Suggested
83           minimum timeout: 5s.
84

EXAMPLE CRM SHELL

86       The following is an example configuration for a aws-vpc-route53
87       resource using the crm(8) shell:
88
89           primitive p_aws-vpc-route53 ocf:heartbeat:aws-vpc-route53 \
90             params \
91               hostedzoneid=string \
92               fullname=string \
93               profile=string \
94             op monitor depth="0" timeout="180s" interval="300s"
95

EXAMPLE PCS

97       The following is an example configuration for a aws-vpc-route53
98       resource using pcs(8)
99
100           pcs resource create p_aws-vpc-route53 ocf:heartbeat:aws-vpc-route53 \
101             hostedzoneid=string \
102             fullname=string \
103             profile=string \
104             op monitor depth="0" timeout="180s" interval="300s"
105

AUTHOR

110       ClusterLabs contributors (see the resource agent source for information
111       about individual authors)
112
113
114
115resource-agents UNKNOWN           03/09/2020            OCF_HEARTBEAT_AWS-V(7)