Outscale Provider

Generate Provider

The Outscale provider must be installed as a Local Package by following the instructions for Any Terraform Provider:

pulumi package add terraform-provider outscale/outscale

Overview

The OUTSCALE provider is used to manage OUTSCALE Cloud resources.Use the navigation to the left to read about the available resources. For more information on our resources, see the User Guide.

The provider is based on our OUTSCALE API. For more information, see APIs Reference and the API Documentation.

The provider needs to be configured with the proper credentials before it can be used.

Note: To configure the provider, see our README and the Pulumi documentation.
To configure a proxy, see our README.

Example

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:
config:
    outscale:accessKeyId:
        value: 'TODO: var.access_key_id'
    outscale:secretKeyId:
        value: 'TODO: var.secret_key_id'

Authentication

OUTSCALE authentication is based on access keys composed of an access key ID and a secret key. For more information on access keys, see About Access Keys. To retrieve your access keys, see Getting Information About Your Access Keys.

The OUTSCALE provider supports different ways of providing credentials for authentication. The following methods are supported:

1. Static credentials
2. Environment variables

Static credentials

!> Hard-coding credentials into any Pulumi configuration is not recommended, and risks secret leakage should this file ever be committed to a public version control system.

You can provide your credentials by specifying the accessKeyId and secretKeyId attributes in the provider configuration:

Example:

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:
config:
    outscale:accessKeyId:
        value: myaccesskey
    outscale:secretKeyId:
        value: mysecretkey

Environment variables

You can provide your credentials with the OUTSCALE_ACCESSKEYID and OUTSCALE_SECRETKEYID environment variables:

Example:

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:

Usage:

$ export OUTSCALE_ACCESSKEYID="myaccesskey"
$ export OUTSCALE_SECRETKEYID="mysecretkey"
$ export OUTSCALE_REGION="cloudgouv-eu-west-1"
$ export OUTSCALE_X509CERT="~/certificate/certificate.crt"
$ export OUTSCALE_X509KEY="~/certificate/certificate.key"

$ pulumi preview

Configuration

Set a profile using a configuration file

You can set a named profile by specifying the profile attribute in the provider configuration.

The location of the shared configuration and credential file can be specified using the configFile attribute:

Example:

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:
config:
    outscale:configFile:
        value: ./.osc/config.json
    outscale:profile:
        value: default

Set a profile using environment variables

You can also set a named profile by specifying the OSC_PROFILE environment variable.

The locations of the shared configuration and credential file can be specified using the OSC_CONFIG_FILE environment variable:

Configuration Reference Reference

In addition to generic provider arguments, the following arguments are supported in the OUTSCALE provider configuration:

• configFile - (Optional) The path to an OSC config file. It can also be sourced from the OSC_CONFIG_FILE environment variable.
• profile - (Optional) The named profile you want to use in the OSC config file. It can also be sourced from the OSC_PROFILE environment variable.
• accessKeyId - (Optional) The ID of the OUTSCALE access key. It must be provided, but it can also be sourced from the OUTSCALE_ACCESSKEYID environment variable.
• secretKeyId - (Optional) The OUTSCALE secret key. It must be provided, but it can also be sourced from the OUTSCALE_SECRETKEYID environment variable.
• api - (Optional) Configuration elements for OUTSCALE API operations.
  • endpoint - (Optional) The endpoint to use for OUTSCALE API operations. For more information on available endpoints, see API Endpoints Reference > OUTSCALE API.
  • region - (Optional) The Region to use for OUTSCALE API operations. It can also be sourced from the OUTSCALE_REGION environment variable. For more information on available Regions, see About Regions and Subregions.
  • x509CertPath - (Optional) The path to the x509 Client Certificate. It can also be sourced from the OUTSCALE_X509CERT environment variable. For more information on the use of those certificates, see About API Access Rules.
  • x509KeyPath - (Optional) The path to the private key of the x509 Client Certificate. It can also be sourced from the OUTSCALE_X509KEY environment variable. For more information on the use of those certificates, see About API Access Rules.
  • insecure - (Optional) Enables TLS insecure connection.
• oks - (Optional) Configuration elements for OKS API operations.
  • endpoint - (Optional) The endpoint to use for OKS API operations. For more information on available endpoints, see API Endpoints Reference > OUTSCALE Kubernetes as a Service (OKS).
  • region - (Optional) The Region to use for OKS API operations. It can also be sourced from the OUTSCALE_REGION environment variable. For more information on available Regions, see About Regions and Subregions.

The following top-level arguments are deprecated but still supported as a fallback:

• endpoints - (Optional, deprecated) The endpoints to use for OUTSCALE API and OKS API operations. For more information on available endpoints, see Regions, Endpoints and Availability Zones Reference.
  • api - (Optional, deprecated) For OUTSCALE API.
  • oks - (Optional, deprecated) For OKS API.
• region - (Optional, deprecated) The Region to use for OUTSCALE API and OKS API operations. It can also be sourced from the OUTSCALE_REGION environment variable. For more information on available Regions, see About Regions and Subregions.
• x509CertPath - (Optional, deprecated) The path to the x509 Client Certificate. It can also be sourced from the OUTSCALE_X509CERT environment variable. For more information on the use of those certificates, see About API Access Rules.
• x509KeyPath - (Optional, deprecated) The path to the private key of the x509 Client Certificate. It can also be sourced from the OUTSCALE_X509KEY environment variable. For more information on the use of those certificates, see About API Access Rules.
• insecure - (Optional, deprecated) Enables TLS insecure connection.