Keypair.md 2.02 KB
edit raw blame history


Keypairs
Generate new keypair
This operation creates a new keypair under a provided name; the public key value is automatically generated for you.


    $keypair = $service->keypair();

$keypair->create(array(
   'name' => 'jamie_keypair_1'
));

echo $keypair->getPublicKey();

  
Upload existing keypair
This operation creates a new keypair under a provided name using a provided public key value. This public key will probably exist on your local filesystem, and so provide easy access to your server when uploaded.


    $keypair = $service->keypair();

$key = <<<EOT
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDx8nkQv/zgGgB4rMYmIf+6A4l6Rr+o/6lHBQdW5aYd44bd8JttDCE/F/pNRr0lRE+PiqSPO8nDPHw0010JeMH9gYgnnFlyY3/OcJ02RhIPyyxYpv9FhY+2YiUkpwFOcLImyrxEsYXpD/0d3ac30bNH6Sw9JD9UZHYcpSxsIbECHw== Example public key
EOT;

$keypair->create(array(
   'name'      => 'jamie_macbook',
   'publicKey' => $key
));


List keypairs
To list all existing keypairs:


    $keys = $service->listKeypairs();

foreach ($keys as $key) {
   // ...
}

  
For more information about iterators, please see the docs.
Delete keypairs
To delete a specific keypair:


    $keypair->delete();

  
Creating a server with a keypair
In order to spawn an instance with a saved keypair (allowing you to SSH in without passwords), you create your server
using the same operation as usual, with one extra parameter:


    use Guzzle\Http\Exception\BadResponseException;
use OpenCloud\Compute\Constants\Network;

$server = $compute->server();

try {
    $response = $server->create(array(
        'name'     => 'New server',
        'image'    => $ubuntuImage,
        'flavor'   => $twoGbFlavor,
        'networks' => array(
            $compute->network(Network::RAX_PUBLIC),
            $compute->network(Network::RAX_PRIVATE)
        ),
        'keypair' => 'jamie_macbook'
    ));
} catch (BadResponseException $e) {
   // error...
}

  
So, as you can see, you specify the name of an existing keypair that you previously created on the API.