{"id":26452958,"url":"https://github.com/pace/bricks","last_synced_at":"2025-04-09T05:08:46.067Z","repository":{"id":35426651,"uuid":"166778187","full_name":"pace/bricks","owner":"pace","description":"A standard library for microservices.","archived":false,"fork":false,"pushed_at":"2025-03-21T22:13:32.000Z","size":23226,"stargazers_count":170,"open_issues_count":8,"forks_count":21,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-02T03:17:49.435Z","etag":null,"topics":["bricks","docker","http","jaeger","json","json-api","kubernetes","logging","metrics","microservices","mongodb","openapi3","pace","postgres","prometheus","redis","restful-api","sentry","tracing"],"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/pace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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-01-21T08:41:32.000Z","updated_at":"2025-03-12T07:48:56.000Z","dependencies_parsed_at":"2023-10-04T13:49:58.103Z","dependency_job_id":"9695f627-b3f3-496e-844f-419f7b13c3bd","html_url":"https://github.com/pace/bricks","commit_stats":{"total_commits":652,"total_committers":40,"mean_commits":16.3,"dds":0.7561349693251533,"last_synced_commit":"1bbc0e854b47a1e73385a8b250bf20d520cb5e23"},"previous_names":[],"tags_count":163,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pace%2Fbricks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pace%2Fbricks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pace%2Fbricks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pace%2Fbricks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pace","download_url":"https://codeload.github.com/pace/bricks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247980837,"owners_count":21027808,"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":["bricks","docker","http","jaeger","json","json-api","kubernetes","logging","metrics","microservices","mongodb","openapi3","pace","postgres","prometheus","redis","restful-api","sentry","tracing"],"created_at":"2025-03-18T18:40:37.904Z","updated_at":"2025-04-09T05:08:46.038Z","avatar_url":"https://github.com/pace.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PACE Bricks [![Golang CI](https://github.com/pace/bricks/actions/workflows/golang-ci.yml/badge.svg)](https://github.com/pace/bricks/actions/workflows/golang-ci.yml)  [![Coverage Status](https://coveralls.io/repos/github/pace/bricks/badge.svg?branch=master)](https://coveralls.io/github/pace/bricks?branch=master)\n\n![](artwork/PACE-Bricks_Header_LightBackground.png)\n\nOpinionated microservice kit to help developers to build microservices with go.\n\n## Opinions\n\nA pace/bricks microservice is:\n\n* built as a **docker container**\n* deployed into a **kubernetes cluster**\n  * support for the **termination log**\n* configured using **environment variables** ([TWELVE-FACTOR APP](https://12factor.net/))\n* monitored using **prometheus**\n* reports errors to **sentry**\n* samples traces to **sentry**\n* **logs** to stdout using json deployed **kubernetes** otherwise human readable\n* offers **health** endpoints\n* built-in redaction of JWTs and card schemes\n* connects to backend services\n  * **postgres** (logging, metrics, tracing, health)\n  * **redis** (logging, metrics, tracing, health)\n  * **queue** via redis (logging, metrics, tracing, health)\n  * **http** (logging, metrics, tracing, retries)\n  * **s3** via http (logging, metrics, tracing, health)\n  * **couchdb** via http (logging, metrics, tracing, retries, health)\n  * **grpc** (logging, metrics, tracing, retries)\n* provides two commands **control** and **daemon**\n* provides a **RESTful** API\n  * code is generated from the **OpenAPIv3** spec\n  * authenticated via **OAuth2**\n  * encoded using **[json:api](https://jsonapi.org/)**\n  * that supports **logging**, **tracing** and **metrics**\n* optionally provides a **GRPC** API\n  * code is generated from the **protoc** spec\n  * that supports **logging**, **tracing** and **metrics**\n\n## Install\n\n    go get github.com/pace/bricks/cmd/pb\n\n## Usage\n\n    pb -h\n\n## Contributing\n \nRead our [contributors guide](CONTRIBUTING.md).\n\n## Requirements\n\n* A working go installation\n* A working git installation\n\n## Testing\n\n* Use `make test` to test without dependencies\n* Use `docker-compose run testserver make integration` to test with dependencies\n* Use `make testserver` to start a testserver that will be started with dependencies. In order to update the server one need to `docker-compose restart testserver`\n\n## Environment variables for the pb command\n\n| Variable | Description |\n|-|-|\n| `PACE_BRICKS_EDITOR` |  The path to the editor that should be used for opening a project. Defaults to `$EDITOR`. |\n| `PACE_BRICKS_PATH` | The path where new project should be created. Defaults to `$HOME/PACE`. |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpace%2Fbricks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpace%2Fbricks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpace%2Fbricks/lists"}