{"id":19361584,"url":"https://github.com/mxk/go-pkgsite","last_synced_at":"2026-05-18T14:07:00.611Z","repository":{"id":234717224,"uuid":"789408873","full_name":"mxk/go-pkgsite","owner":"mxk","description":"Helm chart for a private pkg.go.dev documentation server","archived":false,"fork":false,"pushed_at":"2024-05-05T04:44:47.000Z","size":186,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-05T14:25:44.939Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mxk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-04-20T13:16:54.000Z","updated_at":"2024-05-27T19:31:26.662Z","dependencies_parsed_at":"2024-05-27T19:31:24.172Z","dependency_job_id":"8b798ed5-bb3c-4f4b-a0ce-ac96705efc21","html_url":"https://github.com/mxk/go-pkgsite","commit_stats":null,"previous_names":["mxk/go-pkgsite"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxk%2Fgo-pkgsite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxk%2Fgo-pkgsite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxk%2Fgo-pkgsite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxk%2Fgo-pkgsite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mxk","download_url":"https://codeload.github.com/mxk/go-pkgsite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240476453,"owners_count":19807519,"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-11-10T07:23:59.952Z","updated_at":"2026-05-18T14:06:55.567Z","avatar_url":"https://github.com/mxk.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Private pkg.go.dev server Helm chart\n\nThis [Helm] chart runs [golang/pkgsite][pkgsite] backed by [gomods/athens][athens] to provide a private documentation server that can access protected repositories.\n\n[helm]: https://helm.sh/\n[pkgsite]: https://github.com/golang/pkgsite\n[athens]: https://github.com/gomods/athens\n\n## Setup\n\n### Deployment\n\n```\nhelm upgrade -i go-pkgsite oci://registry-1.docker.io/mxkh/go-pkgsite\n```\n\nSee [chart/values.yaml][values] for customization options.\n\nIf deploying on Rancher Desktop, ensure that both Kubernetes and Traefik are enabled in [preferences].\n\n[values]: https://github.com/mxk/go-pkgsite/blob/main/chart/values.yaml\n[preferences]: https://docs.rancherdesktop.io/ui/preferences/kubernetes/\n\n### Private server credentials\n\nServer-specific credentials can be supplied in a custom `values.yaml` file as follows:\n\n```\nprivate:\n- host: gitlab.example.com\n  username: myusername\n  password: mytoken\n- host: github.example.com\n  username: mytoken\n```\n\nTo deploy: `helm upgrade -i go-pkgsite oci://registry-1.docker.io/mxkh/go-pkgsite -f values.yaml`\n\nTo avoid storing passwords in `values.yaml`, provide them on the command line using `--set-string private[0].password=...`.\n\n### Ingress TLS\n\nIngress TLS key and certificate can be configured via: `helm upgrade -i go-pkgsite oci://registry-1.docker.io/mxkh/go-pkgsite -f values.yaml --set-file tlsKey=key.pem,tlsCrt=crt.pem`\n\n## Known Issues\n\n### .netrc support\n\nAs of May 2024, [pkgsite] does not handle `.netrc` credentials, leading to [invalid links to source files][60299]. To work around this (without forking pkgsite), the chart runs a custom proxy server that intercepts all `?go-get=1` requests from `frontend` and injects the appropriate credentials. This has been tested with a private GitLab instance, but may cause problems for other installations.\n\n[60299]: https://github.com/golang/go/issues/60299\n\n## Release publication\n\nTODO: Automate\n\n1. Update dependencies: `helm dependency update chart`\n2. Bump version in `chart/Chart.yaml`.\n3. Create and tag release commit.\n4. Rebuild Docker image: `docker build --no-cache -t mxkh/go-pkgsite -t mxkh/go-pkgsite:\u003cversion\u003e-alpine .`\n   * Version tag must have a suffix to differentiate it from the OCI Helm package.\n5. Push Docker image: `docker push mxkh/go-pkgsite mxkh/go-pkgsite:\u003cversion\u003e-alpine`\n6. Package and push chart: `helm package chart \u0026\u0026 helm push go-pkgsite-*.tgz oci://registry-1.docker.io/mxkh`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxk%2Fgo-pkgsite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmxk%2Fgo-pkgsite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxk%2Fgo-pkgsite/lists"}