Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rename stage 5-app-infra for internal consistency on pipeline layers (foundation vs infra vs application) #1287

Open
eeaton opened this issue Jul 1, 2024 · 1 comment
Assignees
Labels
backlog enhancement New feature or request v5.0

Comments

@eeaton
Copy link
Collaborator

eeaton commented Jul 1, 2024

TL;DR

Terminology and concepts are not used consistently for different pipeline layers, and it breaks down at stage 5-app-infra. This should be renamed to help clarify how the enterprise foundation blueprint has modular support for other blueprints, particularly the enterprise application blueprint.

The enterprise foundations blueprint guide that describes the reference architecture and recommendations deployed by this repo states the following about pipeline layers:

  • Stages 0-3 are considered part of the foundation pipeline
  • Stages 4-5 are considered part of the infrastructure pipeline
  • The scope of the enterprise foundation blueprint does not address an application pipeline in detail; it introduces the concept but explicitly descopes it, because many workload teams might have different pipelines for their software development lifecycle. It instead links to a separate asset, the enterprise applicaiton blueprint which covers recommendations for such pipelines in great detail.

This repo creates confusion by calling stage 5 as 5-app-infra, suggesting it is an example of an application pipeline. We can make the repo easier to use and understand by being explicit about what it covers and what it does not, we should avoid suggesting this example foundation covers application pipeline or internal developer platform capabilities.

Terraform Resources

No response

Detailed design

A spot check of some references in code to update (not necessarily exhaustive)
 - 5-app-infra (directory) --> 5-app-infra
 - app_infra_test.go --> project_infra_test.go
 - TestAppInfra  --> testProjectInfra
 - appInfra --> projectInfra
 - terraform/app-infra/business_unit_1/development --> terraform/project-infra/business_unit_1/development
 - "UPDATE_APP_INFRA_BUCKET"
 - gcp-policies-app-infra
 - AppInfraRepo

Additional information

No response

@eeaton eeaton added enhancement New feature or request backlog v5.0 labels Jul 1, 2024
Copy link

This issue is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 7 days

@github-actions github-actions bot added the Stale label Aug 30, 2024
@eeaton eeaton removed the Stale label Sep 2, 2024
@daniel-cit daniel-cit self-assigned this Sep 2, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backlog enhancement New feature or request v5.0
Projects
None yet
Development

No branches or pull requests

2 participants