feat: add commands (#5)

Author: reubeno

.github/copilot-instructions.md

@@ -1,4 +1,4 @@
-# azure-linux-dev-tools
+# azldev-preview - AZL Dev Tool Preview
 
 Follow the existing code style and conventions for similar code. Refer to all of the documents listed below:
 - [CONTRIBUTING.md](../CONTRIBUTING.md) for general human and AI agent guidelines.

.pipelines/buildtools/download_tool.yml

@@ -0,0 +1,43 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+name: Download azldev tool
+trigger: none
+
+resources:
+  repositories:
+    - repository: templates
+      type: git
+      name: OneBranch.Pipelines/GovernedTemplates
+      ref: refs/heads/main
+
+variables:
+  - group: "Agent pools (DEV)"
+
+extends:
+  template: v2/OneBranch.NonOfficial.CrossPlat.yml@templates
+  parameters:
+    featureFlags:
+      runOnHost: true
+    stages:
+    - stage: DownloadStage
+      jobs:
+        - job: DownloadJob
+          strategy:
+            matrix:
+              x86_64:
+                poolName: $(DEV_AMD64_Managed_AZL3)
+                arch: 'x86_64'
+              aarch64:
+                poolName: $(DEV_ARM64_Managed_AZL3)
+                arch: 'aarch64'
+          pool:
+            type: linux
+            name: $(poolName)
+          variables:
+            ob_outputDirectory: '$(Build.SourcesDirectory)/ToBePublished'
+            ob_artifactBaseName: 'drop_download_$(arch)_$(System.JobAttempt)'
+          steps:
+          - template: templates/azldev_download_use_job.yml@self
+            parameters:
+              arch: '$(arch)'

.pipelines/buildtools/publish_tool.yml

@@ -0,0 +1,44 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+name: Build azldev tool
+trigger: none
+
+resources:
+  repositories:
+    - repository: templates
+      type: git
+      name: OneBranch.Pipelines/GovernedTemplates
+      ref: refs/heads/main
+
+variables:
+  - group: "Agent pools (DEV)"
+
+extends:
+  template: v2/OneBranch.NonOfficial.CrossPlat.yml@templates
+  parameters:
+    featureFlags:
+      runOnHost: true
+    stages:
+    - stage: BuildStage
+      jobs:
+        - job: BuildJob
+          strategy:
+            matrix:
+              x86_64:
+                poolName: $(DEV_AMD64_Managed_AZL3)
+                arch: 'x86_64'
+              aarch64:
+                poolName: $(DEV_ARM64_Managed_AZL3)
+                arch: 'aarch64'
+          pool:
+            type: linux
+            name: $(poolName)
+          variables:
+            ob_outputDirectory: '$(Build.SourcesDirectory)/ToBePublished'
+            ob_artifactBaseName: 'drop_publish_$(arch)_$(System.JobAttempt)'
+          steps:
+          - template: templates/azldev_build_publish_job.yml@self
+            parameters:
+              arch: '$(arch)'
+              publish_path: '$(ob_outputDirectory)/tool'

cmd/azldev/azldev.go

@@ -7,8 +7,12 @@ import (
 	"os"
 
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev"
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/advanced"
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/component"
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/config"
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/docs"
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/image"
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/project"
 	"github.com/microsoft/azure-linux-dev-tools/internal/app/azldev/cmds/version"
 )
 
@@ -29,8 +33,12 @@ func InstantiateApp() *azldev.App {
 
 	// Give top level command packages an opportunity to register their commands (or in some cases,
 	// request post-init callbacks).
+	advanced.OnAppInit(app)
+	component.OnAppInit(app)
 	config.OnAppInit(app)
 	docs.OnAppInit(app)
+	image.OnAppInit(app)
+	project.OnAppInit(app)
 	version.OnAppInit(app)
 
 	return app

cmd/azldev/azldev_test.go

@@ -22,8 +22,12 @@ func TestInstantiateApp(t *testing.T) {
 			t,
 			topLevelCommandNames,
 			[]string{
+				"advanced",
+				"component",
 				"config",
 				"docs",
+				"image",
+				"project",
 				"version",
 			},
 		)

cmd/helloworld/helloworld.go

@@ -0,0 +1,15 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// The helloworld program is a simple example that prints "Hello, World!" to the console.
+
+package main
+
+import (
+	"github.com/microsoft/azure-linux-dev-tools/internal/app/helloworld"
+)
+
+func main() {
+	helloworld.Hello()
+	helloworld.Goodbye()
+}

docs/developer/how-to/config-management.md

@@ -0,0 +1,38 @@
+# Ideas for future consideration
+
+## Package building
+
+### Parameterized components
+
+A single component can be defined to be built with a matrix of parameters, where each set of parameters results in a different "flavour" of the component being built.
+
+Sample use cases:
+
+- Building different configurations of the kernel.
+- Building a bootstrap and full version of a component to resolve circular dependencies.
+
+### One project can define and build different versions of the kernel
+
+### OOT module components can build with all or selected versions of the kernels
+
+Components providing OOT kernel modules must have a way to build against all supported kernel versions or a specific subset of them.
+
+**IMPORTANT:** it must be possible to define OOT components in such way, that packages built for a newer kernel version are **NOT** considered as updates of the ones built for the older kernel versions. This is required, so that updating the OOT components does not inadvertently update the kernel as well due to the package's dependency on a specific kernel version.
+
+Example:
+
+- Project defines `kernel-older` version 1.0.0 and `kernel-newer` version 1.1.0.
+- Project builds `OOT-comp` for both kernels.
+- Having the package manager update `OOT-comp` on `kernel-older` does not automatically update to `kernel-newer`.
+
+Effectively this means that the `OOT-comp` packages defined for both kernels are not considered the same package by the package manager/RPM.
+
+## Supported origins for component sources
+
+### Fedora SRPM repos
+
+### Blob stores with anonymous access
+
+### Azure blob stores requiring authentication
+
+For such blob stores, the tool should at minimum be able to use the credentials set by logging into Azure with `az login`.

docs/developer/how-to/pull-requests.md

@@ -1,7 +1,29 @@
 # User Guide
 
+## How-To Guides
+
+- [Create a Project](./how-to/create-project.md) — set up a new Azure Linux project
+- [Add a Component](./how-to/add-component.md) — import or create a new package
+- [Build a Component](./how-to/build-component.md) — build RPMs from component definitions
+- [Build an Image](./how-to/build-image.md) — build and boot Azure Linux images
+
+## Explanation
+
+- [Configuration System](./explanation/config-system.md) — how config files are loaded, merged, and how inheritance works
+
 ## Reference
 
+### Configuration
+
+- [Config File Structure](./reference/config/config-file.md) — root config file layout and includes
+- [Project](./reference/config/project.md) — project metadata and directory configuration
+- [Distros](./reference/config/distros.md) — distro definitions, versions, and repositories
+- [Components](./reference/config/components.md) — component definitions, spec sources, build options, and source files
+- [Overlays](./reference/config/overlays.md) — spec and file overlays for modifying upstream sources
+- [Component Groups](./reference/config/component-groups.md) — grouping components with shared defaults
+- [Images](./reference/config/images.md) — image definitions (VMs, containers)
+- [Tools](./reference/config/tools.md) — external tool configuration
+
 ### CLI Commands
 
 Auto-generated from `azldev --help`. See [reference/cli/](./reference/cli/azldev.md) for per-command documentation.