{"id":15022573,"url":"https://github.com/puppetlabs/homebrew-puppet","last_synced_at":"2025-04-06T04:14:10.803Z","repository":{"id":37545952,"uuid":"135461552","full_name":"puppetlabs/homebrew-puppet","owner":"puppetlabs","description":"A tap for Puppet macOS package distribution","archived":false,"fork":false,"pushed_at":"2024-12-10T22:07:48.000Z","size":1429,"stargazers_count":44,"open_issues_count":5,"forks_count":42,"subscribers_count":65,"default_branch":"master","last_synced_at":"2025-03-30T03:08:00.498Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://puppet.com/community","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/puppetlabs.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":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-30T15:18:04.000Z","updated_at":"2024-12-10T22:07:53.000Z","dependencies_parsed_at":"2024-01-19T22:45:33.391Z","dependency_job_id":"e9bca665-7f2c-4dd2-a169-1029a843af1a","html_url":"https://github.com/puppetlabs/homebrew-puppet","commit_stats":{"total_commits":437,"total_committers":52,"mean_commits":8.403846153846153,"dds":0.7940503432494279,"last_synced_commit":"51eeb870099a94b25ed63d007b0ce49a8d473c82"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fhomebrew-puppet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fhomebrew-puppet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fhomebrew-puppet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fhomebrew-puppet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/puppetlabs","download_url":"https://codeload.github.com/puppetlabs/homebrew-puppet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430959,"owners_count":20937875,"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":[],"created_at":"2024-09-24T19:58:07.977Z","updated_at":"2025-04-06T04:14:10.617Z","avatar_url":"https://github.com/puppetlabs.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Homebrew Puppet\n\nA tap for [Puppet](https://puppet.com) macOS packages\n\n- [How do I install these packages?](#how-do-i-install-these-packages)\n  - [Bolt](#bolt)\n  - [PE Client Tools](#pe-client-tools)\n  - [PDK](#pdk)\n  - [Puppet Agent](#puppet-agent)\n  - [Wash](#wash)\n  - [Relay](#relay)\n- [Migrating from pre-tap installations](#migrating-from-pre-tap-installations)\n- [Updating versions](#updating-versions)\n  - [Updating pe-client-tools](#updating-pe-client-tools)\n\n## How do I install these packages?\n\n```bash\nbrew install --cask puppetlabs/puppet/\u003cpackage\u003e\n```\n\n### Bolt\n\nTo install [Bolt](https://github.com/puppetlabs/bolt) with brew run\n\n```bash\nbrew install --cask puppetlabs/puppet/puppet-bolt\n```\n\nThis will install bolt to `/opt/puppetlabs/bin/bolt`, so to use bolt add `/opt/puppetlabs/bin` to your path\n\n```bash\nexport PATH=$PATH:/opt/puppetlabs/bin\n```\n\n#### Installing Bolt 2.x\n\nTo install Bolt 2.x, run\n\n```bash\nbrew tap puppetlabs/puppet\nbrew install puppet-bolt@2\n```\n\n### PE Client Tools\n\nTo install the latest version of [PE Client Tools](https://puppet.com/docs/pe/latest/installing_pe_client_tools.html) run\n\n```bash\nbrew install puppetlabs/puppet/pe-client-tools\n```\n\nTo install the client tools for PE 2021, run\n\n```bash\nbrew install puppetlabs/puppet/pe-client-tools\n```\n\nThis will install the standalone commands from pe-client-tools to `/opt/puppetlabs/bin` so you'll need to have `/opt/puppetlabs/bin` in your path. All the commands are also available via a puppet face if you have the puppet-agent installed too.\n\n### PDK\n\nTo install [PDK](https://github.com/puppetlabs/pdk) with brew:\n\n```bash\nbrew install --cask puppetlabs/puppet/pdk\n```\n\nThis will install PDK into `/opt/puppetlabs/pdk` and add an entry into `/etc/paths.d` to add PDK to your\nshell's PATH, however you may have to relaunch your terminal session before `pdk` can be found on your PATH.\n\nIf you use ZShell (zsh), you will have to take additional steps before `pdk` can be found on your PATH, see\nthe [PDK Troubleshooting](https://puppet.com/docs/pdk/1.x/pdk_troubleshooting.html#pdk-not-in-zshell-path-on-mac-os-x) docs\nto learn more.\n\n#### Installing PDK 1.x\n\nTo install the latest PDK 1.x release, run\n\n```bash\nbrew tap puppetlabs/puppet\nbrew install pdk@1\n```\n\n### Puppet Agent\n\nTo install the very latest [Puppet Agent](https://github.com/puppetlabs/puppet-agent) with brew:\n\n```bash\nbrew install puppetlabs/puppet/puppet-agent\n```\n\nAdditionally we maintain versioned casks for each collection\n- `puppetlabs/puppet/puppet-agent-6`\n- `puppetlabs/puppet/puppet-agent-7`\n\n## Migrating from pre-tap installations\n\nIf you previously installed the PDK or Bolt from homebrew before this tap existed, you will see errors about the keg not existing or the cask already being installed.\n\nTo remedy that, simply add the `puppetlabs/puppet` tap after updating homebrew:\n\n```bash\nbrew update\nbrew tap puppetlabs/puppet\n```\n\nAfter tapping, you can refer to the packages by their short name when interacting with them. For example:\n\n```bash\nbrew upgrade pdk\n```\n\n## Updating versions\n\nWhen new versions of packages are shipped, you can use a Rake task to update the Cask to the latest version and SHAs\n\n```bash\nrake 'brew:cask[puppet-bolt]'\n```\n\nTo update the versioned casks - for example `puppet-agent-6` - include the collection as a 2nd argument\n\n```bash\nrake 'brew:cask[puppet-agent,6]'\n```\n\nYou can test updated Cask files with\n\n```bash\nbrew install Casks/puppet-bolt.rb --force\n```\n\n### Updating pe-client-tools\n\nRight now, pe-client-tools live in a location that can't be browsed so we needed a different rake task for it. There is a variable for the latest / default version of PE and a hash that defines the pe-client-tools version associated with each PE version.\n\nTo pull down a new version of the client tools you will first want to update the variables in the Rakefile and then run one of these commands:\n\n```bash\n# utilize the LATEST_PE variable\nrake brew:pe_client_tools\n\n# Update the individual PE collections\nrake 'brew:pe_client_tools[2019.8]'\n```\n\nInternally, we can look for the available versions by poking around on http://builds.puppetlabs.lan/pe-client-tools/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuppetlabs%2Fhomebrew-puppet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpuppetlabs%2Fhomebrew-puppet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuppetlabs%2Fhomebrew-puppet/lists"}