{"id":31776873,"url":"https://github.com/f1bonacc1/process-compose-recipes","last_synced_at":"2025-10-10T05:59:12.831Z","repository":{"id":313262667,"uuid":"1049376234","full_name":"F1bonacc1/process-compose-recipes","owner":"F1bonacc1","description":"A curated collection of ready-to-use Process-Compose recipes for common development and infrastructure scenarios.","archived":false,"fork":false,"pushed_at":"2025-09-13T21:42:23.000Z","size":15,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-30T23:57:01.474Z","etag":null,"topics":["infrastructure","process-compose","recipes"],"latest_commit_sha":null,"homepage":"https://f1bonacc1.github.io/process-compose/","language":null,"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/F1bonacc1.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-02T22:18:25.000Z","updated_at":"2025-09-14T23:50:23.000Z","dependencies_parsed_at":"2025-09-04T22:43:33.005Z","dependency_job_id":"a773869e-f5e5-4db7-b17f-39964e750dfb","html_url":"https://github.com/F1bonacc1/process-compose-recipes","commit_stats":null,"previous_names":["f1bonacc1/process-compose-recipes"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/F1bonacc1/process-compose-recipes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1bonacc1%2Fprocess-compose-recipes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1bonacc1%2Fprocess-compose-recipes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1bonacc1%2Fprocess-compose-recipes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1bonacc1%2Fprocess-compose-recipes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/F1bonacc1","download_url":"https://codeload.github.com/F1bonacc1/process-compose-recipes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F1bonacc1%2Fprocess-compose-recipes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002865,"owners_count":26083468,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["infrastructure","process-compose","recipes"],"created_at":"2025-10-10T05:59:10.091Z","updated_at":"2025-10-10T05:59:12.826Z","avatar_url":"https://github.com/F1bonacc1.png","language":null,"readme":"# Process-Compose Recipes 🍳\n\nA curated collection of ready-to-use [Process-Compose](https://github.com/F1bonacc1/process-compose) recipes for common development and infrastructure scenarios.\n\n## What are Process-Compose Recipes?\n\nProcess-Compose Recipes are pre-configured `process-compose.yaml` files for popular services and applications. Instead of writing complex configurations from scratch, you can pull tested recipes and customize them for your needs.\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Process-Compose](https://github.com/F1bonacc1/process-compose) v1.75 or later\n\n### Using Recipes\n\n```bash\n# Search for available recipes\nprocess-compose recipe search postgres\n\n# Pull a recipe to your local machine\nprocess-compose recipe pull postgres-basic\n\n# List your installed recipes\nprocess-compose recipe list\n\n# Run a recipe\nprocess-compose -f $XDG_CONFIG_HOME/recipes/postgres-basic/process-compose.yaml\n```\n\n## 📋 Available Recipes\n\n| Recipe | Description | Tags | Complexity |\n|--------|-------------|------|------------|\n| [postgres-basic](./postgres-basic) | PostgreSQL database with initialization | `database`, `sql`, `postgres` | ⭐ |\n| [nats-cluster](./nats-cluster) | NATS messaging cluster (3 nodes) | `messaging`, `cluster`, `pubsub` | ⭐⭐⭐ |\n\n\n*Complexity: ⭐ = Simple, ⭐⭐⭐⭐ = Advanced*\n\n## 🔍 Recipe Categories\n\n### Databases\n- [x] **postgres-basic**: Single PostgreSQL instance with persistence\n- [ ] **mysql-replication**: MySQL master-slave setup\n- [ ] **mongodb-replica**: MongoDB replica set configuration\n\n### Message Queues \u0026 Streaming\n- [x] **nats-cluster**: NATS messaging cluster\n- [ ] **kafka-cluster**: Apache Kafka cluster setup\n- [ ] **rabbitmq-cluster**: RabbitMQ cluster setup\n\n### Caching \u0026 Storage\n- [ ] **redis-sentinel**: Redis with high availability\n- [ ] **memcached-cluster**: Distributed Memcached setup\n- [ ] **minio-cluster**: MinIO object storage cluster\n\n### Observability\n- [ ] **prometheus-grafana**: Monitoring stack\n- [ ] **elk-stack**: Elasticsearch, Logstash, Kibana\n- [ ] **jaeger-tracing**: Distributed tracing setup\n\n## 📖 Recipe Structure\n\nEach recipe directory contains:\n\n```\nrecipe-name/\n├── recipe.yaml           # Recipe metadata and configuration\n├── process-compose.yaml  # Main process configuration\n├── README.md             # Recipe-specific documentation\n└── configs/              # Additional configuration files (optional)\n    ├── app.conf\n    └── init.sql\n```\n\n### Recipe Metadata (`recipe.yaml`)\n\n```yaml\nname: postgres-basic\ndescription: Basic PostgreSQL database server with initialization script support\nversion: 1.2.0\nauthor: process-compose-community\ntags:\n  - database\n  - postgres\n  - sql\nlast_updated: 2025-01-15T10:30:00Z\nmin_version: \"0.50.0\"\nrepository: https://github.com/f1bonacc1/process-compose-recipes\n```\n\n## 🛠 Customizing Recipes\n\n### Override Files\n\nCreate override files to modify recipes without changing the original:\n\n```yaml\n# my-postgres-override.yaml\nversion: \"0.5\"\n\nprocesses:\n  postgres:\n    environment:\n      - \"POSTGRES_DB=myproject\"\n      - \"POSTGRES_PASSWORD=mysecret\"\n```\n\n```bash\nprocess-compose -f $XDG_CONFIG_HOME/recipes/postgres-basic/process-compose.yaml -f my-postgres-override.yaml\n```\n\n## 📝 Recipe Commands Reference\n\n### Search Recipes\n```bash\n# Search all recipes\nprocess-compose recipe search\n\n# Search by name\nprocess-compose recipe search postgres\n\n# Search by tags\nprocess-compose recipe search --tags database,sql\n\n# Search by author\nprocess-compose recipe search --author community\n```\n\n### Manage Recipes\n```bash\n# Pull a recipe\nprocess-compose recipe pull \u003crecipe-name\u003e\n\n# Force pull (overwrite existing)\nprocess-compose recipe pull \u003crecipe-name\u003e --force\n\n# List local recipes\nprocess-compose recipe list\n\n# Remove a recipe\nprocess-compose recipe remove \u003crecipe-name\u003e\n\n# Show a recipe\nprocess-compose recipe show \u003crecipe-name\u003e\n```\n\n### Using Recipes\n```bash\n# Run a recipe directly\nprocess-compose -f $XDG_CONFIG_HOME/recipes/\u003crecipe-name\u003e/process-compose.yaml\n\n# Run with custom environment\nPOSTGRES_PASSWORD=secret process-compose -f ~/.process-compose/recipes/postgres-basic/process-compose.yaml\n\n# Run with override file\nprocess-compose -f ~/.process-compose/recipes/postgres-basic/process-compose.yaml -f my-overrides.yaml\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n### Adding New Recipes\n\n1. **Fork this repository**\n2. **Create a new recipe directory** following the naming convention: `service-variant`\n3. **Add required files**:\n   - `recipe.yaml` - Recipe metadata\n   - `process-compose.yaml` - Process configuration\n   - `README.md` - Recipe documentation\n4. **Test your recipe** thoroughly\n5. **Submit a Pull Request**\n\n### Recipe Guidelines\n\n- **Use semantic versioning** for recipe versions\n- **Include comprehensive health checks** for all services\n- **Support customization** through environment variables\n- **Provide sensible defaults** for all configuration options\n- **Document dependencies** and requirements clearly\n- **Test on multiple platforms** when possible\n\n### Recipe Naming Convention\n\n- Use lowercase with hyphens: `service-variant`\n- Be descriptive but concise: `postgres-basic`, `redis-sentinel`\n- Include complexity indicators: `kafka-simple`, `kafka-cluster`\n\n### Metadata Requirements\n\n```yaml\nname: recipe-name              # Must match directory name\ndescription: Clear description # One-line summary\nversion: X.Y.Z                 # Semantic version\nauthor: your-name              # Author/maintainer\ntags: [tag1, tag2]             # Searchable tags\nlast_updated: 2025-01-15T10:30:00Z\nmin_version: \"0.50.0\"          # Min process-compose version\n```\n\n## 🐛 Issues and Support\n\n- **Recipe Issues**: Open an issue in this repository\n- **Process-Compose Issues**: Open an issue in the [main repository](https://github.com/F1bonacc1/process-compose)\n- **Discussions**: Use GitHub Discussions for questions and ideas\n\n### Issue Templates\n\nWhen reporting issues, please include:\n- Recipe name and version\n- Process-Compose version\n- Operating system and architecture\n- Complete error logs\n- Steps to reproduce\n\n## 📚 Examples\n\n### Basic Database Setup\n```bash\n# Pull and run PostgreSQL\nprocess-compose recipe pull postgres-basic\nprocess-compose -f $XDG_CONFIG_HOME/recipes/postgres-basic/process-compose.yaml\n\n# Connect to database\npsql -h localhost -U postgres -d myapp\n```\n\n### Microservices with Messaging\n```bash\n# Set up NATS cluster\nprocess-compose recipe pull nats-cluster\nprocess-compose -f $XDG_CONFIG_HOME/recipes/nats-cluster/process-compose.yaml\n\n# Test cluster connectivity\nnats pub test \"Hello NATS!\"\nnats sub test\n```\n\n---\n\n**Happy Composing!** 🎵\n\nFor more information about Process-Compose, visit the [main repository](https://github.com/F1bonacc1/process-compose).","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1bonacc1%2Fprocess-compose-recipes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff1bonacc1%2Fprocess-compose-recipes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1bonacc1%2Fprocess-compose-recipes/lists"}