github.com/redhat-appstudio/e2e-tests@v0.0.0-20230619105049-9a422b2094d7/tests/byoc/README.md (about)

     1  # BYOC test
     2  
     3  ### Prerequisites for running this test against your own cluster
     4  1. Follow the instructions from the [Readme](../../docs/Installation.md) scripts to install AppStudio in e2e mode.
     5  2. Make sure the cluster you are about to run this test against is public (i.e. hosted on a public cloud provider).
     6  3. Access to an external openshift cluster to use it as RHTAP environment.
     7  4. Have installed vcluster binary. How to install [here](https://www.vcluster.com/docs/getting-started/setup).
     8  5. Have installed helm binary. How to install [here](https://helm.sh/docs/intro/install/).
     9  
    10  #### Environments
    11  
    12  | Variable | Required | Explanation | Default Value |
    13  |---|---|---|---|
    14  | `BYOC_KUBECONFIG` | yes | A valid path to a openshift kubeconfig file. Note: Your kubeconfig should contain token instead of certificates:https://issues.redhat.com/browse/GITOPSRVCE-554  | ''  |
    15  
    16  ### Description
    17  
    18  This tests try to simulate user workflow from creating an Openshift/Kubernetes envionment in RHTAP to deploy the applications to the given environment.
    19  The tests are creating a virtual cluster in ur RHTAP cluster to test pure kubernetes environments.
    20  
    21  #### What is virtual Cluster?
    22  Virtual clusters are Kubernetes clusters that run on top of other Kubernetes clusters. Compared to fully separate "real" clusters, virtual clusters do not have their own node pools or networking.
    23  Instead, they are scheduling workloads inside the underlying cluster while having their own control plane.
    24  
    25  More information about vcluster architecture can be found at vcluster [website](https://www.vcluster.com/docs/architecture/basics)
    26  
    27  ### How to run
    28  To run the byoc tests run the following command in your  with a custom yaml use:
    29     ```bash
    30      export E2E_TEST_SUITE_LABEL=byoc &&  make local/test/e2e
    31     ```