{"id":15284180,"url":"https://github.com/voxpupuli/puppet-healthcheck","last_synced_at":"2026-03-10T11:05:07.291Z","repository":{"id":32366018,"uuid":"35942111","full_name":"voxpupuli/puppet-healthcheck","owner":"voxpupuli","description":"Puppet resources to evaluate the health and status of things.","archived":false,"fork":false,"pushed_at":"2025-10-17T14:59:45.000Z","size":238,"stargazers_count":23,"open_issues_count":3,"forks_count":17,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-10-29T12:37:10.824Z","etag":null,"topics":["centos-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","scientific-puppet-module","ubuntu-puppet-module"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/puppet/healthcheck","language":"Ruby","has_issues":true,"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/voxpupuli.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2015-05-20T10:44:49.000Z","updated_at":"2025-10-17T14:59:48.000Z","dependencies_parsed_at":"2024-04-15T07:12:30.726Z","dependency_job_id":"de49e1fe-4890-4ff5-96d4-c98c18333b4d","html_url":"https://github.com/voxpupuli/puppet-healthcheck","commit_stats":{"total_commits":130,"total_committers":19,"mean_commits":6.842105263157895,"dds":"0.23076923076923073","last_synced_commit":"841139559c7a49ce0018d3bf7a6d68e557ac4ab4"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/voxpupuli/puppet-healthcheck","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-healthcheck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-healthcheck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-healthcheck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-healthcheck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-healthcheck/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-healthcheck/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30331652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["centos-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","scientific-puppet-module","ubuntu-puppet-module"],"created_at":"2024-09-30T14:50:30.747Z","updated_at":"2026-03-10T11:05:07.262Z","avatar_url":"https://github.com/voxpupuli.png","language":"Ruby","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":["Modules"],"sub_categories":["News"],"readme":"# puppet-healthcheck\n\n## Types\n\n### tcp_conn_validator\n\n`tcp_conn_validator` is used to verify that a service is listening on a given port.\nIt could be used to test either a remote or a local service. It support both IPv4 and\nIPv6 connection strings. It also works with hostname.\n\n```puppet\ntcp_conn_validator { 'foo-machine ssh service' :\n  host =\u003e '192.168.0.42',\n  port   =\u003e 22,\n}\n```\n\nThe namevar of this resource can also be the connection string. It comes handy when\none already have an array of ip:port or hostname:port string to test.\n\n```puppet\nmongodb_cluster_nodes = ['192.168.0.2:27017', 'node02.foo.bar.com:27017']\ntcp_conn_validator { $mongodb_cluster_nodes : }\n```\n\n#### `host`\n\nIP address or server DNS name on which the service is supposed to be bound to. Required if the namevar is not a connection string.\n\n#### `port`\n\nPort on which the service is supposed to listen. Required if the namevar is not a connection string.\n\n#### `try_sleep`\n\nThe time to sleep in seconds between ‘tries’. Default: 1\n\n#### `timeout`\n\nNumber of seconds to wait before timing out. Default: 60\n\n### http_conn_validator\n\n`http_conn_validator` is used to verify that an http server is answering on a given port.\nIt could be used to test either a remote or a local service. It support both IPv4 and\nIPv6 connection strings. It also works with hostname.\n\n**It currently has the `Accept` header hardcoded to `application/json`, you can only connect to sites that return json**\n\nSee https://github.com/voxpupuli/puppet-healthcheck/blob/b3723805d629cc01767a2fb12c4c8a023d707f94/lib/puppet_x/puppet-community/http_validator.rb#L19 for details\n\n```puppet\nhttp_conn_validator { 'foo-machine home' :\n  host    =\u003e '127.0.0.1',\n  port    =\u003e 80,\n  use_ssl =\u003e true,\n}\n```\n\nThe namevar of this resource can also be the connection string. It comes handy when\none already have an array of URLs string to test.\n\n```puppet\nappli_cluster_nodes = ['https://server1.com/test-url', 'https://server2.com/test-url']\nhttp_conn_validator { $appli_cluster_nodes : }\n```\n\n#### `host`\n\nIP address or server DNS name on which the service is supposed to be bound to. Required if the namevar is not a connection string.\n\n#### `port`\n\nPort on which the service is supposed to listen. Required if the namevar is not a connection string.\n\n#### `use_ssl`\n\nWhether the connection will be attempted using https. Default: false\n\n#### `test_url`\n\nURL to use for testing if the HTTP server is up. Default: /\n\n#### `try_sleep`\n\nThe time to sleep in seconds between ‘tries’. Default: 1\n\n#### `timeout`\n\nNumber of seconds to wait before timing out. Default: 60\n\n#### `expected_code`\n\nExpected HTTP result code to consider success. Default: 200\n\n#### `verify_peer`\n\nWhether to verify the peer credentials, if possible. Verification will not take place if the CA certificate is missing\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-healthcheck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-healthcheck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-healthcheck/lists"}