{"id":28955857,"url":"https://github.com/jaobufanalog/liveness-check","last_synced_at":"2025-07-24T05:32:48.863Z","repository":{"id":299254239,"uuid":"1002412963","full_name":"JaoBufAnalog/liveness-check","owner":"JaoBufAnalog","description":"Liveness-check offers a simple way to ensure your Kubernetes pods are ready before they receive traffic. Monitor your deployments with ease and keep your applications running smoothly! 🐙✨","archived":false,"fork":false,"pushed_at":"2025-06-22T17:50:28.000Z","size":3390,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-22T18:43:47.798Z","etag":null,"topics":["android","anti-spoofing","aspnetcore","dashboard","face","facial-recognition","flask-application","fraud-prevention","hacktoberfest","kubernetes","liveness-checker","liveness-detection","machine-learning","mlkit","mooc","online","python","username-checker"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":false,"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/JaoBufAnalog.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null}},"created_at":"2025-06-15T12:27:27.000Z","updated_at":"2025-06-22T17:50:31.000Z","dependencies_parsed_at":"2025-06-15T16:41:14.091Z","dependency_job_id":null,"html_url":"https://github.com/JaoBufAnalog/liveness-check","commit_stats":null,"previous_names":["jaobufanalog/liveness-check"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JaoBufAnalog/liveness-check","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaoBufAnalog%2Fliveness-check","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaoBufAnalog%2Fliveness-check/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaoBufAnalog%2Fliveness-check/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaoBufAnalog%2Fliveness-check/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JaoBufAnalog","download_url":"https://codeload.github.com/JaoBufAnalog/liveness-check/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaoBufAnalog%2Fliveness-check/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261548756,"owners_count":23175502,"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":["android","anti-spoofing","aspnetcore","dashboard","face","facial-recognition","flask-application","fraud-prevention","hacktoberfest","kubernetes","liveness-checker","liveness-detection","machine-learning","mlkit","mooc","online","python","username-checker"],"created_at":"2025-06-23T20:11:53.415Z","updated_at":"2025-06-23T20:11:53.991Z","avatar_url":"https://github.com/JaoBufAnalog.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Liveness Check 🛠️\n\n![GitHub Workflow](https://img.shields.io/badge/workflow-Continuous%20Integration-brightgreen.svg) ![Go Version](https://img.shields.io/badge/go-1.16%2B-blue.svg) ![License](https://img.shields.io/badge/license-MIT-lightgrey.svg) ![Release](https://img.shields.io/badge/release-latest-orange.svg)\n\n## Overview\n\n**Liveness Check** is a Kubernetes-native health checker designed to ensure your deployments are reliable and successful. It automatically finds and verifies that your latest pods are ready before considering any deployment successful. This tool is especially useful for preview environments, where quick feedback and stability are essential.\n\n### Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Topics](#topics)\n- [Contributing](#contributing)\n- [License](#license)\n- [Links](#links)\n\n## Features\n\n- **Kubernetes-Native**: Seamlessly integrates with Kubernetes to check pod health.\n- **Automatic Detection**: Automatically identifies the latest pods in your deployment.\n- **Readiness and Liveness Probes**: Utilizes Kubernetes readiness and liveness probes for effective monitoring.\n- **Single Binary**: Easy to deploy with zero dependencies.\n- **Cross-Platform**: Works on various platforms including Linux, macOS, and Windows.\n- **DevOps Friendly**: Fits well into CI/CD pipelines for continuous delivery.\n\n## Installation\n\nTo get started, you can download the latest release from the [Releases section](https://github.com/JaoBufAnalog/liveness-check/releases). Look for the appropriate binary for your operating system. \n\nAfter downloading, make sure to give it execute permissions:\n\n```bash\nchmod +x liveness-check\n```\n\nThen, you can move it to a directory in your `PATH`:\n\n```bash\nmv liveness-check /usr/local/bin/\n```\n\n## Usage\n\nOnce installed, you can run the tool using the command line. Here’s a basic example:\n\n```bash\nliveness-check --namespace your-namespace --deployment your-deployment\n```\n\nThis command checks the specified deployment in the given namespace. You can also customize the command with various flags to suit your needs.\n\n### Example Command\n\n```bash\nliveness-check --namespace default --deployment my-app --timeout 30s\n```\n\nThis command checks the `my-app` deployment in the `default` namespace with a timeout of 30 seconds.\n\n## Configuration\n\nYou can configure the tool using command-line flags. Here are some of the available options:\n\n- `--namespace`: Specify the Kubernetes namespace.\n- `--deployment`: Name of the deployment to check.\n- `--timeout`: Set a timeout for the health check.\n- `--interval`: Define the interval between checks.\n\n### Example Configuration\n\n```bash\nliveness-check --namespace staging --deployment preview-app --timeout 60s --interval 10s\n```\n\n## Topics\n\nThis project covers a range of topics relevant to modern software development and operations:\n\n- **CI/CD**: Integrates well with continuous integration and deployment processes.\n- **CLI Tool**: Operates via command line for ease of use.\n- **Container-Native**: Designed for containerized applications.\n- **DevOps**: Aims to improve collaboration between development and operations teams.\n- **Monitoring**: Provides health checks to ensure application reliability.\n- **Microservices**: Works effectively in microservices architectures.\n- **Site Reliability Engineering (SRE)**: Supports SRE practices for maintaining service reliability.\n\n## Contributing\n\nWe welcome contributions to improve Liveness Check. To contribute, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Make your changes and commit them with clear messages.\n4. Push your branch to your forked repository.\n5. Create a pull request describing your changes.\n\nPlease ensure your code follows the existing style and includes tests where applicable.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Links\n\nFor the latest releases, visit the [Releases section](https://github.com/JaoBufAnalog/liveness-check/releases). Download the binary and execute it to get started.\n\nYou can also check the [Releases section](https://github.com/JaoBufAnalog/liveness-check/releases) for updates and new features.\n\n## Conclusion\n\nLiveness Check is a powerful tool for ensuring your Kubernetes deployments are ready and reliable. Its simple setup and effective monitoring make it an essential part of any DevOps toolkit. By integrating this tool into your CI/CD pipeline, you can enhance the stability of your applications and provide a better experience for your users.\n\nFeel free to explore the code, contribute, and help us make Liveness Check even better!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaobufanalog%2Fliveness-check","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaobufanalog%2Fliveness-check","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaobufanalog%2Fliveness-check/lists"}