How to customize appliance
Note: This is a DRAFT.
If you need a specialized and not a minimal appliance (common case). You can add packages and/or appliances you want. Let's prepare a bare minimum appliance definition file. The only required section is name. Of course to have a working appliance you have to specify some packages too.
Edit your appliance definition file (
your-appliance-appliance.appl) and add packages section like this:
name: my-appliance-name summary: One sentence description of your appliance packages: - httpd - gcc - mc
You can add as many packages as you want. There is implemented dependency tracking, so don't worry about dependencies, just put there packages you want.
Note: formatting is like: two spaces, minus sign, space, package name!
If you could add only packages to appliance this would be boring (and too simple for us). You can add appliances too!
name: my-appliance-name summary: One sentence description of your appliance appliances: - jeos - another-appliance
Note: format is same as with packages.
How is it working? We get all informations from both (or more) specified appliances and merge this into one.
How about mixing everything?
Yes, it's true - you can mix packages with appliances:
name: my-appliance-name summary: One sentence description of your appliance packages: - httpd - gcc - mc appliances: - jeos - another-appliance
Adding external repositories
Say you want to add packages to your appliance from other (not default) repositories. You can add these repositories to your .appl file, and then simply add required package name in packages section.
Sample external repository:
name: my-appliance-name summary: One sentence description of your appliance repos: - name: external-repo baseurl: http://somehost/repo/ packages: - httpd - gcc - mc - package-from-external-repo appliances: - jeos
Parameters in appliance definitions
There are several parameters you can use in .appl files. Take a look at appliance definition parameters.
Need more detailed information?
Please refer to appliance defintion structure description.