Octopus.TerraformApply exported 2023-10-24 by mcasperson belongs to ‘Octopus’ category.
This step exposes the fields required to create the initial blank space serialized with octoterra using Terraform. The new space is then populated using the Octopus - Populate Octoterra Space (S3 Backend)
step.
This step configures a Terraform S3 backend.
It is recommended that this step be run with the octopuslabs/terraform-workertools
worker image.
Parameters
When steps based on the template are included in a project’s deployment process, the parameters below can be set.
Octopus Space Name
OctoterraApply.Octopus.Space.NewName = #{Octopus.Deployment.Tenant.Name}
The name of the new space to create. The default value assumes that the step is run against a tenant, and the tenant name matches the space.
Octopus Space Managers
OctoterraApply.Octopus.Space.Managers = teams-administrators
The name of a team to assign as the space manager.
Terraform Workspace
OctoterraApply.Terraform.Workspace.Name = #{OctoterraApply.Octopus.Space.NewName | Replace "[^A-Za-z0-9]" "_"}
The name of the Terraform workspace. This must be unique for every project this module is deployed to. The default value is based on the space ID that the module is applied to: #{OctoterraApply.Octopus.SpaceID}
. Leave this as the default value unless you have a specific reason to change it.
Terraform Module Package
OctoterraApply.Terraform.Package.Id =
The package created by octoterra. It must include the space_creation
and space_population
directories.
Octopus Server URL
OctoterraApply.Octopus.ServerUrl = #{Octopus.Web.ServerUri}
The Octopus server URL.
Octopus API key
OctoterraApply.Octopus.ApiKey =
The Octopus API key. See the documentation for details on creating an API key.
AWS Account Variable
OctoterraApply.AWS.Account =
The AWS account variable.
AWS S3 Bucket Name
OctoterraApply.AWS.S3.BucketName =
The name of the S3 bucket used to hold the Terraform state. See the Terraform documentation for details on using S3 as a backend.
AWS S3 Bucket Region
OctoterraApply.AWS.S3.BucketRegion =
The AWS region hosting the S3 bucket. See the Terraform documentation for details on using S3 as a backend.
AWS S3 Bucket Key
OctoterraApply.AWS.S3.BucketKey = Space_#{OctoterraApply.Octopus.Space.NewName | Replace "[^A-Za-z0-9]" "_"}
The S3 file used to hold the Terraform state. See the Terraform documentation for details on using S3 as a backend. The combination of the workspace name and this key must be unique.
The default value is the name of the project and a prefix to indicate the type of resource: Project_#{Octopus.Project.Name | Replace "[^A-Za-z0-9]" "_"}
.
Terraform Additional Apply Params
OctoterraApply.Terraform.AdditionalApplyParams =
This field can be used to define additional parameters passed to the terraform apply
command. This field can be left blank. See the Terraform documentation for details on the apply
command.
Terraform Additional Init Params
OctoterraApply.Terraform.AdditionalInitParams =
This field can be used to define additional parameters passed to the terraform init
command. This field can be left blank. See the Terraform documentation for details on the init
command.
Script body
Steps based on this template will execute the following undefined script.
undefined
Provided under the Apache License version 2.0.
To use this template in Octopus Deploy, copy the JSON below and paste it into the Library → Step templates → Import dialog.
{
"Id": "90a8dd76-6456-49f9-9c03-baf85442aa57",
"Name": "Octopus - Create Octoterra Space (S3 Backend)",
"Description": "This step exposes the fields required to create the initial blank space serialized with [octoterra](https://github.com/OctopusSolutionsEngineering/OctopusTerraformExport) using Terraform. The new space is then populated using the `Octopus - Populate Octoterra Space (S3 Backend)` step.\n\nThis step configures a Terraform S3 backend.\n\nIt is recommended that this step be run with the `octopuslabs/terraform-workertools` worker image.",
"Version": 2,
"ExportedAt": "2023-10-24T03:21:15.975Z",
"ActionType": "Octopus.TerraformApply",
"Author": "mcasperson",
"Packages": [
{
"Id": "093b1515-15a9-4446-8dc2-6297018a77e7",
"Name": "",
"PackageId": null,
"FeedId": null,
"AcquisitionLocation": "Server",
"Properties": {
"SelectionMode": "deferred",
"PackageParameterName": "OctoterraApply.Terraform.Package.Id"
}
}
],
"Parameters": [
{
"Id": "737a32e1-802f-4e15-a67d-cd271aef2c27",
"Name": "OctoterraApply.Octopus.Space.NewName",
"Label": "Octopus Space Name",
"HelpText": "The name of the new space to create. The default value assumes that the step is run against a tenant, and the tenant name matches the space.",
"DefaultValue": "#{Octopus.Deployment.Tenant.Name}",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "229cc8d4-5200-4f4e-b1c4-8d6464e246a0",
"Name": "OctoterraApply.Octopus.Space.Managers",
"Label": "Octopus Space Managers",
"HelpText": "The name of a team to assign as the space manager.",
"DefaultValue": "teams-administrators",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "4d9ad5a5-7058-4f2c-8212-b55f0c7533fd",
"Name": "OctoterraApply.Terraform.Workspace.Name",
"Label": "Terraform Workspace",
"HelpText": "The name of the Terraform workspace. This must be unique for every project this module is deployed to. The default value is based on the space ID that the module is applied to: `#{OctoterraApply.Octopus.SpaceID}`. Leave this as the default value unless you have a specific reason to change it.",
"DefaultValue": "#{OctoterraApply.Octopus.Space.NewName | Replace \"[^A-Za-z0-9]\" \"_\"}",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "1e6fc5c3-ab5d-42ec-83e1-0ac7a4b01d31",
"Name": "OctoterraApply.Terraform.Package.Id",
"Label": "Terraform Module Package",
"HelpText": "The package created by [octoterra](https://github.com/OctopusSolutionsEngineering/OctopusTerraformExport). It must include the `space_creation` and `space_population` directories.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "Package"
}
},
{
"Id": "0239982b-f0d6-49ff-a59f-5fa5045f25d5",
"Name": "OctoterraApply.Octopus.ServerUrl",
"Label": "Octopus Server URL",
"HelpText": "The Octopus server URL.",
"DefaultValue": "#{Octopus.Web.ServerUri}",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "61758b61-5fbf-418c-8bce-a153c0403bb4",
"Name": "OctoterraApply.Octopus.ApiKey",
"Label": "Octopus API key",
"HelpText": "The Octopus API key. See the [documentation](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) for details on creating an API key.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "Sensitive"
}
},
{
"Id": "b9312b36-328a-497d-9af8-ab7007e5315a",
"Name": "OctoterraApply.AWS.Account",
"Label": "AWS Account Variable",
"HelpText": "The AWS account variable.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "AmazonWebServicesAccount"
}
},
{
"Id": "124b8e4c-abf5-4ebd-ab0e-4eeea76a8bff",
"Name": "OctoterraApply.AWS.S3.BucketName",
"Label": "AWS S3 Bucket Name",
"HelpText": "The name of the S3 bucket used to hold the Terraform state. See the [Terraform documentation](https://developer.hashicorp.com/terraform/language/settings/backends/s3) for details on using S3 as a backend.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "04739ba2-45da-4ac7-aad8-b04cff4df015",
"Name": "OctoterraApply.AWS.S3.BucketRegion",
"Label": "AWS S3 Bucket Region",
"HelpText": "The AWS region hosting the S3 bucket. See the [Terraform documentation](https://developer.hashicorp.com/terraform/language/settings/backends/s3) for details on using S3 as a backend.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "88e07b45-c2d0-4e73-abb9-294143669ba6",
"Name": "OctoterraApply.AWS.S3.BucketKey",
"Label": "AWS S3 Bucket Key",
"HelpText": "The S3 file used to hold the Terraform state. See the [Terraform documentation](https://developer.hashicorp.com/terraform/language/settings/backends/s3) for details on using S3 as a backend. The combination of the workspace name and this key must be unique. \n\nThe default value is the name of the project and a prefix to indicate the type of resource: `Project_#{Octopus.Project.Name | Replace \"[^A-Za-z0-9]\" \"_\"}`.",
"DefaultValue": "Space_#{OctoterraApply.Octopus.Space.NewName | Replace \"[^A-Za-z0-9]\" \"_\"}",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "e5628bba-7022-403e-9165-893da6d682ab",
"Name": "OctoterraApply.Terraform.AdditionalApplyParams",
"Label": "Terraform Additional Apply Params",
"HelpText": "This field can be used to define additional parameters passed to the `terraform apply` command. This field can be left blank. See the [Terraform documentation](https://developer.hashicorp.com/terraform/cli/commands/apply) for details on the `apply` command.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
},
{
"Id": "5600a0cb-cf66-43aa-bf76-6add3e5d52a2",
"Name": "OctoterraApply.Terraform.AdditionalInitParams",
"Label": "Terraform Additional Init Params",
"HelpText": "This field can be used to define additional parameters passed to the `terraform init` command. This field can be left blank. See the [Terraform documentation](https://developer.hashicorp.com/terraform/cli/commands/init) for details on the `init` command.",
"DefaultValue": "",
"DisplaySettings": {
"Octopus.ControlType": "SingleLineText"
}
}
],
"Properties": {
"Octopus.Action.GoogleCloud.UseVMServiceAccount": "False",
"Octopus.Action.GoogleCloud.ImpersonateServiceAccount": "False",
"Octopus.Action.Terraform.GoogleCloudAccount": "False",
"Octopus.Action.Terraform.AzureAccount": "False",
"Octopus.Action.Terraform.ManagedAccount": "AWS",
"Octopus.Action.Terraform.AllowPluginDownloads": "True",
"Octopus.Action.Script.ScriptSource": "Package",
"Octopus.Action.Terraform.RunAutomaticFileSubstitution": "False",
"Octopus.Action.Terraform.PlanJsonOutput": "False",
"Octopus.Action.Terraform.Workspace": "#{OctoterraApply.Terraform.Workspace.Name}",
"Octopus.Action.Terraform.AdditionalInitParams": "-backend-config=\"bucket=#{OctoterraApply.AWS.S3.BucketName}\" -backend-config=\"region=#{OctoterraApply.AWS.S3.BucketRegion}\" -backend-config=\"key=#{OctoterraApply.AWS.S3.BucketKey}\" #{if OctoterraApply.Terraform.AdditionalInitParams}#{OctoterraApply.Terraform.AdditionalInitParams}#{/if}",
"Octopus.Action.Terraform.AdditionalActionParams": "-var=octopus_server=#{OctoterraApply.Octopus.ServerUrl} -var=octopus_apikey=#{OctoterraApply.Octopus.ApiKey} \"-var=octopus_space_name=#{OctoterraApply.Octopus.Space.NewName}\" -var=octopus_space_managers=#{OctoterraApply.Octopus.Space.Managers} #{if OctoterraApply.Terraform.AdditionalApplyParams}#{OctoterraApply.Terraform.AdditionalApplyParams}#{/if}",
"Octopus.Action.Package.DownloadOnTentacle": "False",
"Octopus.Action.RunOnServer": "true",
"Octopus.Action.AwsAccount.UseInstanceRole": "False",
"Octopus.Action.AwsAccount.Variable": "OctoterraApply.AWS.Account",
"Octopus.Action.Aws.AssumeRole": "False",
"Octopus.Action.Aws.Region": "#{OctoterraApply.AWS.S3.BucketRegion}",
"Octopus.Action.Terraform.TemplateDirectory": "space_creation"
},
"Category": "Octopus",
"HistoryUrl": "https://github.com/OctopusDeploy/Library/commits/master/step-templates//opt/buildagent/work/75443764cd38076d/step-templates/octopus-create-octoterra-space-s3.json",
"Website": "/step-templates/90a8dd76-6456-49f9-9c03-baf85442aa57",
"Logo": "iVBORw0KGgoAAAANSUhEUgAAAMgAAADICAMAAACahl6sAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAC1QTFRFT6Tl////L5Pg8vj9Y67omsvwPJrisdfzfbzs5fL7y+T32Ov5isLucLXqvt31CJPHWwAABMJJREFUeNrs3deW4jAMAFDF3U75/89dlp0ZhiU4blJEjvQ8hYubLJsA00UCBCIQgQhEIAIRiEAEIhCBCEQgAhGIQAQiEIEIhD8kJm+t+QprfdKfB9HbYpx6CWfspj8HMi+gMgHL/AmQA8W3JTKH+ALFvzCeL0RbpyoCPE9IJeNOSQwh5Z3qd6yRGWQ2qi2cZQWxqj1WzQYSjeoJmJlAklOd4VlArOqPhQEkqBERToeMcfRJBkC0Uep8CfBpjz4JsHJ0zF3dkEWNje0kiB/sUC6eApndaIiCMyAa1PiwJ0AWhRGJHJJQHG2dC7h1rNbO1QOxSA7lNCkkKrQIpJCAB1GREILYIC1NAiwbpKFJgGWDNExcwGstfExcZBCHC6nOglshHtmhViLIig1RNBCN7qjtW8C0Z1UvJcC1Z9XmwMBzzvobmgAyEzgq91dtEEsBsQSQQAFZCSBAATEEEApHZbrVBIkkEIUPSVeB+KtALA0kXQUSrwKZBCIQBnk8Y4i5CsReBeKvkqLM+BCSDWJlrZFvGk9SRTHshkgjZCGAaArIxm3H3grhVzFlW2msfl1ca79UJ1bofYvsDHHlNdTZnlh5MghuPd5NdBDUNZHyCkfktIh03XzALGRPlBDPac7qgWjHZzWcmF5zmmkhidMQ6boKiDXcDTUEaylZqCGJ0Vjvu/fLJtHqhSANEvqb2OYqkOUqEHuVMbJcZdZCGiPhKhC4yjqiIjEE7XThMp8fAWII3mY3kUIQD+AMKQTzPiBhgQ63HlT/KSvgtoi0dq5mCPah1UIE0eh3sT0NhOByvKeAkFzi8PgQomumFhsyOxpIzZN4gLOj5plVwNpR0b2AuePWKBEHQu24pSsJA+LVCeHHQxZ1SiyDIdqok8IOhSSnTottHEQTdyt4ettAj4KkzA4dMikk2Dht2S5ptm1vswnPDxn0YyDZ5oDM3iToo2T5voWaYe+Q+vdjH80QyAzZhCgcDtLMI1Tmtz9w++XHgziHQHJJu/OZ3bs9Xn8gQ72NcP3dKqEfkp10F51xhoIi2I91R+LurXV/5q7pH+wx061CzO16oSQleMyr8fXvwMA0Pro8432DPD/ySx8XrHfSuDAM8n6UhnjQabaiXf5Bq/lREHvEeNtn1rJ08+C/uXkQZHeguxAPC3UvtcJYUogLzZX5hhZZvS6onG5lxXtzWGaygwb79vT/IXhdlNibwlKYOR6T8xjI7W8n+xV7T+GH4tMzWwR+lZhRkJYSsC0thpmCYqyngOz3rN2FLBZ2wZflBCggUHF0Vnp88JKienzIXLSEZCZqU7IKr/gQW9yx3pzV7Y9kvWZWTRRIqDmTtRUnU7b2lLcTYmoqHqnmiO1poER0SPkAeZMAZxaJx0Y3TCdAclsIqDz03ALcyxfTCZBsthoGXWmigGyVhWPLFJJfuuKQWycoEFdXbH4dJJoJxNR1eD/kshz6yn48cF8yW8sFoitflB1w6Q8n+/15Za7oA17/pYNmYgP5fmWm8L1NOHPWgK8kuFew1/JXtOA0yJCv7ah7X8ObUuT5kObU30+fDZm8+zqP+HTIpK0xQ796b5Kv2hSIQAQiEIEIRCACEYhABCIQgQhEIAIRiEAEIpBf8UeAAQAEjtYmlDTcCgAAAABJRU5ErkJggg==",
"$Meta": {
"Type": "ActionTemplate"
}
}
Page updated on Tuesday, October 24, 2023