{"id":23651869,"url":"https://github.com/microfocus/lrc-gh-action","last_synced_at":"2026-05-02T01:35:00.666Z","repository":{"id":38258249,"uuid":"464772016","full_name":"MicroFocus/lrc-gh-action","owner":"MicroFocus","description":"GitHub Action for LoadRunner Cloud","archived":false,"fork":false,"pushed_at":"2024-05-20T19:21:42.000Z","size":3326,"stargazers_count":2,"open_issues_count":5,"forks_count":0,"subscribers_count":7,"default_branch":"dev","last_synced_at":"2024-12-28T16:48:39.979Z","etag":null,"topics":["actions","github-actions","load-testing","loadrunner-cloud","lrc","performance-tetsing"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MicroFocus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-03-01T06:30:56.000Z","updated_at":"2023-11-15T13:24:29.000Z","dependencies_parsed_at":"2023-11-20T05:22:16.051Z","dependency_job_id":"37715703-c4b7-499b-9717-bf5fb50c1dfe","html_url":"https://github.com/MicroFocus/lrc-gh-action","commit_stats":{"total_commits":82,"total_committers":4,"mean_commits":20.5,"dds":0.5853658536585367,"last_synced_commit":"79271e176d0c9dae1dbefb21b099ffad498b1726"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicroFocus%2Flrc-gh-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicroFocus%2Flrc-gh-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicroFocus%2Flrc-gh-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicroFocus%2Flrc-gh-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MicroFocus","download_url":"https://codeload.github.com/MicroFocus/lrc-gh-action/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239611992,"owners_count":19668274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","github-actions","load-testing","loadrunner-cloud","lrc","performance-tetsing"],"created_at":"2024-12-28T16:48:46.414Z","updated_at":"2025-11-16T19:30:15.737Z","avatar_url":"https://github.com/MicroFocus.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CodeQL](https://github.com/MicroFocus/lrc-gh-action/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/MicroFocus/lrc-gh-action/actions/workflows/github-code-scanning/codeql)\n[![Release](https://github.com/MicroFocus/lrc-gh-action/actions/workflows/release.yml/badge.svg)](https://github.com/MicroFocus/lrc-gh-action/actions/workflows/release.yml)\n\n# GitHub Action for LoadRunner Cloud\n\nUse this action to run a load test in [LoadRunner Cloud](https://admhelp.microfocus.com/lrc/en/Latest/Content/Storm/c_Getting_started.htm) and collect reports.  \nThe action can be used on both [self-hosted](https://docs.github.com/en/actions/hosting-your-own-runners) and [GitHub-hosted](https://docs.github.com/en/actions/using-github-hosted-runners) runners.\n\nFor security practices about using GitHub Actions, refer to GitHub's [Security hardening for GitHub Actions](https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions).  \nIf you use self-hosted runners, refer to the [Hardening for self-hosted runners](https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions#hardening-for-self-hosted-runners).\n\n## Prerequisites\n\n1. Get your client id and secret key in LoadRunner Cloud. Refer to [API access keys](https://admhelp.microfocus.com/lrc/en/Latest/Content/Storm/Admin-APIAccess.htm)\n2. Store the client id and secret key in GitHub [Secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository).   \n   For example: `LRC_CLIENT_ID` and `LRC_CLIENT_SECRET`. These two secret names are used in following examples.\n3. Prepare a load test in LoadRunner Cloud.\n\n## Action Inputs\n\n| Input                | Description                                                                                                                                                      |\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **lrc_server**       | LRC URL, default: https://loadrunner-cloud.saas.microfocus.com                                                                                                   |\n| **lrc_tenant**       | Tenant ID, for example: 652261341                                                                                                                                |\n| **lrc_project**      | Project ID, default: 1                                                                                                                                           |\n| **lrc_test_id**      | Test ID                                                                                                                                                          |\n| **lrc_output_dir**   | The directory in which to save results. \u003cbr/\u003eThe path can be used in the \"Upload artifacts\" step.                                                                |\n| **lrc_report_types** | Target report types. For example: `pdf, docx, csv`.  \u003cbr/\u003eThere are 3 supported report types: pdf, docx, csv. Leave this field empty if you do not need reports. \u003cbr/\u003e\u003cbr/\u003e Note: when test run is completed, a JUnit xml file will be generated in the results directory. |\n\n## Action Outputs\n\n| Output                                                                | Description                                |\n|-----------------------------------------------------------------------|--------------------------------------------|\n| **lrc_run_id** \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; | The ID of test run started by this action. |\n\n## Examples\n\n### Trigger a load test at a scheduled time via GitHub [schedule events](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule)\n\n```yml\non:\n  schedule:\n    # run at 05:00 on every Friday\n    - cron: '0 5 * * 5'\njobs:\n  load_test:\n    runs-on: self-hosted\n    name: Start a load test\n    steps:\n      - name: Run test in LoadRunner Cloud\n        uses: MicroFocus/lrc-gh-action@v1\n        id: lrc_run_test\n        env:\n          LRC_CLIENT_ID: ${{secrets.LRC_CLIENT_ID}}\n          LRC_CLIENT_SECRET: ${{secrets.LRC_CLIENT_SECRET}}\n        with:\n          lrc_server: 'https://loadrunner-cloud.saas.microfocus.com'\n          lrc_tenant: '123456789'\n          lrc_project: '1'\n          lrc_test_id: '123'\n```\n\n### Start a load test via a manually triggered workflow and upload the results to GitHub [Artifacts](https://docs.github.com/en/actions/using-workflows/storing-workflow-data-as-artifacts)\n\n```yml\non: \n  workflow_dispatch:\n    inputs:\n      lrc_server:\n        description: 'LRC URL'\n        required: true\n        default: 'https://loadrunner-cloud.saas.microfocus.com'\n      lrc_tenant:\n        description: 'Tenant ID'\n        required: true\n      lrc_project:\n        description: 'Project ID'\n        required: true\n        default: '1'\n      lrc_test_id:\n        description: 'Test ID'\n        required: true\n      lrc_output_dir:\n        description: 'The directory to save results'\n        required: false\n        default: './lrc_report'\n      lrc_report_types:\n        description: 'Target report types. For example: pdf, docx, csv'\n        required: false\n        default: ''\njobs:\n  start_load_test:\n    runs-on: self-hosted\n    name: Start a load test\n    steps:\n      - name: Run test in LoadRunner Cloud\n        uses: MicroFocus/lrc-gh-action@v1\n        id: lrc_run_test\n        env:\n          LRC_CLIENT_ID: ${{secrets.LRC_CLIENT_ID}}\n          LRC_CLIENT_SECRET: ${{secrets.LRC_CLIENT_SECRET}}\n        with:\n          lrc_server: ${{ github.event.inputs.lrc_server }}\n          lrc_tenant: ${{ github.event.inputs.lrc_tenant }}\n          lrc_project: ${{ github.event.inputs.lrc_project }}\n          lrc_test_id: ${{ github.event.inputs.lrc_test_id }}\n          lrc_output_dir: ${{ github.event.inputs.lrc_output_dir }}\n          lrc_report_types: ${{ github.event.inputs.lrc_report_types }}\n      - name: Print test run ID\n        run: echo \"LRC Run ID is ${{ steps.lrc_run_test.outputs.lrc_run_id }}\"\n      - name: Upload LRC results\n        uses: actions/upload-artifact@v3\n        with:\n          name: lrc-report-${{ steps.lrc_run_test.outputs.lrc_run_id }}\n          path: ${{ github.event.inputs.lrc_output_dir }}\n```\n\n### Build, deploy and start a load test once a new release is published\n\n```yml\non:\n  release:\n    types: [published]\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n        with:\n          ref: ${{ github.event.release.tag_name }}\n      - uses: actions/setup-node@v3.2.0\n        with:\n          node-version: '16.x'\n      - name: npm build\n        run: npm install \u0026\u0026 npm run build\n      # omit azure login, docker build process ...\n      - uses: 'azure/aci-deploy@v1'\n        with:\n          image: 'sampleapp:${{ github.event.release.tag_name }}'\n      # ...\n  load_test:\n    needs: build\n    runs-on: self-hosted\n    name: Start a load test\n    steps:\n      - name: Run test in LoadRunner Cloud\n        uses: MicroFocus/lrc-gh-action@v1\n        id: lrc_run_test\n        env:\n          LRC_CLIENT_ID: ${{secrets.LRC_CLIENT_ID}}\n          LRC_CLIENT_SECRET: ${{secrets.LRC_CLIENT_SECRET}}\n        with:\n          lrc_server: 'https://loadrunner-cloud.saas.microfocus.com'\n          lrc_tenant: '123456789'\n          lrc_project: '1'\n          lrc_test_id: '123'\n```\n\n### Use [reusable workflow](https://docs.github.com/en/actions/using-workflows/reusing-workflows) provided in `.github/workflows/lrc.yml`\n\n```yml\non:\n  workflow_dispatch:\n\njobs:\n  run_test:\n    # replace the commit hash with latest\n    uses: MicroFocus/lrc-gh-action/.github/workflows/lrc.yml@4733debb55362aa3d57115e566503481ddcf9a03\n    with:\n      lrc_server: 'https://loadrunner-cloud.saas.microfocus.com'\n      lrc_tenant: '123456789'\n      lrc_project: '1'\n      lrc_test_id: '123'\n    secrets:\n      LRC_CLIENT_ID: ${{ secrets.LRC_CLIENT_ID }}\n      LRC_CLIENT_SECRET: ${{ secrets.LRC_CLIENT_SECRET }}\n  print_run_id:\n    if: ${{ always() }}\n    runs-on: ubuntu-latest\n    needs: run_test\n    steps:\n      - run: echo \"LRC Run ID is ${{ needs.run_test.outputs.lrc_run_id }}\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrofocus%2Flrc-gh-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrofocus%2Flrc-gh-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrofocus%2Flrc-gh-action/lists"}