Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Implement describe instance #116

Closed
wants to merge 1 commit into from
Closed

Implement describe instance #116

wants to merge 1 commit into from

Conversation

mxpv
Copy link
Contributor

@mxpv mxpv commented Aug 27, 2019

Signed-off-by: Maksym Pavlenko makpav@amazon.com

Issue #, if available:
#115
firecracker-microvm/firecracker-containerd#251

Description of changes:
This PR adds DescribeInstance to sdk

cc: @haikuoliu

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Signed-off-by: Maksym Pavlenko <makpav@amazon.com>
@@ -672,6 +672,18 @@ func (m *Machine) UpdateGuestDrive(ctx context.Context, driveID, pathOnHost stri
return nil
}

// DescribeInstance returns general information about an instance.
func (m *Machine) DescribeInstance(ctx context.Context) (*models.InstanceInfo, error) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like this is the first case where we're just returning a struct from models instead of doing something else to the return value to make it more useful. I'm worried that establishing a pattern where we wrap the Swagger client and provide little additional logic will be both hard for us to maintain and not super valuable.

Instead of doing this, it might be better to expose easier access to the underlying Swagger client for any operations that we haven't built a higher-level interface around.

func (m *Machine) APIClient() Client {
	return m.client
}

What do you think?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm totally fine with exposing APIClient as it would simplify support existing/future firecracker API features. However there are a few things that bother me:

  1. We already wrap other things, like UpdateGuestDrive, SetMetadata, UpdateGuestNetworkInterfaceRateLimit, etc. Essentially these methods just passthrough parameters to API client. As we want to be backward compatible, we would allow to do same thing in two different ways.
  2. We exposed MachineIface interface as part of SDK which is handy for testing (when we don't want to run an actual Firecracker instance, but just a few mock calls). As firecracker client is auto generated with no interface, this might lead to some complexities with testing.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was thinking about this yesterday and think this is the best path going forward, a helper method to retrieve the API client.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After some discussion offline, I'll revisit this in a separate PR.

@mxpv mxpv closed this Aug 28, 2019
@mxpv mxpv deleted the describe_instance branch August 28, 2019 19:25
@ghost
Copy link

ghost commented Jun 10, 2020

I see that this work was scrapped in favor of providing a getter method for the inner client, I would be willing to implement if the change isn't already in progress.

I'm looking for a way to run a health check against a running VM and know that it is in the running state. Are there any existing solutions?

pendo324 pushed a commit to pendo324/firecracker-go-sdk that referenced this pull request Aug 27, 2024
Set the agent shim as a subreaper to ensure containers become its children
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants