Create Power Platform Pipeline

[MarvinBangert]

User Story

As a Terraform user, I want to create Power Platform Pipeline through Terraform so that I can automate the built-in ALM user experience, when creating a multistage environment deployment.

Use case:

• Create and manage Pipeline Host
• Create and manage Pipeline
• Create and manage Pipeline Stage

We deploy DEV-TEST-PROD environments and would like to also create built-in pipelines to connect these environments and give end users the full experience to deploy their solutions.

Resource

• Resource Name: powerplatform_pipeline or powerplatform_data_record
• Service Name: Power Platform Pipelines
• Documentation Link: https://learn.microsoft.com/en-us/power-platform/alm/pipelines

Potential Terraform Configuration

# Sample Terraform config that describes how the new resource might look.

resource "powerplatform_data_record" "pipeline" {
  environment_id     = var.environment_id
  table_logical_name = "deploymentpipeline"
  columns = {
    name        = "String"
    description = "String"
    deploymenttype = "Choice" # Standard, Source Control, ADO Pipeline
    enableaideploymentnotes = true/false #Yes/No Choice Enabled, Disabled
    enableredeployment = true/false #Yes/No Choice Enabled, Disabled
  }
}

resource "powerplatform_data_record" "pipeline_stage" {
  environment_id     = var.environment_id
  table_logical_name = "deploymentstage"
  columns = {
    name        = "String"
    description = "String"
    deploymentpipelineid = id #Lookup Pipeline ID
    previousdeploymentstageid = id #Lookup Pipeline Stage
    targetdeploymentenvironmentid = id #Lookup Pipeline Stage
    isdelegateddeployment = true/false #Yes/No Choice Enabled, Disabled
    predeploymentsteprequired = true/false #Yes/No Choice Enabled, Disabled
    delegateddeploymenttype = "Choice" # Stage Owner, Service Principal
    issharingenabled = true/false #Yes/No Choice Enabled, Disabled
    preexportsteprequired = true/false #Yes/No Choice Enabled, Disabled
    spnclientid = "String" # SPN Client ID
  }
}

---OR---

resource "powerplatform_pipeline" "pipeline" {
  environment_id     = var.environment_id
  name        = "String"
  description = "String"
  deploymenttype = "Choice" # Standard, Source Control, ADO Pipeline
  enableaideploymentnotes = true/false #Yes/No Choice Enabled, Disabled
  enableredeployment = true/false #Yes/No Choice Enabled, Disabled
}

resource "powerplatform_pipeline_stage" "stage" {
  environment_id     = var.environment_id
  name        = "String"
  description = "String"
  deploymentpipelineid = id #Lookup Pipeline ID
  previousdeploymentstageid = id #Lookup Pipeline Stage
  targetdeploymentenvironmentid = id #Lookup Pipeline Stage
  isdelegateddeployment = true/false #Yes/No Choice Enabled, Disabled
  predeploymentsteprequired = true/false #Yes/No Choice Enabled, Disabled
  delegateddeploymenttype = "Choice" # Stage Owner, Service Principal
  issharingenabled = true/false #Yes/No Choice Enabled, Disabled
  preexportsteprequired = true/false #Yes/No Choice Enabled, Disabled
  spnclientid = "String" # SPN Client ID
}

Additional Validation Rules

API documentation

Action	Verb	URL	Status Codes	Comments
Create	POST	/api/v1/resources	201
Read	GET	/api/v1/resources/{id}	200
Update	PUT	/api/v1/resources/{id}	200
Delete	DELETE	/api/v1/resources/{id}	204

JSON

{}

Definition of Done

• Data Transfer Objects (dtos) in dto.go
• Resource Model in model.go
• API Client functions in api_{name}.go
• Resource Implementation in resource_{name}.go
• Unit Tests in resource_{name}_test.go for Happy Path, Error conditions, boundry cases
• Acceptance Tests in resource_{name}_test.go for Happy Path
• Resource Added to provider.go and provider_test.go
• Example in the /examples folder
• Schema documented using MarkdownDescription
• Change log entry changie new -k added
• Run make precommit before PR

See the contributing guide for more information about what's expected for contributions.

[mawasile]

Looks interesting, I will take a look what is possible. We are still limited by current internal API's authentication modes, but it getting extended as we speak.
I will take a look if we can support this feature.

[mawasile]

@MarvinBangert if everything you need can be done using powerplatform_data_record , by design we don't create a dedicated resource terraform resource for it.
I would propose to create a module for setting up pipelines under data record resource example:
https://github.com/microsoft/terraform-provider-power-platform/tree/main/examples/resources/powerplatform_data_record

[MarvinBangert]

@mawasile I am not sure if it could be done using data_record; I guess it could, but I didn't tested it yet. Will work on this and propose an example