In this tutorial, you learn how to launch and connect to your first instance in the Outscale Cloud.

An instance is a virtual machine in the public Cloud or in a Virtual Private Cloud (VPC), that is, an isolated virtual network in the Cloud. For more information, see About Instances and About VPCs.

This tutorial uses:

  • Cockpit, a web interface developed by Outscale that enables you to create and manage your resources in the Outscale Cloud. For more information, see About Cockpit.
  • AWS CLI, a command line interface (CLI) released by Amazon Web Services™, which is fully compatible with the Outscale Cloud. For more information, see Using AWS CLI in the Outscale Cloud.


Our Support team is available to help you if necessary. For more information, see Technical Support.

The following procedures are available:


Getting Started with the Outscale Cloud Using Cockpit


Before you begin: Create an Outscale account. For more information, see Creating Your Outscale Account.

 

  1. (optional) To securely connect to your instances, create a keypair. For more information, see Creating a Keypair.


  2. (optional) To manage the inbound and outbound flows of your instances, create a security group. For more information, see Creating a Security Group.


  3. To launch your first instance, choose one of the following modes:

    • The Basic mode, if you want to create a pre-configured instance. For more information, see Basic Mode: Launching a Preconfigured Instance Using Cockpit.

    • The Advanced mode, if you want to create and configure an instance. For more information, see Advanced Mode: Launching an Instance Using Cockpit.

      When creating an instance in Advanced mode, Step 2 above is not optional. You must create a security group before launching the instance.

    • The Expert mode, if you want to create one or more fully custom instances. For more information, see Expert Mode: Launching Custom Instances Using Cockpit.

    Your instance is created and configured.

  4. Connect to your instance. For more information, see Accessing Your Instances.


    You can use other features available in the Outscale Cloud. For more information, see Cockpit Features Reference.

Getting Started with the Outscale Cloud Using AWS CLI


Before you begin: Create an Outscale account. For more information, see Creating Your Outscale Account.


  1. To sign your API requests, create an access key. For more information, see Creating an Access Key.

  2. To send API requests, install AWS CLI. For more information, see Using AWS CLI in the Outscale Cloud.

  3. To securely connect to your instances, you need to create a keypair. To do so, use the create-key-pair command following this syntax:

    Request sample
    $> aws ec2 create-key-pair \
    	--profile YOUR_PROFILE \
        --key-name MyKeyPair \
        --endpoint https://fcu.eu-west-2.outscale.com

    This command contains the following attributes that you need to specify:

    • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Using AWS CLI in the Outscale Cloud.

    • key-name: A unique name for the keypair, with a maximum length of 255 ASCII characters.

    • endpoint: The endpoint corresponding to the Region you want to send the request to.

    For more information, see Creating a Keypair.

  4. To manage the inbound and outbound flows of your instance, you need a security group:

    1. To create a security group, use the create-security-group command following this syntax:

      Request sample
      $> aws ec2 create-security-group \
      	--profile YOUR_PROFILE \
          --group-name my-security-group \
      	--description SECURITY_GROUP_DESCRIPTION \
          --endpoint https://fcu.eu-west-2.outscale.com

      This command contains the following attributes that you need to specify:

      • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Using AWS CLI in the Outscale Cloud.

      • group-name: A unique name for the security group, with a maximum length of 255 ASCII characters.
      • description: A description of the security group.
      • endpoint: The endpoint corresponding to the Region you want to send the request to.

      For more information, see Creating a Security Group.

    2. To allow flows in a specific protocol and on specific ports, you need to add rules to the security group. To do so, use the authorize-security-group-ingress command following this syntax:

      Request sample
      $> aws ec2 authorize-security-group-ingress \
      	--profile YOUR_PROFILE \
      	--group-name my-security-group \
      	--protocol tcp \
      	--port 22 \
      	--cidr 42.42.42.42/32 \
      	--endpoint https://fcu.eu-west-2.outscale.com

      This command contains the following attributes that you need to specify:

      • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Using AWS CLI in the Outscale Cloud.

      • group-name: The name of the security group, if you are working in the public Cloud.
      • group-id: The ID of the security group, if you are working in a VPC.
      • protocol: The protocol you want to use (tcp | udp | icmp).  
      • port: The port number.

      • cidr: The IP address or the range of IP addresses you want to allow, in CIDR notation (/32 prefix for a single IP address).

      • endpoint: The endpoint corresponding to the Region you want to send the request to.

      For more information, see Adding Rules to a Security Group.


  5. To launch your instance, use the run-instances command following this syntax:

    Request sample
    $> aws ec2 run-instances \
    	--profile YOUR_PROFILE \
        --image-id ami-12345678 \
    	--key-name MyKeyPair \
    	--security-groups my-security-group \
    	--security-group-ids sg-187654321 \
    	--instance-type m3.large \
    	--count 1 \
        --endpoint https://fcu.eu-west-2.outscale.com

    This command contains the following attributes that you need to specify:

    • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Using AWS CLI in the Outscale Cloud.

    • image-id: The ID of the OMI to use to launch the instance. For more information, see About OMIs and Instances and OMIs Reference Information.

    • security-groups: The name of the previously created security group, if you are working in the public Cloud.

    • security-group-ids: The ID of the previously created security group, if you are working in a VPC.

    • instance-type: The instance type. If not specified, an m1.small instance is created. For more information, see Instance Types.

    • count: The number of instances to launch.

    • endpoint: The endpoint corresponding to the Region you want to send the request to.

    For more information, see Launching Instances Using AWS CLI.

  6. To access your instance, see Accessing Your Instances.


Windows® is a registered mark of Microsoft Corporation in the United States and/or other countries.

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.

See Legal Mentions.