Add quick start for image creation #583
Conversation
| @@ -0,0 +1,435 @@ | |||
| --- | |||
There was a problem hiding this comment.
We probably don't want people creating images normally. So, I think this should live in how to instead of quick start.
|
|
||
| - [Quick Start](./quick-start/quick-start.md) - A beginner-friendly guide to | ||
| quickly customize an Azure Linux image using Image Customizer | ||
| - [Quick Start - Create](./quick-start/quick-start-create.md) - A guide to creating a new image from scratch using the |
There was a problem hiding this comment.
Remove, since we want people customizing images normally.
|
|
||
| # Creating a New Image from Scratch | ||
|
|
||
| This guide shows how to use the Image Customizer [create subcommand](../api/cli/create.md) to build a new Azure Linux |
There was a problem hiding this comment.
The create command is still a work in progress. So, it would be good to add a warning here.
| This file has the same API as configuration files for the [customize subcommand](../api/cli/customize.md), but must | ||
| contain all the settings needed to create the image from scratch. | ||
|
|
||
| For Azure Linux 2.0, create `$HOME/staging/config-azl2.yaml`: |
There was a problem hiding this comment.
AZL2 is end-of-life at this point. So, let's not add new documentation for it.
| --privileged=true \ | ||
| -v /dev:/dev \ | ||
| -v "$HOME/staging:/mnt/staging:z" \ | ||
| mcr.microsoft.com/azurelinux/imagecustomizer:1.12.0 create \ |
There was a problem hiding this comment.
I would use latest instead of 1.2.0.
| --distro azurelinux \ | ||
| --distro-version 2.0 \ | ||
| --tools-file /mnt/staging/azure-linux-2.0-tools.tar.gz \ | ||
| --rpm-source /mnt/staging/azure-linux-2.0-rpms.repo \ |
There was a problem hiding this comment.
Future: Considering that the user is passing in a distro and distro version, we should probably just have a copy of the repo file and use it by default.
3 participants
This PR also removes
imagecreatorreferences from the documentation.