{"id":42267859,"url":"https://github.com/cvent/octopus-deploy-cookbook","last_synced_at":"2026-01-27T06:51:34.047Z","repository":{"id":2229770,"uuid":"41830815","full_name":"cvent/octopus-deploy-cookbook","owner":"cvent","description":"Chef cookbook for configuring Octopus Deploy.","archived":false,"fork":false,"pushed_at":"2025-12-18T01:06:18.000Z","size":265,"stargazers_count":23,"open_issues_count":26,"forks_count":21,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-12-21T11:32:30.063Z","etag":null,"topics":["chef-cookbook","cookbooks","octopus-deploy","octopus-deploy-cookbook","octopus-deploy-server","octopus-deploy-tentacle","octopus-server","tentacle"],"latest_commit_sha":null,"homepage":"https://supermarket.chef.io/cookbooks/octopus-deploy","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/cvent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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}},"created_at":"2015-09-02T22:28:04.000Z","updated_at":"2022-10-27T06:32:51.000Z","dependencies_parsed_at":"2024-11-05T06:20:47.966Z","dependency_job_id":"25d363aa-f595-4bf9-9a7e-2cf317b0151b","html_url":"https://github.com/cvent/octopus-deploy-cookbook","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/cvent/octopus-deploy-cookbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvent%2Foctopus-deploy-cookbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvent%2Foctopus-deploy-cookbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvent%2Foctopus-deploy-cookbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvent%2Foctopus-deploy-cookbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cvent","download_url":"https://codeload.github.com/cvent/octopus-deploy-cookbook/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvent%2Foctopus-deploy-cookbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28806722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T06:25:51.065Z","status":"ssl_error","status_checked_at":"2026-01-27T06:25:50.640Z","response_time":168,"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":["chef-cookbook","cookbooks","octopus-deploy","octopus-deploy-cookbook","octopus-deploy-server","octopus-deploy-tentacle","octopus-server","tentacle"],"created_at":"2026-01-27T06:51:33.448Z","updated_at":"2026-01-27T06:51:34.038Z","avatar_url":"https://github.com/cvent.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Octopus Deploy Cookbook \u003cimg align=\"right\" src=\"https://i.octopus.com/blog/201605-logo-text-blueblacktransparent-400_rgb-TTE8.png\" /\u003e\n=======================\n\n[![Cookbook Converge](https://img.shields.io/appveyor/ci/bigbam505/octopus-deploy-cookbook/master.svg?style=flat-square\u0026label=appveyor)](https://ci.appveyor.com/project/bigbam505/octopus-deploy-cookbook) [![Build Status](https://img.shields.io/travis/cvent/octopus-deploy-cookbook/master.svg?style=flat-square\u0026label=travis)](https://travis-ci.org/cvent/octopus-deploy-cookbook) [![Code Climate](https://img.shields.io/codeclimate/github/cvent/octopus-deploy-cookbook.svg?style=flat-square)](https://codeclimate.com/github/cvent/octopus-deploy-cookbook) [![Chef cookbook](https://img.shields.io/cookbook/v/octopus-deploy.svg?style=flat-square)](https://supermarket.chef.io/cookbooks/octopus-deploy) [![GitHub license](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](https://github.com/cvent/octopus-deploy-cookbook/blob/master/LICENSE)\n\nThis cookbook is used for installing the [Octopus Deploy](http://octopusdeploy.com) server and Tentacle on Microsoft Windows machines.\n\u003cbr /\u003e\n\n**\\*\\*NOTE:** This cookbook is managed by Cvent and not by the Octopus Deploy team.\n\n\n## NOTICE: Pre-Release\nThis is pre release and there will be major changes to this before its final release.  The recipes for installation and configuration will be switched into resources so people can use the library easier. Once this is found stable it will be released as version 1.0.0, until this point lock down to any minor version that you use.\n\n## Resource/Provider\n### octopus_deploy_server\n#### Actions\n- :install: Install a version of Octopus Deploy server\n- :configure: Install a version of Octopus Deploy server and configure it\n- :remove: Uninstall a version of the Octopus Deploy Server if it is installed\n\n#### Attribute Parameters\n- :instance: Name attribute. The Octopus Deploy Server instance name (used for configuring the instance not install)\n- :version: Required. The version of Octopus Deploy Server to install\n- :checksum: The SHA256 checksum of the Octopus Deploy Server msi file to verify download\n- :home_path: The Octopus Deploy Server home directory (Defaults to C:\\Octopus)\n- :install_url: The url for the installer to download.\n- :config_path: The Octopus Deploy Server config file path (Defaults to C:\\Octopus\\OctopusServer.config)\n- :connection_string: The Octopus Deploy Server connection string to the MSSQL Server instance. Required for `:configure` action.\n- :master_key: The Octopus Deploy Server master key for encryption, leave blank to generate one at creation\n- :node_name: The Octopus Deploy Server Node Name, will default to chef node name\n- :create_database: Whether Octopus Deploy Server should create the database with the connection string provided (Defaults to false)\n- :admin_user: A default admin user for Octopus Deploy Server to create. Requires machine to be joined to active directory, and `admin_user` must be an AD user\n- :license: The raw license key for Octopus Deploy Server to use\n- :start_service: Whether to start the Octopus Deploy Server service after creation of the instance (Defaults to True)\n\n#### Example\nInstall version 3.17.1 of Octopus Deploy Server\n\n\n```ruby\noctopus_deploy_server 'OctopusServer' do\n  action :install\n  version '3.17.1'\n  checksum '\u003cSHA256-checksum\u003e'\nend\n```\n\n**This cookbook does not setup the database. You will need a preexisting SQLEXPRESS/MSSQL database instance**\n\n```ruby\noctopus_database = \"OctopusDeploy\"\n\noctopus_deploy_server 'OctopusServer' do\n  action [:install, :configure]\n  version '3.17.1'\n  checksum'cee5ef29d6e517d197687c50a041be47a3bd56a65010051ddc53dc0c515d39e5'\n  connection_string \"Data Source=(local)\\\\SQLEXPRESS;Initial Catalog=#{octopus_database};Integrated Security=True\"\n  node_name node.name\n  create_database true\n  license '1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ'\n  start_service true\nend\n```\n\n\n### octopus_deploy_tentacle\n#### Actions\n- :install: Install a version of Octopus Deploy Tentacle (Default)\n- :configure: Configure an instance of the octopus Deploy Tentacle\n- :register: Register Tentacle with Octopus Deploy Server\n- :remove: Remove an instance of the Octopus Deploy Tentacle\n- :uninstall: Uninstall a version of the Octopus Deploy Tentacle if it is installed\n\n#### Attribute Parameters\n- :instance: Name attribute. The Octopus Deploy Tentacle instance name (used for configuring the instance not install)\n- :version: Required. The version of Octopus Deploy Tentacle to install\n- :checksum: The SHA256 checksum of the Octopus Deploy Tentacle msi file to verify download\n- :home_path: The Octopus Deploy Instance home directory (Defaults to C:\\Octopus)\n- :config_path: The Octopus Deploy Instance config file path (Defaults to C:\\Octopus\\Tentacle.config)\n- :app_path: The Octopus Deploy Instance application directory (Defaults to C:\\Octopus\\Applications)\n- :trusted_cert: The Octopus Deploy Instance trusted Server cert\n- :port: The Octopus Deploy Instance port to listen on for listening Tentacle (Defaults to 10933)\n- :configure_firewall: Whether cookbook will open firewall on listen Tentacles (Defaults to false)\n- :polling: Whether this Octopus Deploy Instance is a polling Tentacle (Defaults to False)\n- :cert_file: Where to export the Octopus Deploy Instance cert (Defaults to C:\\Octopus\\tentacle_cert.txt)\n- :upgrades_enabled: Whether to upgrade or downgrade the Tentacle version if the windows installer version does not match what is provided in the resource. (Defaults to True)\n- :server: Url to Octopus Deploy Server (e.g https://octopus.example.com)\n- :api_key: Api Key used to register Tentacle to Octopus Server\n- :roles: Array of roles to apply to Tentacle when registering with Octopus Deploy Server (e.g [\"web-server\",\"app-server\"])\n- :environment: Which environment or environments the Tentacle will become part of when registering with Octopus Deploy Server (Defaults to node.chef_environment). Accepts string or array.\n- :forced_registration: Whether the command should include `--force` to support overwriting tentacle references that already exist in Octopus Server\n- :tenants: Optional array of tenants to add to the Tentacle. Tenant must already exist on Octopus Deploy Server. Requires Octopus 3.4\n- :tenant_tags: Optional array of tenant tags to add to the Tentacle. Tags must already exist on Octopus Deploy Server. If tag is part of a tag group, include the group name followed by a slash `\u003cgroupname\u003e/\u003ctag\u003e`. e.g ( Priority/VIP, Datacenter/US ).. Requires Octopus 3.4\n- :tentacle_name: Optional custom name for Tentacle. Defaults to the Chef node name\n- :service_user: Optional service user name. Defaults to Local System\n- :service_password: Password for service user\n- :public_dns: Optional DNS/IP value to use when registring with the octopus server. Defaults to node['fqdn']\n- :tenated_deployment_participation: Optional type of deployments allowed [:Untenanted, :Tenanted, :TenantedOrUntenanted] (requires tentacle 3.19.0 or newer)\n\n#### Examples\n\n##### Install version 3.2.24 of Octopus Deploy Tentacle\n\nThis will simply install the version of the Tentacle that is specified.\n\n```ruby\noctopus_deploy_tentacle 'Tentacle' do\n  action :install\n  version '3.2.24'\n  checksum '147f84241c912da1c8fceaa6bda6c9baf980a77e55e61537880238feb3b7000a'\nend\n```\n\n##### Install version 3.2.24 of Octopus Deploy Tentacle and configure it\n\nThis will install the Tentacle and then configure the Tentacle on the machine to communicate with the Octopus Deploy server.  It can also update firewall rules if enabled.\n\n```ruby\noctopus_deploy_tentacle 'Tentacle' do\n  action [:install, :configure]\n  version '3.2.24'\n  checksum '147f84241c912da1c8fceaa6bda6c9baf980a77e55e61537880238feb3b7000a'\n  trusted_cert 'b5b7ea6537852fb5b7ea6537852f3428'\n  # You can enable this resource to update firewall rules as well\n  configure_firewall true\nend\n```\n\n##### Register Listening Tentacle with the Octopus Deploy Server\n\nThis will check if the Tentacle is registered on the Octopus Deploy server and if it is not will register the Tentacle in the environment with the tags that are specified.\n\n```ruby\n# You will first need to generate an api key\n# In Octopus Deploy Server GUI click your Name -\u003e Profile -\u003e API keys\noctopus_deploy_tentacle 'Tentacle' do\n  action :register\n  server 'https://octopus.example.com'\n  api_key '12345678910'\n  roles ['database']\n  # You can set polling to true for a polling Tentacle setup\n  # polling true\nend\n```\n\n\n### octopus_deploy_tools\n#### Actions\n- :install: Install a version of Octopus Deploy tools (Default)\n\n#### Attribute Parameters\n- :path: The Octopus Deploy tools directory (Defaults to C:\\Octopus)\n- :source: Required. The url to download the tools from\n- :checksum: The SHA256 checksum of the Octopus Deploy tools zip file to verify download\n\n#### Examples\n\n##### Install version 4.5.1 of Octopus Deploy tools\n\nThis will simply install the version of the tools that is specified to the `C:\\fun` folder\n\n```ruby\noctopus_deploy_tools 'C:\\fun' do\n  action :install\n  source 'https://download.octopusdeploy.com/octopus-tools/4.5.1/OctopusTools.4.5.1.zip'\n  checksum 'd6794027d413764e7a892547fba9ed410bfa0a53425b178f628128d2b1aebb5f' # sha256 checksum\nend\n```\n\n\n## Assumptions\n\nOne major assumption of this cookbook is that you already have .net40 installed on your server.  If you do not then you might need to do that before this cookbook. In addition, some of the resources in here require Chef version 12 in order to work.\n\n\n## Known Issues\nThis does not work with Octopus Deploy versions less than 3.2.3 because of a bug in [exporting Tentacle certificates](https://github.com/OctopusDeploy/Issues/issues/2143)\n\nTentacle roles are only used the first time a Tentacle is registered with an Octopus Deploy Server. Updating Tentacle roles in cookbook will not update roles on Octopus Deploy Server.\n\nRegistering multiple Tentacles on the same machine is not supported.\n\nSwitching Tentacle modes between 'polling' \u0026 'listening' is not currently supported.\n\n\nLicense and Author\n==================\n\n* Author:: Brent Montague (\u003cbmontague@cvent.com\u003e)\n\nCopyright:: 2015, Cvent, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\nPlease refer to the [license](LICENSE) file for more license information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvent%2Foctopus-deploy-cookbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcvent%2Foctopus-deploy-cookbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvent%2Foctopus-deploy-cookbook/lists"}