Struct Ec2Instance 

pub struct Ec2Instance { /* private fields */ }

Represents a currently running EC2 instance and provides various methods for interacting with the instance.

This type implements serde Serialize/Deserialize to allow you to save and restore the instance from disk. After restoring Ec2Instance in this way you need to call the Ec2Instance::init method.

Implementations

impl Ec2Instance

pub fn public_ip(&self) -> Option<IpAddr>

Use this address to connect to this instance from outside of AWS

pub fn private_ip(&self) -> IpAddr

Use this address to connect to this instance from within AWS

pub fn connect_ip(&self) -> IpAddr

Use this address to get the private or public IP that aws-throwaway is using to ssh to the instance. Whether or not this is public is decided by crate::AwsBuilder::use_public_addresses.

You should use this address if you want to connect to the instance from your local machine

pub fn network_interfaces(&self) -> &[NetworkInterface]

List of all network interfaces attached to this instance. Includes the primary interface that has the ip returned by Ec2Instance::private_ip as well as all other interfaces attached to this instance at the time it was created.

pub fn client_private_key(&self) -> &str

Use this as the private key of your machine when connecting to this instance

pub fn host_public_key_bytes(&self) -> &[u8]

Use this for authenticating a host programmatically

pub fn openssh_known_hosts_line(&self) -> String

Insert this into your known_hosts file to avoid errors due to unknown fingerprints

pub fn ssh(&self) -> &SshConnection

Returns an object that allows commands to be sent over ssh

pub fn ssh_instructions(&self) -> String

Get a list of commands that the user can paste into bash to manually open an ssh connection to this instance.

pub async fn terminate(self, aws: &Aws)

Delete this instance. Prefer using Aws::cleanup_resources at end of runtime as it will automatically destroy all resources, not just this one instance. However this method can be useful when you have a single instance that you would like to terminate before the rest.

Aws instance must be passed in manually here since Ec2Instances can be deserialized when there is no Aws instance.

pub async fn init(&mut self) -> Result<()>

After deserializing Ec2Instance this method must be called to recreate the ssh connection.

No need to call after creating via crate::Aws::create_ec2_instance

Trait Implementations

impl<'de> Deserialize<'de> for Ec2Instance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Ec2Instance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.