IBM::Google::Server

This resource type represents a server on Google Cloud Platform. It extends the type OS::Nova::Server.

The blueprint uses the core properties and extended properties, if any, from this resource type. Review and configure the applicable heat resources that apply to your configuration information.

In the blueprint designer, you can configure the properties that the following table includes. Properties are listed as either "core" or "extended." Each type of property is located in separate sections of the heat resource that you can view in the blueprint designer. You set the core properties in the properties section and set the extended properties in the metadata section of the blueprint.

Table 1. Properties
Name	Type	Required	Core or extended	Description
admin_pass	String	False	Core	The administrator password for the server.
admin_user	String	False	Core	Name of the administrative user to use on the server. This property will be removed from Juno in favor of the default cloud-init user that is set up for each image (for example, "ubuntu" for Ubuntu 12.04+, "fedora" for Fedora 19+ and "cloud-user" for CentOS/Red Hat Enterprise Linux 6.5).
cpus	Integer	False	Extended	CPUS on the instance.
availability_zone	String	False	Core	Name of the availability zone for server placement.
auto_delete_boot_disk	Boolean	False	Extended	If `True`, boot disk is deleted when instance is deleted.
block_device_mapping	List	False	Core	Block device mappings for this server. Use either the block_device_mapping property or the block_device_mapping_v2 property. See Table 2.
block_device_mapping_v2	List	False	Core	Expanded block device mappings for this server. Use either the block_device_mapping property or the block_device_mapping_v2 property. See Table 3.
block_project_ssh_keys	String	False	Extended	If `True`, project-wide ssh keys cannot access the instance.
config_drive	Boolean	False	Core	If `True`, enable config drive on the server.
diskConfig	String	False	Core	Control how the disk is partitioned when the server is created. Valid values are `AUTO` and `MANUAL`.
disk_size	Integer	False	Extended	Disk size in GB of the base disk of the instance.
flavor	String	True	Core	The ID or name of the flavor to boot onto.
flavor_update_policy	String	False	Core	Policy on how to apply a flavor update; either by requesting a server resize or by replacing the entire server. Valid values are `RESIZE` and `REPLACE`.
image	String	True	Core	The ID or name of the image to boot with.
image_update_policy	String	False	Core	Policy on how to apply an image-id update; either by requesting a server rebuild or by replacing the entire server. Valid values are `REPLACE` (the default) `REBUILD` `REBUILD_PRESERVE_EPHEMERAL`
key_name	String	False	Core	Name of key pair to inject into the server.
memory	Integer	False	Extended	Memory in MB of the instances.
metadata	Map	False	Core	Arbitrary key/value metadata to store for this server. Both keys and values must be 255 characters or less. Non-string values are serialized to JSON (and the serialized string must be 255 characters or less).
name	String	False	Core	Server name.
networks	List	False	Core	An ordered list of NICs to be added to this server, with information about connected networks, fixed IP addresses, and ports. See Table 4.
personality	Map	False	Core	A map of files to create/overwrite on the server upon boot. Keys are file names and values are the file contents.
reservation_id	String	False	Core	A UUID for the set of servers requested.
scheduler_hints	Map	False	Core	Arbitrary key-value pairs that are specified by the client to help boot a server.
security_groups	List	False	Core	List of security group names or IDs. Cannot be used if neutron ports are associated with this server; assign security groups to the ports instead.
software_config_transport	String	False	Core	Specifies how the server receives the metadata that is required for software configuration. `POLL_SERVER_CFN` allows calls to the Cloud Formation API action DescribeStackResource authenticated with the provided key pair. `POLL_SERVER_HEAT` allows calls to the Heat API action resource-show by using the provided keystone credentials.
user_data	String	False	Core	User data script to be run by cloud-init.
user_data_format	String	False	Core	How the user_data is formatted for the server. For `HEAT_CFNTOOLS`, the user_data is bundled as part of the `heat-cfntools cloud-init` boot configuration data. For `RAW` the `user_data` is passed to Nova unmodified. For `SOFTWARE_CONFIG` the `user_data` is bundled as part of the software configuration data, and metadata is derived from any associated SoftwareDeployment resources.

The block_device_mapping parameter requires a list of storage volume mappings for the server. The following table shows the properties in each list item.

Table 2. block_device_mapping list properties
Property	Type	Required	Description
delete_on_termination	Boolean	False	Indicates whether the volume is deleted when the server is stopped.
device_name	String	False	A device name where the volume is attached in the system at /dev/device_name. This value is typically `vda`.
snapshot_id	String	False	The ID of the snapshot to create a volume from.
volume_id	String	False	The ID of the volume to boot from. Provide either the volume_id property or the snapshot_id property but not both.
volume_size	Integer	False	The size of the volume, in GB. You can leave this property blank and have the Compute service infer the size.

The block_device_mapping_v2 parameter requires an expanded list of storage volume mappings for the server. The following table shows the properties in each list item.

Table 3. block_device_mapping_v2 list properties
Property	Type	Required	Description
boot_index	Integer	False
delete_on_termination	Boolean	False	Indicates whether the volume is deleted when the server is stopped.
device_name	String	False	A device name where the volume is attached in the system at /dev/device_name. This value is typically `vda`.
device_type	String	False
disk_bus	String	False
image_id	String	False
snapshot_id	String	False	The ID of the snapshot to create a volume from.
swap_size	Integer	False
volume_id	String	False	The ID of the volume to boot from. Provide either the volume_id property or the snapshot_id property but not both.
volume_size	Integer	False	The size of the volume, in GB. You can leave this property blank and have the Compute service infer the size.

The networks parameter requires a list of NICs for the server. The following table shows the properties in each list item.

Table 4. networks list properties
Property	Type	Required	Description
fixed_ip	String	False	Fixed IP address to specify for the port that is created on the requested network
network	String	False	Name or ID of network to create a port on.
port	String	False	ID of an existing port to associate with this server.
uuid	String	False	ID of network to create a port on.

Table 5. Attributes
Name	Description
accessIPv4	The manually assigned alternative public IPv4 address of the server.
accessIPv6	The manually assigned alternative public IPv6 address of the server.
addresses	A dict of all network addresses with corresponding port_id. The port ID may be obtained through the following expression: `{get_attr: [server, addresses, network_name, 0, port]}`
console_urls	URLs of server's consoles. To get a specific console type, the requested type can be specified as parameter to the `get_attr` function,as shown in the following code: `get_attr: [ server, console_urls, novnc ]`. The following types are allowed: `novnc` `xvpvnc` `spice-html5` `rdp-html5` `serial`
cpu_platform	The CPU platform used by this instance.
first_address	A convenience attribute to fetch the first assigned network address, or an empty string if nothing is assigned. Result might not be predictable if the server has addresses from more than one network.
instance_name	A Google Cloud Platform compatible instance name.
metadata_fingerprint	Fingerprint of metadata contents.
name	The name of the server.
networks	A dict of assigned network addresses of the form: `{"public": [ip1, ip2...], "private": [ip3, ip4]}`.
public_ip_address	Returns public IP address for this instance, if one exists.
self_link	Server-defined URL for this resource.
show	A dict of all server details as returned by the API.
tags_fingerprint	Fingerprint of tags contents.

Feedback