Skip to main content
Version: 3.14-dev

Install via Civo Marketplace

This documentation provides detailed instructions on how to install the KubeRocketCI platform via Civo Marketplace. As a prerequisite, make sure to sign up on Civo.

Launch Cluster​

The first step of the installation procedure is to launch the cluster. Please refer to the official instructions that describe this process in detail. To succeed, follow the steps below:

  1. Log in to your personal Civo account.

  2. Create a new Kubernetes cluster with the following parameters. Please refer to the official guidelines for more details:

    • Name: demo
    • How many nodes: 1
    • Select size: Type: Standard, Size: Medium
    • Network: Default
    • Firewall: Create a new firewall with the 6443 and 443 ports opened
    • Advanced options: Kubernetes version: latest (currently 1.34.0)
    • Marketplace: From the CI/CD selection choose Argo CD and Tekton for pre-installation.
  3. Wait till the cluster is created.

    note

    The process of deploying the cluster typically takes about two minutes. Following this, an extra five minutes are needed for the deployment of both the Argo CD and Tekton.

  4. As soon as cluster is deployed, ensure all the marketplace applications are installed, too:

    Check applications

  5. Download and apply the kubeconfig file:

    Download kubeconfig

  6. Ensure all the pods are up and running in both the Tekton and Argo CD namespaces after 5 minutes of waiting. Restart deployments if the pods are failed to deploy:

    kubectl get ns
    kubectl get pods -n tekton-pipelines
    kubectl get pods -n argocd

    Verify installation

Install KubeRocketCI​

As soon as the cluster is deployed, it is time to install the KubeRocketCI application.

  1. In the Civo portal, navigate to Marketplace -> CI/CD:

    Civo Marketplace

  2. Select KubeRocketCI and choose which Version Control Systems you would prefer to integrate it with and click the Install Apps button:

    Add KubeRocketCI

  3. Wait till the KubeRocketCI app appears in the Installed applications list:

    KubeRocketCI installed

  4. Wait till all the pods are up and running. Use the kubectl get pods command to check the status of the pods:

    kubectl get pods -n krci

    KubeRocketCI pods

  5. As soon as all the pods are deployed. Navigate to the Cluster Information tab and copy the DNS name:

    Getting DNS

  6. In the new browser tab, access the KubeRocketCI portal by typing the URL according to the https://krci-portal.<DNS_name> format.

    note

    You can find the exact portal URL in the krci-portal deployment details.

  7. Create the edp-admin service account and generate an access token to open the KubeRocketCI:

    kubectl -n krci create serviceaccount edp-admin
    kubectl create clusterrolebinding edp-admin --serviceaccount=krci:edp-admin --clusterrole=cluster-admin
    kubectl create token edp-admin -n krci
  8. In the login menu, paste the generated token in the Access token field and click the Sign in button.

    Portal login menu

  9. Upon logging in, open the namespaces window by clicking the Manage Namespaces button in the top right corner of the UI:

    Specify namespaces

  10. Ensure the krci namespace is specified in both default and allowed namespaces. If not, define them manually:

    • Default namespace: krci
    • Allowed namespaces: krci

    Cluster Settings menu

    note

    Remember to press Enter to add the allowed namespace to the list.

Well done! You've successfully installed the KubeRocketCI platform on the Civo cluster. You're now set to integrate KubeRocketCI with the necessary third-party tools. Proceed to the SonarQube Integration page.