Servers

Intro

A server is a virtual machine instance in the Cloud Servers environment.

Setup

Server objects are instantiated from the Compute service. For more details, see the Service docs.

Get server

The easiest way to retrieve a specific server is by its unique ID:

$serverId = 'ef08aa7a-b5e4-4bb8-86df-5ac56230f841';
$server   = $service->server($serverId);

List servers

You can list servers in two different ways:

• return an overview of each server (ID, name and links)
• return detailed information for each server

Knowing which option to use might help save unnecessary bandwidth and reduce latency.

// overview
$servers = $service->serverList();

// detailed
$servers = $service->serverList(true);

URL parameters for filtering servers

Create server

There are a few parameter requirements when creating a server:

• name - needs to be a string;
• flavor - a OpenCloud\Compute\Resource\Flavor object, that is populated with the values of a real API flavor;
• image - a OpenCloud\Compute\Resource\Image object, that is populated with the values of a real API image;
• networks - an array of OpenCloud\Compute\Resource\Network objects which represent which networks you compute instance will be placed in.

Firstly we need to find our flavor and image using their UUIDs. For more information about these concepts, including how to find flavor/image UUIDs, please consult §§ 3-4 in the Getting Started guide.

$ubuntuImage = $compute->image('868a0966-0553-42fe-b8b3-5cadc0e0b3c5');
$twoGbFlavor = $compute->flavor('4');

Now we're ready to create our instance:

use OpenCloud\Compute\Constants\Network;

$server = $compute->server();

try {
    $response = $server->create(array(
        'name'     => 'My lovely server',
        'image'    => $ubuntuImage,
        'flavor'   => $twoGbFlavor,
        'networks' => array(
            $compute->network(Network::RAX_PUBLIC),
            $compute->network(Network::RAX_PRIVATE)
        )
    ));
} catch (\Guzzle\Http\Exception\BadResponseException $e) {

    // No! Something failed. Let's find out:
    $responseBody = (string) $e->getResponse()->getBody();
    $statusCode   = $e->getResponse()->getStatusCode();
    $headers      = $e->getResponse()->getHeaderLines();

    echo sprintf('Status: %s\nBody: %s\nHeaders: %s', $statusCode, $responseBody, implode(', ', $headers);
}

It's always best to be defensive when executing functionality over HTTP; you can achieve this best by wrapping calls in a try/catch block. It allows you to debug your failed operations in a graceful and efficient manner.

Create parameters

Creating a server with keypairs

Please see the Keypair docs for more information.

Creating a server with personality files

Before you execute the create operation, you can add "personality" files to your OpenCloud\Compute\Resource\Server object. These files are structured as a flat array.

$server->addFile('/var/test_file', 'FILE CONTENT');

As you can see, the first parameter represents the filename, and the second is a string representation of its content. When the server is created these files will be created on its local filesystem. For more information about server personality files, please consult the official documentation.

Update server

You can update certain attributes of an existing server instance. These attributes are detailed in the next section.

$server->update(array(
   'name' => 'NEW SERVER NAME'
));

Updatable attributes

Delete server

$server->delete();