{"id":15064655,"url":"https://github.com/cabesa-collective/capistrano-asdf","last_synced_at":"2025-04-10T12:41:20.303Z","repository":{"id":59151827,"uuid":"160249311","full_name":"cabesa-collective/capistrano-asdf","owner":"cabesa-collective","description":"ASDF support for Capistrano v3","archived":false,"fork":false,"pushed_at":"2024-01-12T16:34:07.000Z","size":12,"stargazers_count":22,"open_issues_count":2,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T11:21:36.585Z","etag":null,"topics":["asdf","capistrano","ruby-on-rails"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cabesa-collective.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2018-12-03T20:24:58.000Z","updated_at":"2024-10-16T21:35:19.000Z","dependencies_parsed_at":"2024-01-12T22:10:55.111Z","dependency_job_id":null,"html_url":"https://github.com/cabesa-collective/capistrano-asdf","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"a099a63b7cb62c20c8582c0c4c512136c416ac84"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cabesa-collective%2Fcapistrano-asdf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cabesa-collective%2Fcapistrano-asdf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cabesa-collective%2Fcapistrano-asdf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cabesa-collective%2Fcapistrano-asdf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cabesa-collective","download_url":"https://codeload.github.com/cabesa-collective/capistrano-asdf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217156,"owners_count":21066634,"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":["asdf","capistrano","ruby-on-rails"],"created_at":"2024-09-25T00:23:39.081Z","updated_at":"2025-04-10T12:41:20.286Z","avatar_url":"https://github.com/cabesa-collective.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Capistrano::ASDF\n\nASDF support for Capistrano v3:\n\n## Notes\n\n**If you use this integration with capistrano-rails, please ensure that you have `capistrano-bundler \u003e= 1.1.0`.**\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    # Gemfile\n    gem 'capistrano', '~\u003e 3.0'\n    gem 'capistrano-asdf'\n\nAnd then execute:\n\n    $ bundle install\n\n## Usage\n\nRequire in Capfile to use the default task:\n\n    # Capfile\n    require 'capistrano/asdf'\n\nAnd you should be good to go!\n\n## Configuration\n\nEverything *should work* for a basic ASDF setup *out of the box*.\nHowever we strongly encourage you to use the `.tool-versions` for proper tool version selection.\n\nIf you need some special settings, set those in the stage file for your server:\n\n    # deploy.rb or stage file (staging.rb, production.rb or else)\n    set :asdf_custom_path, '~/.my_asdf_installation_path'  # only needed if not '~/.asdf'\n    set :asdf_tools, %w{ ruby }                            # defaults to %{ ruby nodejs }\n    set :asdf_map_ruby_bins, %w{ bundle gem }              # defaults to %w{ rake gem bundle ruby rails }\n    set :asdf_map_nodejs_bins, %w{ node npm }              # defaults to %w{ node npm yarn }\n\n### Custom ASDF path: `:asdf_custom_path`\n\nIf you have a custom ASDF setup with a different path then expected, you have\nto define a custom ASDF path to tell capistrano where it is.\n\n### Custom ASDF tools selection: `:asdf_tools`\n\nIf you don't want to use all the tools available (`ruby` and `nodejs`), you have\nto define which one you want to use.\n\nFor example; if you just want to use ASDF for ruby, you may set `:asdf_tools`:\n\n    set :asdf_tools, %w{ ruby }\n\n### Custom ASDF ruby binaries selection: `:asdf_map_ruby_bins`\n\nIf you want to add or remove which ruby related binaries will be mapped to ASDF ruby installation, you have\nto define which one you want to be mapped.\n\nFor example; if you just want to map `bundle` and `gem` ruby binaries, you may set `:asdf_map_ruby_bins`:\n\n    set :asdf_map_ruby_bins, %w{ bundle gem }\n\n### Custom ASDF nodejs binaries selection: `:asdf_map_nodejs_bins`\n\nIf you want to add or remove which nodejs related binaries will be mapped to ASDF nodejs installation, you have\nto define which one you want to be mapped.\n\nFor example; if you just want to map `node` and `npm` nodejs binaries, you may set `:asdf_map_nodejs_bins`:\n\n    set :asdf_map_nodejs_bins, %w{ node npm }\n\n## Restrictions\n\nCapistrano can't use ASDF to install rubies, nodes or other tools yet.\nSo on the servers you are deploying to, you will have to manually use ASDF to install the\nproper rubies, nodes or other tools.\n\n## How it works\n\nThis gem adds new tasks `asdf:map_*` before `deploy` task.\nIt loads the ASDF tools environment for capistrano when it wants to run\nsome tools related programs like `rake`, `gem`, `bundle`, `node`, `npm` ...\n\n## Generate and upload the ASDF commands wrapper\n\nThe ASDF wrapper is needed to correctly run the mapped commands.\nSince the wrapper is an executable script, it can be used in Systemd units.\n\n    $ cap production asdf:upload_wrapper\n\nThis task is automaticaly called before `asdf:check`\n\n## Install required tools\n\nIf you want your tools (ruby, nodejs) to be installed, you can use the `asdf:install` task to\npreform plugins add and then install of required versions from your `.tool-versions`.\n`asdf:install` will automaticaly add necessary plugins running `asdf:add_plugins`.\nIf you want to change the plugins to install you may set `:asdf_tools` accordingly.\n\n    $ cap production asdf:install\n\n## Check your configuration\n\nIf you want to check your configuration you can use the `asdf:check` task to\nget information about the ASDF version and ruby/nodejs tools which would be used for\ndeployment.\n\n    $ cap production asdf:check\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcabesa-collective%2Fcapistrano-asdf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcabesa-collective%2Fcapistrano-asdf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcabesa-collective%2Fcapistrano-asdf/lists"}