{"id":18151102,"url":"https://github.com/bcdevices/pltcloud-action","last_synced_at":"2025-10-28T05:30:37.778Z","repository":{"id":38885891,"uuid":"219585271","full_name":"bcdevices/pltcloud-action","owner":"bcdevices","description":"PLTcloud GitHub Action","archived":false,"fork":false,"pushed_at":"2024-12-28T08:21:05.000Z","size":13,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-28T11:02:53.357Z","etag":null,"topics":["github-actions","pltcloud"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/pltcloud-action","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcdevices.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,"publiccode":null,"codemeta":null}},"created_at":"2019-11-04T19:58:04.000Z","updated_at":"2024-12-28T08:19:40.000Z","dependencies_parsed_at":"2024-11-16T15:05:05.652Z","dependency_job_id":"bd3e6bb3-74d0-4dd5-bf22-4f0d3220da38","html_url":"https://github.com/bcdevices/pltcloud-action","commit_stats":{"total_commits":15,"total_committers":4,"mean_commits":3.75,"dds":0.2666666666666667,"last_synced_commit":"ea846a5e9d7614646d0a15de7ee8a9b25e71a5d6"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcdevices%2Fpltcloud-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcdevices%2Fpltcloud-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcdevices%2Fpltcloud-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcdevices%2Fpltcloud-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcdevices","download_url":"https://codeload.github.com/bcdevices/pltcloud-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238602315,"owners_count":19499378,"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":["github-actions","pltcloud"],"created_at":"2024-11-02T01:06:23.973Z","updated_at":"2025-10-28T05:30:37.490Z","avatar_url":"https://github.com/bcdevices.png","language":"Shell","readme":"# PLTcloud Action \n\nThe PLTcloud action allows publishing firmware releases directly\nto [BCD](https://www.bcdevices.com/)'s [PLTcloud](https://www.bcdevices.com/plt/) backend.\nIt allows you to upload a release to PLTcloud as part of your CI workflow.\n\n## Input variables\n\nMandatory:\n\n| input          | description                      |\n| -------------- | -------------------------------- |\n| `API_TOKEN`    | PLTcloud API token.              |\n| `PROJECT_UUID` | Project id for PLTcloud project. |\n\nOptional:\n\n| input              | description                       |\n| ------------------ | --------------------------------- |\n| `FILES`            | List of files for upload. Files can be specified with patterns such as: `**/prefix*`, `grandparent/**/child?`, `**/parent/*`, or even just `**` |\n| `VERSION`          | Release version. (default: `${{ github.ref }}`) |\n| `VERBOSE`          | Verbose output (default: `false`) |\n| `DEPLOYMENT_GROUP_UUID` | Deployment Group UUID |\n| `AUTO_DEPLOY`      | Auto deploy release to PLT (default: `false`) |\n\n## Usage\n\nStep 1: Validate firmware build and test plans\n==============================================\n\nIn order to upload a release, the PLT test plan, and any associated assets\nsuch as DUT firmware must be available in a directory.\n\nSetup a GitHub action to build the firmware and copy test plans\nto a known directory.\n\nStep 2: Configure project and token secrets\n===========================================\n\n- Log in to PLTcloud and select the `Project` menu item from the\n  project drop-down in the top banner.\n- Copy the ``UUID`` from the project detail page and a secret named\n  ``PROJECT_UUID`` in your GitHub project.\n- Select ``API Tokens`` from the drop-down menu under the user menu in PLTcloud\n- Select ``Add Release Token``, login and copy the ``Release Upload Token``\n- Add the release token to GitHub secrets and name it ``API_TOKEN``\n\nStep 3: Add the PLTcloud action to the GitHub Actions Workflow\n==============================================================\n\nAdd a step in the ``.github/workflows/main.yml`` actions workflow,\nafter the steps that build the firmware:\n\n```yml\n- uses: bcdevices/pltcloud-action@v1.2.0\n  with:\n    FILES: dist/*\n    API_TOKEN: ${{ secrets.API_TOKEN }}\n    PROJECT_UUID: ${{ secrets.PROJECT_UUID }}\n    VERSION: ${{ github.ref }}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcdevices%2Fpltcloud-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcdevices%2Fpltcloud-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcdevices%2Fpltcloud-action/lists"}