Skip to main content

Local Podman

info

This method is supported by R2DevOps community.

Only for testing purposes on your local computer

This page describes how to quickly setup a self-managed instance of R2Devops for testing purposes using podman on your local computer. This is not suitable for production

See production ready methods on Home page

Data Confidentiality

During the analysis, no data leaves your environment, ensuring the confidentiality and security of your information.

💻 Requirements​

  • Git
  • podman
  • Docker hub registry must be resolved by podman in file /etc/containers/registries.conf
/etc/containers/registries.conf
unqualified-search-registries = ["docker.io"]

🦊 GitLab Application​

  1. On your GitLab instance, open the Applications page: Your picture > Preferences > Applications (example: gitlab.com)
  2. Create an application with the following information :
    • Name: R2Devops self-managed
    • Redirect URI : http://localhost:3001/api/auth/gitlab/callback
    • Confidential: true (let the box checked)
    • Scopes: api
  3. Click on Save Application and you should see the following screen: Application
  4. Keep this GitLab tab open, the Application ID and Secret will be used in the configuration step

📥 Setup your environment​

  1. Clone the repository locally 
    git clone https://github.com/r2devops/self-managed.git r2devops
    cd r2devops
  2. Create your configuration files 
    cp .env.local.example .env
    cp .docker/r2devops/config.local.json.example .docker/r2devops/config.json

📚 Update the configuration​

  1. Edit the .env file: copy/paste the Application ID and the Secret from the application you just created

    .env
    GITLAB_OAUTH2_CLIENT_ID="<application-id>"
    GITLAB_OAUTH2_CLIENT_SECRET="<application-secret>"

  2. Only if you use a SaaS version of GitLab (like gitlab.com): edit the .env file to add the name of your top-level group in ORGANIZATION variable (else, let it empty):

    .env
    ORGANIZATION="<top-level-group-name>"

  3. Replace <your-gitlab-url> by domain of your GitLab server in the following command and run it:

    export GITLAB_INSTANCE_URL="https://<your-gitlab-url>"

  4. Run the following commands to update configuration:

    sed -i "s|GITLAB_INSTANCE_URL|${GITLAB_INSTANCE_URL}|g" .env
    sed -i "s|GITLAB_INSTANCE_URL|${GITLAB_INSTANCE_URL}|g" .docker/r2devops/config.json

  5. Run the following commands to generate random secrets for all components:

    sed -i "s/REPLACE_ME_BY_SECRET_KEY/$(openssl rand -hex 32)/g" .env
    sed -i "s/REPLACE_ME_BY_JOBS_DB_PASSWORD/$(openssl rand -hex 16)/g" .env
    sed -i "s/REPLACE_ME_BY_JOBS_REDIS_PASSWORD/$(openssl rand -hex 16)/g" .env
    sed -i "s/REPLACE_ME_BY_S3_SECRET_KEY/$(openssl rand -hex 16)/g" .env

🔐 (Optional) Add your license​

License key

If you do not have a license key, you can let the variable LICENSE empty (value: ""). Your R2Devops instance will be limited to 5 projects.

Add your license key (provided by R2Devops): edit the .env file by updating value of LICENSE variable:

.env
LICENSE="<license-key>"

📄 Prepare podman for launch​

Generate podman network:

podman network create intranet

Generate podman socket

systemctl --user start podman.socket
systemctl --user enable podman.socket

Generate podman config files:

set -a; source .env; set +a
export uid=$(id -u)
envsubst < podman.local.yml.example > podman.yml
envsubst < configmap.local.yml.example > configmap.yml

🚀 Launch R2Devops!​

  1. Start R2Devops 
    podman play kube podman.yml --configmap configmap.yml --network intranet
  2. Open your R2Devops test instance 👉 click here 🎉

⏫ Update R2Devops​

Follow these steps to update your self-managed instance to a new version:

  1. Navigate to the location of your self-managed git repository
  2. Update it 
    git pull
  3. Open the .env.local.example file and copy the values of FRONTEND_IMAGE_TAG and BACKEND_IMAGE_TAG variables
  4. Edit the .env file by updating values of FRONTEND_IMAGE_TAG and BACKEND_IMAGE_TAG variables with the values previously copied
    .env
    FRONTEND_IMAGE_TAG="<new frontend version>"
    BACKEND_IMAGE_TAG="<new backend version>"
  5. Update local yaml files 
    set -a; source .env; set +a
    export uid=$(id -u)
    envsubst < podman.local.yml.example > podman.yml
    envsubst < configmap.local.yml.example > configmap.yml
  6. Restart your containers 
    podman play kube podman.yml --replace --configmap configmap.yml --network intranet
  7. You have successfully updated R2Devops on your server 🎉