feat(STONEINTG-698-697): udpate doc for environment usage in integration

* update for stopping provisioning ephemeral env in STONEINTG-698
* update for stopping deploying snapshot to root env in STONEINTG-697

Signed-off-by: Hongwei Liu <hongliu@redhat.com>

architecture/integration-service.md

@@ -5,21 +5,20 @@
 
 The Integration Service is composed of controllers that facilitate automated testing of content produced by the build pipelines. It is mainly responsible for integration testing capabilities.
 
-The Integration service uses the pipeline, snapshot, and environment controllers to watch for Component builds, trigger and manage testing Tekton Pipelines, and create releases based on the testing outcome(s).
+The Integration service uses the pipeline, snapshot, and component controllers to watch for Component builds, trigger and manage testing Tekton Pipelines, and create releases based on the testing outcome(s).
 
 ### Goals
 
 - The Integration service should be able to update one component image at a time in order to test and deploy individual component builds.
-- The Integration service need to be able to deploy a specific set of images to an environment and record the results of integration testing.
+- The Integration service need to be able to test the snapshot created for component image and record the results of integration testing.
 - Given a specific set of images, Integration service should be able to tell if they passed application validation tests.
 - The Integration service should have a capability to automatically promote sets of passed images.
 - To be SLSA compliant, Integration service should also be able to tell what version of the build and test pipelines were used to create each component image.
 
 ### High Level Workflow
 
 - When a build pipeline completes, Integration service creates a Snapshot CR representing a new collection of components that should be tested together.
-- When Integration Service sees a new Snapshot CR (created either by itself or by a user), it coordinates deployment of the application for testing. It does this by creating new “ephemeral” Konflux Environment CRs which trigger the GitOps Service to provision the ephemeral test environment.
-- After the environment is ready and the application snapshot has been deployed to it, Integration Service tests and validates the application according to user-provided configuration. It does this by executing Tekton PipelineRuns against the ephemeral test Environment.
+- When Integration Service sees a new Snapshot CR (created either by itself or by a user),  it tests and validates the application according to user-provided configuration. It does this by executing Tekton PipelineRuns.
 - Finally, if any automatic ReleasePlans have been created by the user in the workspace, it will create a Release CR signalling intent to release the tested content, to be carried out by the [release-service](./release-service.md).
 
 The diagram below shows the interaction of the integration service and other services.
@@ -34,7 +33,6 @@ The [Integration Service](./integration-service.md) is dependent on the followin
 - [GitOps Service](./gitops-service.md)
   - Provides the facility to create
     - Snapshots defining sets of Builds to test
-    - Environment to test the Application on
 - [Hybrid Application Service](./hybrid-application-service.md)
   - Provides the Application and Component model. Integration Service updates the pullspec reference on the Component CR when a snapshot is created for the built image.
 - [Release Service](./release-service.md)
@@ -55,8 +53,6 @@ The [Integration Service](./integration-service.md) is dependent on the followin
 
 **IntegrationTestScenario** - The custom resource that describes separate PipelineRuns that are supposed to be run by the snapshot controller. The IntegrationTestScenarios can be marked as optional, in which case they will not be taken into account when determining if the Snapshot has passed testing. Any number of IntegrationTestScenarios can be set by the user and also the user can specify the contexts where they will be applied (Component or Composite stage - or both).
 
