https://github.com/antoinemartin/alpine-openstack-vm
Alpine Openstack Virtual Machine
https://github.com/antoinemartin/alpine-openstack-vm
alpine-linux openstack virtualization
Last synced: about 1 year ago
JSON representation
Alpine Openstack Virtual Machine
- Host: GitHub
- URL: https://github.com/antoinemartin/alpine-openstack-vm
- Owner: antoinemartin
- License: apache-2.0
- Created: 2022-02-07T12:48:21.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-16T21:24:31.000Z (about 1 year ago)
- Last Synced: 2025-04-30T10:43:56.487Z (about 1 year ago)
- Topics: alpine-linux, openstack, virtualization
- Language: Shell
- Homepage:
- Size: 62.5 KB
- Stars: 1
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Alpine Openstack Virtual Machine
This project helps creating an [Alpine] based Openstack image.
It uses The [alpine-make-vm-image] script to build a disk image in QCOW2 format.
This image can then be uploaded to an openstack project with the following
command:
```console
> openstack --os-cloud mycloud image create --disk-format qcow2 --file alpine-openstack.qcow2 alpine-openstack
```
And a corresponding server can be created with:
```console
openstack --os-cloud mycloud server create --key-name mykey --image alpine-openstack --flavor myflavor alpine
```
The [terraform](./terraform) directory contains a sample terraform module using
the image to spawn a VM and create a DNS entry for it. It targets the french
Openstack cloud provider [OVHcloud].
## Hyper-V image
Along with each qcow2 image in each release there is also a vhdx version of the
image that can be started with Hyper-V on Windows. Its name is
`alpine-openstack.vhdx`.
To be able to run it on Windows without a metadata service, a small
[NoCloud](https://cloudinit.readthedocs.io/en/18.4/topics/datasources/nocloud.html) ISO
image `seed.iso` is provided. It allows connecting to the VM through SSH with
the password `passw0rd` (username `alpine`).
You can create the VM with:
```powershell
PS> Resize-VHD -Path .\alpine-openstack.vhdx -SizeBytes 20GB
PS> New-VM -Name debug -MemoryStartupBytes 2GB -Path . -BootDevice VHD -VHDPath .\alpine-openstack.vhdx -SwitchName "Default Switch" -Generation 1
PS> Set-VMDvdDrive -VMName debug -Path .\seed.iso
PS> Start-VM debug
PS> Get-NetNeighbor -State Reachable -LinkLayerAddress 00-15-5d-*
ifIndex IPAddress LinkLayerAddress State PolicyStore
------- --------- ---------------- ----- -----------
60 172.26.131.90 00-15-5D-25-01-8D Reachable ActiveStore
29 172.20.64.204 00-15-5D-00-3F-28 Permanent ActiveStore
PS> ssh alpine@172.20.64.204
alpine@172.20.64.204 password:
Welcome to Alpine!
The Alpine Wiki contains a large amount of how-to guides and general
information about administrating Alpine systems.
See .
You can setup the system with the command: setup-alpine
You may change this message by editing /etc/motd.
➜ ~ exit
PS>
```
More information on [this blog post](https://mrtn.me/posts/2023/01/13/debugging-a-failing-openstack-image/).
[alpine]: https://alpinelinux.org/
[alpine-make-vm-image]: https://github.com/alpinelinux/alpine-make-vm-image
[ovhcloud]: https://www.ovhcloud.com/fr/