ocf_heartbeat_gcp-vpc-move-route(7)

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

NAME

6       ocf_heartbeat_gcp-vpc-move-route - Move IP within a GCP VPC
7

SYNOPSIS

9       gcp-vpc-move-route [start | stop | monitor | meta-data | validate-all]
10

DESCRIPTION

12       Resource Agent that can move a floating IP addresse within a GCP VPC by
13       changing an entry in the routing table. This agent also configures the
14       floating IP locally on the instance OS. Requirements :
15
16       - IP forwarding must be enabled on all instances in order to be able to
17       terminate the route
18
19       - The floating IP address must be chosen so that it is outside all
20       existing subnets in the VPC network
21
22       - IAM permissions (see
23       https://cloud.google.com/compute/docs/access/iam-permissions) : 1)
24       compute.routes.delete, compute.routes.get and compute.routes.update on
25       the route 2) compute.networks.updatePolicy on the network (to add a new
26       route) 3) compute.networks.get on the network (to check the VPC network
27       existence) 4) compute.routes.list on the project (to check conflicting
28       routes)
29

SUPPORTED PARAMETERS

31       ip
32           Floating IP address. Note that this IP must be chosen outside of
33           all existing subnet ranges
34
35           (unique, required, string, no default)
36
37       vpc_network
38           Name of the VPC network
39
40           (required, string, default "default")
41
42       interface
43           Name of the network interface
44
45           (optional, string, default "eth0")
46
47       route_name
48           Route name
49
50           (unique, optional, string, default "ra-gcp-vpc-move-route")
51
52       stackdriver_logging
53           If enabled (set to true), IP failover logs will be posted to
54           stackdriver logging
55
56           (optional, boolean, default false)
57

SUPPORTED ACTIONS

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

EXAMPLE CRM SHELL

80       The following is an example configuration for a gcp-vpc-move-route
81       resource using the crm(8) shell:
82
83           primitive p_gcp-vpc-move-route ocf:heartbeat:gcp-vpc-move-route \
84             params \
85               ip=string \
86               vpc_network="default" \
87             op monitor depth="0" timeout="30s" interval="60s"
88

EXAMPLE PCS

90       The following is an example configuration for a gcp-vpc-move-route
91       resource using pcs(8)
92
93           pcs resource create p_gcp-vpc-move-route ocf:heartbeat:gcp-vpc-move-route \
94             ip=string \
95             vpc_network="default" \
96             op monitor depth="0" timeout="30s" interval="60s"
97

AUTHOR

102       ClusterLabs contributors (see the resource agent source for information
103       about individual authors)
104
105
106
107resource-agents UNKNOWN           03/15/2019            OCF_HEARTBEAT_GCP-V(7)