terraform-provider-circleci

README

terraform-provider-circleci

Forked from gitter-badger/terraform-provider-circleci, which was a fork of thiagoalessio/terraform-provider-circleci, that no longer exists.

Terraform provider for CircleCI.

Table of contents

• Provider
• Data Sources
• Resources
  • circleci_project
• Where to get help
• License

Provider

The CircleCI provider is used to interact with CircleCI resources.

The provider allows you to manage your CircleCI projects and their environment variables easily. It needs to be configured with the proper credentials before it can be used.

Example Usage

provider "circleci" {
  token        = "${var.circleci_token}"
  organization = "${var.circleci_organization}"
}

Argument Reference

The following arguments are supported in the provider block:

• token - (Optional) This is the CircleCI API token. It must be provided, but it can also be sourced from the CIRCLE_TOKEN environment variable.

• organization - (Optional) This is the organization/account to be managed. It must be provided, but it can also be sourced from the CIRCLE_PROJECT_USERNAME environment variable.

Data Sources

@TODO

Resources

circleci_project

Provides a CircleCI project resource.

This resource allows you to start/stop building projects from your organization. When applied, a project is enabled. When destroyed, that project will be disabled.

Example Usage

resource "circleci_project" "myproj" {
  name = "myproj"

  env_vars {
    SOME_TOKEN = "a1b2c3d4e5f6g7h8i9j0"
  }
}

Argument Reference

The following arguments are supported:

• name - (Required) The name of the project/repository.

• env_vars - (Optional) A mapping of environment variables to assign to the resource.

Import

CircleCI projects can be imported using the name, e.g.

$ terraform import circleci_project.myproj myproj

Where to get help

Join the chat on Gitter.

License

terraform-provider-circleci is released under the Mozilla Public License 2.0.

_{Made with in Berlin}