--- name: codeengine-terraform-ce title: Setting up Terraform for Code Engine description: Terraform on IBM Cloud® enables predictable and consistent creation of IBM Cloud services so that you can rapidly build complex, multitiered cloud environments following Infrastructure as Code (IaC) principles. Similar to using the IBM Cloud CLI or API and SDKs, you can automate the creation, update, and deletion of your Code Engine workloads by using HashiCorp Configuration Language (HCL). last-updated: 2026-01-27 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/codeengine?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. # Setting up Terraform for Code Engine {: #terraform-setup-ce} Terraform on IBM Cloud® enables predictable and consistent creation of IBM Cloud services so that you can rapidly build complex, multitiered cloud environments following Infrastructure as Code (IaC) principles. Similar to using the IBM Cloud CLI or API and SDKs, you can automate the creation, update, and deletion of your Code Engine workloads by using HashiCorp Configuration Language (HCL). {: shortdesc} Looking for a managed Terraform on IBM Cloud® solution? Try out [IBM Cloud® Schematics](https://cloud.ibm.com/docs/schematics?topic=schematics-getting-started&format=markdown). With Schematics, you can use the Terraform scripting language that you are familiar with, but you don't have to worry about setting up and maintaining the Terraform command line and the IBM Cloud® Provider plug-in. Schematics also provides pre-defined Terraform templates that you can easily install from the IBM Cloud® catalog. {: tip} ## Installing Terraform and configuring resources for Code Engine {: #install-terraform} Before you can create workloads with Terraform, make sure that you have completed the following prerequisites. - Make sure that you have the [required access](https://cloud.ibm.com/docs/codeengine?topic=codeengine-iam&format=markdown) to create and work with Code Engine resources. - Install the Terraform CLI and configure the IBM Cloud Provider plug-in for Terraform. For more information, see the tutorial for [Getting started with Terraform on IBM Cloud®](https://cloud.ibm.com/docs/ibm-cloud-provider-for-terraform?topic=ibm-cloud-provider-for-terraform-getting-started&format=markdown). The plug-in abstracts the IBM Cloud APIs that are used to complete this task. - Create a Terraform configuration file that is named `main.tf`. In this file, you define resources by using HashiCorp Configuration Language. For more information, see the [Terraform documentation](https://developer.hashicorp.com/terraform/language){: external}. 1. Create a Code Engine project by using the `code_engine_project` resource argument in your `main.tf` file. ```terraform data "ibm_resource_group" "resource_group" { name = "" } resource "ibm_code_engine_project" "code_engine_project_instance" { name = "" resource_group_id = data.ibm_resource_group.resource_group.id } ``` {: codeblock} 2. After you finish building your configuration file, initialize the Terraform CLI. For more information, see [Initializing Working Directories](https://developer.hashicorp.com/terraform/cli/init){: external}. ```terraform terraform init ``` {: pre} 3. Provision the project from the `main.tf` file. For more information, see [Provisioning Infrastructure with Terraform](https://developer.hashicorp.com/terraform/cli/run){: external}. 1. Run `terraform plan` to generate a Terraform execution plan to preview the proposed actions. ```terraform terraform plan ``` {: pre} ```terraform data.ibm_resource_group.resource_group: Reading... data.ibm_resource_group.resource_group: Read complete after 1s [id=] Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols: + create Terraform will perform the following actions: # ibm_code_engine_project.code_engine_project_instance will be created + resource "ibm_code_engine_project" "code_engine_project_instance" { + account_id = (known after apply) + created_at = (known after apply) + crn = (known after apply) + href = (known after apply) + id = (known after apply) + name = "" + project_id = (known after apply) + region = (known after apply) + resource_group_id = "" + resource_type = (known after apply) + status = (known after apply) } Plan: 1 to add, 0 to change, 0 to destroy. ``` {: screen} 1. Run `terraform apply` to create the resources that are defined in the plan. ```terraform terraform apply ``` {: pre} ```terraform data.ibm_resource_group.resource_group: Reading... data.ibm_resource_group.resource_group: Read complete after 1s [id=] Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols: + create Terraform will perform the following actions: # ibm_code_engine_project.code_engine_project_instance will be created + resource "ibm_code_engine_project" "code_engine_project_instance" { + account_id = (known after apply) + created_at = (known after apply) + crn = (known after apply) + href = (known after apply) + id = (known after apply) + name = "my-project" + project_id = (known after apply) + region = (known after apply) + resource_group_id = "5218b5c8c749454b9fc8be28f32e458e" + resource_type = (known after apply) + status = (known after apply) } Plan: 1 to add, 0 to change, 0 to destroy. Changes to Outputs: + ibm_code_engine_project = { + account_id = (known after apply) + created_at = (known after apply) + crn = (known after apply) + href = (known after apply) + id = (known after apply) + name = "my-project" + project_id = (known after apply) + region = (known after apply) + resource_group_id = "5218b5c8c749454b9fc8be28f32e458e" + resource_type = (known after apply) + status = (known after apply) + timeouts = null } Do you want to perform these actions? Terraform will perform the actions described above. Only 'yes' will be accepted to approve. Enter a value: yes ibm_code_engine_project.code_engine_project_instance: Creating... ibm_code_engine_project.code_engine_project_instance: Still creating... [10s elapsed] ibm_code_engine_project.code_engine_project_instance: Still creating... [20s elapsed] ibm_code_engine_project.code_engine_project_instance: Still creating... [30s elapsed] ibm_code_engine_project.code_engine_project_instance: Creation complete after 30s [id=13468527-84sa-619g-gr99-168fe364w98f] Apply complete! Resources: 1 added, 0 changed, 0 destroyed. Outputs: ibm_code_engine_project = { "account_id" = "" "created_at" = "2023-03-16T10:44:24.150838188Z" "crn" = "crn:v1:bluemix:public:codeengine:eu-de:a/dc5e6392e5d14021846031b83e95f190:13468527-84sa-619g-gr99-168fe364w98f::" "href" = "https://api.eu-de.codeengine.cloud.ibm.com/v2/projects/13468527-84sa-619g-gr99-168fe364w98f" "id" = "13468527-84sa-619g-gr99-168fe364w98f" "name" = "my-project" "project_id" = "" "region" = "eu-de" "resource_group_id" = "" "resource_type" = "project_v2" "status" = "active" "timeouts" = null /* object */ } ``` {: screen} 6. You can see your project in the list of projects in the [Code Engine console](https://cloud.ibm.com/codeengine/overview){: external}. Alternatively you can see your project in the [IBM Cloud resource list](https://cloud.ibm.com/resources){: external}, by expanding the category `Containers` and looking for your project name. ## What's next? {: #terraform-setup-next} Now that you successfully created your first Code Engine project with Terraform on IBM Cloud, you can create additional resources. ### Resources {: #terraform-supported-resources} * [`ibm_code_engine_allowed_outbound_destination`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_allowed_outbound_destination){: external} * [`ibm_code_engine_app`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_app){: external} * [`ibm_code_engine_binding`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_binding){: external} * [`ibm_code_engine_build`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_build){: external} * [`ibm_code_engine_config_map`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_config_map){: external} * [`ibm_code_engine_domain_mapping`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_domain_mapping){: external} * [`ibm_code_engine_function`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_function){: external} * [`ibm_code_engine_job`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_job){: external} * [`ibm_code_engine_project`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_project){: external} * [`ibm_code_engine_secret`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/code_engine_secret){: external} ### Data Sources {: #terraform-supported-data-sources} * [`ibm_code_engine_allowed_outbound_destination`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_allowed_outbound_destination){: external} * [`ibm_code_engine_app`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_app){: external} * [`ibm_code_engine_binding`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_binding){: external} * [`ibm_code_engine_build`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_build){: external} * [`ibm_code_engine_config_map`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_config_map){: external} * [`ibm_code_engine_domain_mapping`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_domain_mapping){: external} * [`ibm_code_engine_function`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_function){: external} * [`ibm_code_engine_job`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_job){: external} * [`ibm_code_engine_project`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_project){: external} * [`ibm_code_engine_secret`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/code_engine_secret){: external} For more information about IBM Cloud and Terraform, see [IBM Cloud Provider](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs){: external}.