-**Ephemeral Environment** - The ephemeral copy of an existing environment that is created by the Integration service for use during a specific Integration pipeline run.
-
 **SLSA** - [SLSA](http://slsa.dev/) is a new PSSC initiative. Current goal is to reach [SLSA](http://slsa.dev/) level 4 or above for all services.
 
 ## Outdated Terminology
@@ -81,14 +77,14 @@ Below are the list of CRs that the integration service is responsible for intera
 | Custom Resources | When? | Why? |
 |---|---|---|
 | Application & Component | Before creating the Snapshots | To know which ImageSpecs to use in the Snapshot |
-| IntegrationTestScenario | Before creating the Component/Composite PipelineRun(s) | To get the information for the PipelineRun - which Tekton bundles and Environments will be used |
+| IntegrationTestScenario | Before creating the Component/Composite PipelineRun(s) | To get the information for the PipelineRun - which Tekton bundles will be used |
 | ReleasePlan | Before creating the Release | To signal the Release Service for next environment promotion (prod) |
 
 ### UPDATE
 
 | Custom Resource | When? | Why? |
 |---|---|---|
-| Snapshot | Post Test PipelineRun | To mark the snapshot validated so that it can be promoted to the next environment |
+| Snapshot | Post Test PipelineRun | To mark the snapshot validated so that it can be released |
 | Component | Post Build PipelineRun | To update the Component with the image spec, in order to update the global candidates list |
 
 ### WATCH
@@ -99,8 +95,7 @@ Below are the list of CRs that the integration service is responsible for intera
 | PipelineRun | Post Component PipelineRun | Check the result of all Component PipelineRuns and mark the linked Snapshot as it either passed all tests or failed them |
 | PipelineRun | Post Composite PipelineRun | Check the result of all Composite PipelineRuns and mark the linked Snapshot as it either passed all tests or failed them |
 | Snapshot | Upon Snapshot creation | Check the Snapshot details and start running Integration PipelineRuns for it |
-| Snapshot | Upon Snapshot status being updated as passed all tests | Follow up on the global candidate list state to possibly create the Composite Snapshot. Otherwise check ReleasePlan and create a Release. Update SnapshotEnvironmentBindings if the Dev/Stage Environments exist |
-| SnapshotEnvironmentBinding (To be implemented) | Upon the Snapshot being deployed to the ephemeral Environment | Start the Integration PipelineRun to run tests on the Snapshot that was deployed to the ephemeral Environment |
+| Snapshot | Upon Snapshot status being updated as passed all tests | Follow up on the global candidate list state to possibly create the Composite Snapshot. Otherwise check ReleasePlan and create a Release. |
 
 ### Pipeline
 
@@ -144,16 +139,12 @@ The `test.appstudio.openshift.io/kind` annotation is an optional annotation that
 
 #### Workspace
 
-The Integration service will provide Tekton workspaces to the individual PipelineRuns to supply additional resources required for testing, such as secure credentials for accessing test Environments.
+The Integration service will provide Tekton workspaces to the individual PipelineRuns to supply additional resources required for testing.
 
 #### Persistent Volume
 
  A persistent volume that the pipeline can store test artifacts generated from the test execution.
 
-#### Secrets
-
-The Integration service needs secrets mounted so that the `Environment Provisioner` Task running in the workspace has the correct permissions to create Konflux Application Environments resources within the Applications/Component’s namespace.
-
 ## Detailed Workflow
 1. Watch for Build PipelineRuns of `type: build`
     - Extract  Component Name, Application Name, and Image from pipeline annotations
@@ -164,7 +155,7 @@ The Integration service needs secrets mounted so that the `Environment Provision
     - If a component does not have a container image associated with it then the component will not be added to the snapshot
 4. Update the Component `spec.containerImage`
 5. Create PipelineRuns for each IntegrationTestScenario
-    - Fetch the IntegrationTestScenario for the application/component to get the Tekton Bundle and Environment information
+    - Fetch the IntegrationTestScenario for the application/component to get the Tekton Bundle
     - Assign annotations of
         ```
         "test.appstudio.openshift.io/test":   component
@@ -173,7 +164,6 @@ The Integration service needs secrets mounted so that the `Environment Provision
         “test.appstudio.openshift.io/application":   “<Application name>”
         ```
     - Pass in the Snapshot json representation as a parameter
-    - Optional: Create the ephemeral Environment if the IntegrationTestScenario specifies one. After the Environment is ready, link it to the pipelineRun and start it
 6. Watch the PipelineRun of `test: component` and `component: <component name>`
     - When all required PipelineRuns complete
         - Check if all the required PipelineRuns associated with the snapshot have passed successfully