1
0
mirror of https://github.com/gryf/boxpy.git synced 2025-12-28 21:02:26 +01:00

Update readme file.

This commit is contained in:
2021-06-04 18:54:56 +02:00
parent 1a058a1e2a
commit e8264c5c69

View File

@@ -2,19 +2,16 @@
box.py
======
Box.py is a simple automation tool meant to run Ubuntu cloud image on top of
VirtualBox.
Box.py is a simple automation tool meant to run Ubuntu or Fedora cloud images
on top of VirtualBox.
What it does is simply download official cloud image for Ubuntu server, set up
VM, tweak it up and do the initial pre-configuration using generated config
drive.
What it does is simply download official cloud image, set up VM, tweak it up
and do the initial pre-configuration using generated config drive.
I've wrote this little tool just to not click myself to death using web browser
for downloading cloud images, and going through VirtualBox GUI (or figuring out
weird named options for ``vboxmanage`` ;P)
Perhaps other distros would be supported in the future.
Requirements
------------
@@ -108,6 +105,23 @@ with the real value of public key. Every ``$`` sign, especially in
will become a ``$$``. Perhaps I'll change the approach for writing ssh key,
since that's a little bit annoying.
For that reason, a little improvement has been done, so now its possible to
pass filenames to the custom config, instead of filling up
``write_files.contents``:
.. code:: yaml
write_files:
- path: /opt/somefile.txt
permissions: '0644'
filename: /path/to/local/file.txt
during processing this file, boxpy will look for ``filename`` key in the yaml
file for the ``write_files`` sections, and it will remove that key read the
file and put its contents under ``content`` key. What is more important, that
will be done after template processing, so that there will be no interference
for possible ``$`` characters.
What is more interesting is the fact, that you could use whatever cloud-init
accepts, and a special section, for keeping configuration, so that you don't
need to provide all the option every time you boot up similar VM. For example: