{"id":15144563,"url":"https://github.com/laojala/robot_docker_demo","last_synced_at":"2025-10-23T20:42:10.176Z","repository":{"id":52307160,"uuid":"289556052","full_name":"laojala/robot_docker_demo","owner":"laojala","description":"Robot Framework - Setup CI using GitHub Actions","archived":false,"fork":false,"pushed_at":"2023-06-06T19:13:50.000Z","size":45,"stargazers_count":7,"open_issues_count":0,"forks_count":19,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-09-27T10:42:06.854Z","etag":null,"topics":["robot-framework","setup-ci"],"latest_commit_sha":null,"homepage":"","language":"RobotFramework","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laojala.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}},"created_at":"2020-08-22T19:46:24.000Z","updated_at":"2023-05-09T07:22:49.000Z","dependencies_parsed_at":"2023-01-18T16:15:59.157Z","dependency_job_id":null,"html_url":"https://github.com/laojala/robot_docker_demo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laojala%2Frobot_docker_demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laojala%2Frobot_docker_demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laojala%2Frobot_docker_demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laojala%2Frobot_docker_demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laojala","download_url":"https://codeload.github.com/laojala/robot_docker_demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219867717,"owners_count":16555814,"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":["robot-framework","setup-ci"],"created_at":"2024-09-26T10:42:09.719Z","updated_at":"2025-10-23T20:42:10.075Z","avatar_url":"https://github.com/laojala.png","language":"RobotFramework","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Robot Framework CI Demo\n\nThis project demonstrates how to setup Continous Integration for Robot Framework tests using [GitHub Actions](https://docs.github.com/en/actions).\n\n## Use Cases\n\nDemo covers these use cases:\n\n* Run Robot Framework tests:\n    * when new commits are pushed to the main branch\n    * when new commits are pushed to a Pull request\n    * run tests with a pre-defined schedule\n    * Trigger tests manually. Input variables for a test run.\n* Reporting:\n    * Store Robot Framework reports from test runs\n    * Post summary of results as a comment to a commit. The comment is posted only to the main (master) branch.\n\nIn other words, a separate CI server (such as Jenkins) is not needed to run Robot Framework tests. \n\n### Why use Actions for CI?\n\nUsing GitHub Actions for setup CI is almost better than sourdough bread 🍞🎉 Setup is straightforward and usage is free for public repositories (see [pricing](https://github.com/pricing) for other types of repositories).\n\nSetup described here is very simple for demo purposes. It is possible to add more bells and whistles if needed.\n\n## Description of the setup\n\nCI Workflows are configured in YAML files in a folder `.github/workflows`. When Job is run, it is visible in the [Actions tab](https://github.com/laojala/robot_docker_demo/actions) in the repository. \n\nThis repository has two workflows for demo purposes:\n* [run_robot_framework_tests.yml](.github/workflows/run_robot_framework_tests.yml)\n    * runs test for push events, pull requests and scheduled\n    * steps in this file are documented in detail\n* [trigger_robot_framework_tests_manually.yml](.github/workflows/trigger_robot_framework_tests_manually.yml)\n    * triggers tests manually with the given parameters\n\nDocker container used in this demo is [ppodgorsek/robot-framework](https://hub.docker.com/r/ppodgorsek/robot-framework). The container has many pre-installed libraries and tools (it is even possible to run Selenium Browser tests).\n\nWorkflow fails if Robot Framework tests fail. Robot Framework results reports are stored in a zip file.\n\nThe next chapter describes how to modify example workflows for your project.\n\n### To configure example setup to your own project\n\n1. Configure `docker run` command according to your project:\n    * Place your tests to the `test` folder\n    * Modify line `-e ROBOT_OPTIONS=\"--variable DINOSAUR:Achillobator --variable NOT_DINOSAUR:kissa\" \\` according to your project or remove it completely\n\n```\ndocker run \\\n    -v ${PWD}/reports:/opt/robotframework/reports:Z \\\n    -v ${PWD}/tests:/opt/robotframework/tests:Z \\\n    -e ROBOT_OPTIONS=\"--variable DINOSAUR:Achillobator --variable NOT_DINOSAUR:kissa\" \\\n    --user $(id -u):$(id -g) \\\n    ppodgorsek/robot-framework:latest\n```\n\n2. All other configurations, such as changing the cron schedule are optional. \n\nThings to consider:\n\n   * If workflow needs secrets, those can be stored in repository settings. Secret is used in the flow like this `${{ secrets.MY_SECRET_NAME }}`\n   * Docker image `ppodgorsek/robot-framework:latest` is not versioned. `latest` tag can contain any version of the Robot Framework and other libraries. *It is strongly advised to use some other version controlled image for running tests.*\n\n## Acknowledgments\n\n* List of dinosaur names used in tests (it would be actually possible to configure updating list of dinosaur names using Actions 🦕🦖): [https://www.npmjs.com/package/dinosaurs](https://www.npmjs.com/package/dinosaurs)\n* Docker container used to run Robot Framework tests: [ppodgorsek/robot-framework Docker container](https://hub.docker.com/r/ppodgorsek/robot-framework)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaojala%2Frobot_docker_demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaojala%2Frobot_docker_demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaojala%2Frobot_docker_demo/lists"}