{"id":23180941,"url":"https://github.com/replicatedhq/kurl-testgrid","last_synced_at":"2025-04-05T03:13:47.058Z","repository":{"id":58264126,"uuid":"530794158","full_name":"replicatedhq/kURL-testgrid","owner":"replicatedhq","description":"Testgrid is a an automation testing platform for kURL","archived":false,"fork":false,"pushed_at":"2025-04-01T16:44:02.000Z","size":7475,"stargazers_count":1,"open_issues_count":31,"forks_count":0,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-01T17:48:21.740Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/replicatedhq.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":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-30T19:07:43.000Z","updated_at":"2025-04-01T16:42:20.000Z","dependencies_parsed_at":"2022-08-31T07:00:34.667Z","dependency_job_id":"8b17f163-fdc2-4c89-a297-4cd4a1e523e4","html_url":"https://github.com/replicatedhq/kURL-testgrid","commit_stats":{"total_commits":993,"total_committers":37,"mean_commits":26.83783783783784,"dds":0.6545820745216515,"last_synced_commit":"4c2b24bd19f01a454fe6cc7e14004a02309f5546"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/replicatedhq%2FkURL-testgrid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/replicatedhq%2FkURL-testgrid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/replicatedhq%2FkURL-testgrid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/replicatedhq%2FkURL-testgrid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/replicatedhq","download_url":"https://codeload.github.com/replicatedhq/kURL-testgrid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280270,"owners_count":20912967,"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":[],"created_at":"2024-12-18T08:13:53.718Z","updated_at":"2025-04-05T03:13:47.036Z","avatar_url":"https://github.com/replicatedhq.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Testgrid\n\nTestgrid is a an automation testing platform for kURL.\nTestgrid installs kURL specs on a set of linux os versions and runs conformance tests.\n\n## Testgrid Results\n\nTestgrid results can be viewed at https://testgrid.kurl.sh/\n\n### Debugging failed runs\n\nFor each failed Testgrid run, a [Support Bundle](https://github.com/replicatedhq/troubleshoot) is collected, encrypted and uploaded to a public S3 bucket.\n\nThe bundle URL can be obtained from the Testgrid logs output.\n\nThe bundle is encrypted with a passphrase using the [age](https://github.com/FiloSottile/age) file encryption tool.\n\n## Run Testgrid locally\n\n### Prerequisites\n\n- Have docker running locally\n- Have some k8s cluster running\n- Install [SchemaHero](https://schemahero.io/docs/installing/kubectl/)\n- Install skaffold: https://skaffold.dev/docs/install/\n- Set `GOOS` and `GOARCH`\n```bash\n   export GOOS=linux\n   export GOARCH=amd64\n```\n\n### Run Testgrid using Skaffold\n\n- Connect to the cluster\n- Run the following command from ``TESTGRID`` path\n```\nmake install\n```\n\n- Setup port-forwards\n``` bash\nkubectl port-forward svc/tgapi 30110:3000 \u0026\nkubectl port-forward svc/testgrid-web 30881:30881\n```\n\n- Now you are ready to do your first test. \n\n- From tgrun folder run the following command\n```\n./bin/tgrun queue --os-spec hack/os-spec.yaml --spec hack/test-spec.yaml --ref test-1 --api-token this-is-super-secret --api-endpoint http://localhost:30110\n```\n\n- From the web service you should be able to see the pending test.\n\n- Now time to setup your runner by using ``terraform`` go indide the ``deploy` folder and follow the steps from the readme file.\n\n### Run Testgrid on Okteto\n\n1. Change directories to the root of the project\n1. Run `okteto pipeline deploy`\n1. To \"queue\" a run `./bin/tgrun queue --os-spec hack/os-spec.yaml --spec hack/test-spec.yaml --ref ethan-1 --api-token this-is-super-secret --api-endpoint https://tgapi-${OKTETO_NAMESPACE}.okteto.repldev.com`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freplicatedhq%2Fkurl-testgrid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freplicatedhq%2Fkurl-testgrid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freplicatedhq%2Fkurl-testgrid/lists"}