{"id":16878777,"url":"https://github.com/peterj/semver","last_synced_at":"2025-06-12T11:33:34.301Z","repository":{"id":145601209,"uuid":"130272800","full_name":"peterj/semver","owner":"peterj","description":"Basic semantic versioning service","archived":false,"fork":false,"pushed_at":"2018-04-25T18:49:37.000Z","size":3113,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-29T06:44:46.262Z","etag":null,"topics":["go","golang","helm","makefile","semver"],"latest_commit_sha":null,"homepage":"","language":"Go","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/peterj.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":"2018-04-19T21:08:09.000Z","updated_at":"2023-01-14T20:46:09.000Z","dependencies_parsed_at":"2023-09-18T06:00:17.682Z","dependency_job_id":null,"html_url":"https://github.com/peterj/semver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/peterj/semver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fsemver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fsemver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fsemver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fsemver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterj","download_url":"https://codeload.github.com/peterj/semver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterj%2Fsemver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259456076,"owners_count":22860481,"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":["go","golang","helm","makefile","semver"],"created_at":"2024-10-13T15:51:21.699Z","updated_at":"2025-06-12T11:33:33.947Z","avatar_url":"https://github.com/peterj.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Semantic versioning service\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/peterj/semver?style=flat-square)](https://goreportcard.com/report/github.com/peterj/semver)\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fpeterj%2Fsemver.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fpeterj%2Fsemver?ref=badge_shield)\n\nThis repo contains a simple service that allows you to bump semantic version.\nYou give it a version and a type of bump you want (major, minor, patch) and it\nwill return you the updated version string.\n\nRunning version of the service is a https://www.semver.xyz and you can read more\nabout it on\n[Medium](https://medium.com/@pjausovec/from-makefile-to-go-semantic-versioning-service-on-kubernetes-3fae678db87c).\n\n### Build and run locally\n\nRun `make all` to build (and run) service locally. `all` will run go format,\nlinter, tests and go vet.\n\n### Docker build and push\n\nBefore running the commands below, make sure you set the `DOCKER_REGISTRY`\nenvironment variable to the name of your Docker registry.\n\nBuild the Docker image for the service and push it to the registry :\n\n```bash\nmake publish.svc\n```\n\nBuild Docker image for the web:\n\n```bash\nmake publish.web\n```\n\nThere are also targets for only building and only pushing the images. Use\n`make build.image.svc` or `make push.image.svc` to build and push the images\nseparately.\n\n### Initial deployment to Kubernetes\n\nIf you're starting from a clean Kubernetes cluster (or namespaces), you will\nhave to install `kube-lego` and `nginx-ingress` first:\n\n```bash\nhelm install stable/kube-lego \\\n --set config.LEGO_EMAIL=[YOUR_EMAIL] \\\n --set config.LEGO_URL=https://acme-v01.api.letsencrypt.org/directory\n```\n\nInstall Nginx ingress:\n\n```bash\nhelm install stable/nginx-ingress --namespace [NAMESPACE]\n```\n\nOnce those are installed you can run `make install.svc` to install the semver\nservice and `make install.web` to install the web portion of the project.\n\n#### Incremental upgrades\n\nIf you already have an existing Helm release (i.e. you did the initial\ndeployment to Kubernetes), you can use `make upgrade` command to build the\nDocker images, push them to the registry and upgrade the existing releases that\nare running inside Kubernetes.\n\n\n## License\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fpeterj%2Fsemver.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fpeterj%2Fsemver?ref=badge_large)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterj%2Fsemver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterj%2Fsemver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterj%2Fsemver/lists"}