Skip to content

Add details about cloning a server from an image #119

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.

Sign up for GitHub

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

Closed
wants to merge 1 commit into from
Closed

Add details about cloning a server from an image #119

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 15 additions & 2 deletions docs/cloud_servers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ This should return something like:
Since you can't do anything with your new server until it finishes building, it would be helpful to have a way of determining when the build is complete. So `pyrax` includes the `wait_until()` method in its `utils` module. Here is a typical usage:

srv = cs.servers.create(…)
new_srv = pyrax.utils.wait_until(srv, "status",
new_srv = pyrax.utils.wait_until(srv, "status",
["ACTIVE", "ERROR"], attempts=0)

When you run the above code, execution will block until the server's status reaches one of the two values in the list. Note that we just don't want to check for "ACTIVE" status, since server creation can fail, and the `wait_until()` call will wait forever.
Expand Down Expand Up @@ -250,8 +250,21 @@ If you have a `Server` object and want to create an image of that server, you ca
Another option is to use call `pyrax.servers.create_image()`, passing in either the name or the ID of the server from which you want to create the image, along with the image name and optional metadata.

cs = pyrax.cloudservers
cs.servers.create_image("my_awesome_server", "my_image_name")
image_id = cs.servers.create_image("my_awesome_server", "my_image_name")
# Unlike the create_server call, `create_image()` returns the id rather than an `Image` object
image = cs.images.get(image_id)

The created image will also appear in the list of images with the name you gave it.

cs.images.list()

You will need to wait for the imaging to finish before you are able to clone it.

image_id = server.create_image("base_image")
image = cs.images.get(im)
# Note that you need to wait for the image to be finished before cloning
image = pyrax.wait_until(image, "status", ["ACTIVE", "ERROR"], attempts=0)
cs.servers.create(name="clone", image=image.id)

## Resizing a Server
Resizing a server is the process of changing the amount of resources allocated to the server. In Cloud Servers terms, it means changing the Flavor of the server: that is, changing the RAM and disk space allocated to that server.
Expand Down