{"id":19601498,"url":"https://github.com/stackstorm/packer-st2","last_synced_at":"2025-06-29T03:38:14.981Z","repository":{"id":32121773,"uuid":"110024552","full_name":"StackStorm/packer-st2","owner":"StackStorm","description":"Packer templates for building \u0026 deploying Vagrant \u0026 OVA with StackStorm installed","archived":false,"fork":false,"pushed_at":"2023-12-13T20:15:59.000Z","size":293,"stargazers_count":14,"open_issues_count":11,"forks_count":7,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-05T01:32:27.165Z","etag":null,"topics":["inspec","ova","packer-template","st2","stackstorm","vagrant","vagrant-boxes","virtual-appliance","virtualbox"],"latest_commit_sha":null,"homepage":"https://app.vagrantup.com/stackstorm/boxes/st2","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/StackStorm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"community_bridge":"stackstorm"}},"created_at":"2017-11-08T20:04:35.000Z","updated_at":"2024-09-22T02:09:14.000Z","dependencies_parsed_at":"2023-02-15T10:05:24.373Z","dependency_job_id":null,"html_url":"https://github.com/StackStorm/packer-st2","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/StackStorm/packer-st2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StackStorm%2Fpacker-st2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StackStorm%2Fpacker-st2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StackStorm%2Fpacker-st2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StackStorm%2Fpacker-st2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StackStorm","download_url":"https://codeload.github.com/StackStorm/packer-st2/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StackStorm%2Fpacker-st2/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262528521,"owners_count":23324571,"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":["inspec","ova","packer-template","st2","stackstorm","vagrant","vagrant-boxes","virtual-appliance","virtualbox"],"created_at":"2024-11-11T09:18:38.838Z","updated_at":"2025-06-29T03:38:14.955Z","avatar_url":"https://github.com/StackStorm.png","language":"Ruby","readme":"# StackStorm Vagrant \u0026 OVA\n\n[![Latest Build](https://github.com/StackStorm/packer-st2/actions/workflows/packer-build.yml/badge.svg?branch=master)](https://github.com/StackStorm/packer-st2/actions/workflows/packer-build.yml)\n[![Latest Release](https://img.shields.io/github/release/StackStorm/packer-st2/all.svg)](https://github.com/StackStorm/packer-st2/releases)\n[![Download from Vagrant Cloud](https://img.shields.io/badge/Vagrant-cloud%20%E2%86%92-1563ff.svg)](https://app.vagrantup.com/stackstorm/boxes/st2/)\n\n[Packer](https://www.packer.io/intro/index.html) templates with [InSpec](https://www.inspec.io/) integration tests for building Vagrant box \u0026 OVA image with [StackStorm](https://github.com/stackstorm/st2) community installed.\nFully tested and packaged artifacts are produced during the build pipeline.\n\n\n## Usage\n### Vagrant Quick Start\nStarting a Vagrant VM is easy:\n```\nvagrant init stackstorm/st2\nvagrant up\nvagrant ssh\n```\n\n### Updating the Vagrant box\nOnce we release a newer version, Vagrant will warn you about the available update. To update the box:\n```\nvagrant box outdated\nvagrant box remove stackstorm/st2\nvagrant up\n```\n\n### OVA Virtual Appliance\nVirtual appliance is available for download as `.OVA` image from the [Github Releases](https://github.com/StackStorm/packer-st2/releases) page.\u003cbr\u003e\n\u003e _Linux login credentials:_\u003cbr\u003e\n\u003e Username: `vagrant`\u003cbr\u003e\n\u003e Password: `vagrant`\n\u003e\n\u003e _StackStorm login details:_\u003cbr\u003e\n\u003e Username: `st2admin`\u003cbr\u003e\n\u003e Password: `Ch@ngeMe`\n\nAt the moment only Virtualbox provider is supported. VMWare-compatible virtual appliance is available with [StackStorm Enterprise (EWC)](https://stackstorm.com/#product) image. Ask [StackStorm Support](mailto:support@stackstorm.com) for more info.\n\n### `st2-integration-tests`\nSometimes StackStorm does not run properly for some reason.\u003cbr\u003e\nDiscovering why at a infra level is the responsibility of `st2-integration-tests` which will perform StackStorm InSpec Tests and report back with more detailed info.\u003cbr\u003e\nThis can save time for both user \u0026 engineering team to avoid extensive troubleshooting steps.\n\nIf something went wrong, - just run `st2-integration-tests`!\n\n\n## Building Vagrant \u0026 OVA\n### Requirements\nThe following tools are required for the build process:\n- Virtualbox - https://www.virtualbox.org/wiki/Downloads\n- Packer - https://www.packer.io/downloads.html (`make install-packer`)\n\n### Build Steps\n* Run Packer via `make build`\n\nThe Packer build process will import `Ubuntu 18.04 Bionic Server` iso image in Virtualbox, bootstrap Ubuntu server with all the required settings (automating typical iso live CD install steps),\ninstall \u0026 configure StackStorm and finally export both the Vagrant box and .OVA image into the [`/builds`](/builds) directory.\n\u003e See [`st2.json`](/st2.json) which codifies Packer build pipeline and could be used as a source of entire automation logic.\n\n### Build params\nThere are environment variables you can pass to control the StackStorm version and box/image version.\n- `ST2_VERSION` - `x.y.z` format, like `2.7.1` (default: latest st2 version)\n- `BOX_VERSION` - `YYYYMMDD` format, like `20180131` (default: today's date in UTC)\n\nAs a result, Packer will generate the box with version `v2.7.1-20180131`.\n\n## Testing\n[`/test`](/test) directory contains Integration tests, powered by [InSpec.io](https://www.inspec.io/) Infrastructure Testing framework.\nTests are performed at the end of the Packer build pipeline after entire installation and configuration. They ensure that custom OS Linux-level modifications are in place and StackStorm was really deployed, works correctly and alive with other services it relies on like RabbitMQ, MongoDB.\nTo make testing close to a real-world scenario, an additional VM reboot step in the build pipeline is performed before running the actual integration tests.\n\n\u003e Please don't forget to include respective tests for every new critical feature of the system!\u003cbr\u003e\n\u003e See https://www.inspec.io/docs/reference/dsl_inspec/ and existing `/tests` examples which makes easy to add more tests.\n","funding_links":["https://funding.communitybridge.org/projects/stackstorm"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackstorm%2Fpacker-st2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackstorm%2Fpacker-st2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackstorm%2Fpacker-st2/lists"}