Tutorial: Getting Started with the OUTSCALE Cloud

In this tutorial, you learn how to launch and connect to your first instance in the 3DS 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.

For this tutorial, you can use either:

  • Cockpit, a web interface developed by 3DS OUTSCALE that enables you to create and manage your resources in the OUTSCALE Cloud. For more information, see About Cockpit.

  • OSC CLI, a command-line interface (CLI) developed by 3DS OUTSCALE, which is compatible with all AWS-compliant API services. For more information, see Installing and Configuring OSC CLI.

  • AWS CLI, a CLI developed by Amazon Web Services, which is compatible with all AWS-compliant API services except Internal Call Unit (ICU). For more information, see Installing and Configuring AWS CLI.

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

Getting Started with the OUTSCALE Cloud Using Cockpit

  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:

    Your instance is created and configured.

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

Getting Started with the OUTSCALE Cloud Using OSC CLI

Install and Configure OSC CLI

Create Your First Keypair

  • To securely connect to your instances, you need to create a keypair using the following CreateKeyPair command:

    Request sample
    $ osc-cli fcu CreateKeyPair \
        --KeyName MyKeyPair

    For more information, see CreateKeyPair in the AWS-compliant API documentation.

Create Your First Security Group

  1. To manage the inbound and outbound flows of your instance, you need to create a security group using the following CreateSecurityGroup command:

    Request sample
    $ osc-cli fcu CreateSecurityGroup \
        --GroupName my-security-group \
        --GroupDescription SECURITY_GROUP_DESCRIPTION

    For more information, see CreateSecurityGroup in the AWS-compliant API documentation.

  2. To allow flows in a specific protocol on specific ports, add a rule to your security group using the following AuthorizeSecurityGroupIngress command:

    Request sample
    $ osc-cli fcu AuthorizeSecurityGroupIngress \
        --GroupName my-security-group \
        --IpProtocol tcp \
        --FromPort 22 \
        --ToPort 22 \
        --CidrIp xx.xx.xx.xx/32

    where xx.xx.xx.xx is the IP of your current computer.

    For more information, see AuthorizeSecurityGroupIngress in the AWS-compliant API documentation.

Launch and Accessing Your First Instance

  1. To launch your first instance, use the RunInstances command following this syntax:

    Request sample
    $ osc-cli fcu RunInstances \
        --ImageId ami-xxxxxxxx \
        --KeyName MyKeyPair \
        --SecurityGroup my-security-group \
        --MinCount 1 \
        --MaxCount 1

    where ami-xxxxxxxx is the ID of the OMI to use to launch the instance. For more information, see About OMIs and Official OMIs Reference.

    For more information, see RunInstances in the AWS-compliant API documentation.

  2. To connect to your instance, see Accessing Your Instances.

Getting Started with the OUTSCALE Cloud Using AWS CLI

Install and Configure AWS CLI

Create Your First Keypair

  • 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

    For more information, see Creating a Keypair.

Create Your First Security Group

  1. To manage the inbound and outbound flows of your instance, you need to create a security group using the following create-security-group command:

    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

    For more information, see Creating a Security Group.

  2. To allow flows in a specific protocol on specific ports, add a rule to your security group using the following authorize-security-group-ingress command:

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

    where xx.xx.xx.xx is the IP of your current computer.

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

Launch and Access Your First Instance

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

    Request sample
    $ aws ec2 run-instances \
        --profile YOUR_PROFILE \
        --image-id ami-xxxxxxxx \
        --key-name MyKeyPair \
        --security-groups my-security-group \
        --endpoint https://fcu.eu-west-2.outscale.com

    where ami-xxxxxxxx is the ID of the OMI to use to launch the instance. For more information, see About OMIs and Official OMIs Reference.

    For more information, see Launching Instances Using AWS CLI.

  2. To connect to your instance, see Accessing Your Instances.

Related Pages

Corresponding API Methods

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