{"id":13492659,"url":"https://github.com/vmware-archive/heist","last_synced_at":"2025-03-28T10:32:44.915Z","repository":{"id":66819886,"uuid":"206128501","full_name":"vmware-archive/heist","owner":"vmware-archive","description":"Ephemeral software tunneling and delivery system","archived":true,"fork":false,"pushed_at":"2020-02-10T21:41:47.000Z","size":188,"stargazers_count":24,"open_issues_count":17,"forks_count":6,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-08-01T19:44:14.236Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vmware-archive.png","metadata":{"files":{"readme":"README.rst","changelog":null,"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}},"created_at":"2019-09-03T16:59:43.000Z","updated_at":"2023-01-28T15:50:11.000Z","dependencies_parsed_at":"2023-07-08T10:00:49.497Z","dependency_job_id":null,"html_url":"https://github.com/vmware-archive/heist","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fheist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fheist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fheist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fheist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vmware-archive","download_url":"https://codeload.github.com/vmware-archive/heist/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222369834,"owners_count":16973287,"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-07-31T19:01:07.990Z","updated_at":"2024-10-31T06:31:27.113Z","avatar_url":"https://github.com/vmware-archive.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"=====\nHeist\n=====\n\nMOVED TO GITLAB\n===============\n\nPOP projects developed by Saltstack are being moved to Gitlab.\n\nThe new location of idem is here:\n\nhttps://gitlab.com/saltstack/pop/heist\n\nIntro\n=====\n\nHeist creates network tunnels for distributing and managing agents. While it has\nbeen originally built to deploy and manage Salt Minions, it can be used to\ndistribute and manage other agents or plugins if extended to do so.\n\nUsing Heist For Salt\n====================\n\nThis tutorial will go over how to set up Heist to manage ephemeral Salt\nMinions. The whole point of Heist is to make deployment and management\nof Salt easy!\n\nBefore you start please be advised that a more detailed quickstart is\navailable in the docs for `heist`.\n\nUsing Heist is very easy, Start by downloading Heist. Just install via\n`pip`:\n\n.. code-block:: bash\n\n    pip install heist\n\nSetting up a Salt Master\n========================\n\nDon't worry, this is a snap!  Once Heist is installed you will need a\nSalt Master to connect to. If you have an existing Salt Master running\nyou can skip this section, just run `heist` on your Salt Master.\n\nDownload the all-in-one Salt binary for Linux or Mac (Windows coming soon!):\n\nFor Linux:\n\n.. code-block:: bash\n\n    wget https://repo.saltstack.com/salt-bin/linux/salt\n\nFor Mac:\n\n.. code-block:: bash\n\n    wget https://repo.saltstack.com/salt-bin/osx/salt\n\nNow you can just run it!\n\n.. code-block:: bash\n\n    chmod +x salt\n    sudo ./salt master\n\nNow you have a running Salt Master to control your minions!\n\nMaking Your Roster\n==================\n\nA Roster is a file used by Heist to map login information to the\nsystems in your environment. This file can be very simple and just\nneeds to tell Heist where your systems are and how to log into them\nvia ssh. Open a file called `roster.cfg` and add the data needed to connect\nto a remote system via ssh:\n\n.. code-block:: yaml\n\n    system_name:\n      host: 192.168.4.4\n      username: fred\n      password: freds_password\n\nThe roster files typically all live inside of a roster directory. But to get\nstarted will will execute a single roster file with `heist`:\n\n.. code-block:: bash\n\n    heist -R roster.cfg\n\nAssuming your roster is correct, heist will now connect to the remote\nsystem, deploy a salt minion, and connect it to your running master! Now you\ncan use the same binary that you started the master with to accept your new\nminion's keys:\n\n.. code-block:: bash\n\n    ./salt key -A\n\nThen give your minion a few seconds to authenticate and then run your first\n`salt` command on the newly set up minion:\n\n.. code-block:: bash\n\n    ./salt \\* test.version\n\nThats it! Now that the minion is up you can run `salt` commands on it at breakneck\nspeed, the full power of Salt is at your fingertips!!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware-archive%2Fheist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvmware-archive%2Fheist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware-archive%2Fheist/lists"}