compose: add command (#4527)

`add` command that adds resource configuration to `azure.yaml`.

In this experience, users are able to proceed with running `provision` or `up` after committing the `azure.yaml` change.

Contributes to #4397,  Azure/azure-dev-pr#1682

.vscode/cspell-github-user-aliases.txt

@@ -27,6 +27,7 @@ otiai10
 pamelafox
 pbnj
 sebastianmattar
+sergi
 sethvargo
 stretchr
 theckman

cli/azd/.vscode/cspell-azd-dictionary.txt

@@ -86,6 +86,7 @@ devcenters
 devcentersdk
 devdeviceid
 devel
+diffmatchpatch
 discarder
 docf
 dockerfiles
@@ -94,6 +95,7 @@ doublestar
 dskip
 eastus
 endregion
+entra
 entraid
 envlist
 envname
@@ -192,6 +194,7 @@ semconv
 serverfarms
 servicebus
 setenvs
+skus
 snapshotter
 springapp
 sqlserver

cli/azd/cmd/root.go

@@ -21,6 +21,7 @@ import (
 
 	"github.com/azure/azure-dev/cli/azd/internal"
 	"github.com/azure/azure-dev/cli/azd/internal/cmd"
+	"github.com/azure/azure-dev/cli/azd/internal/cmd/add"
 	"github.com/azure/azure-dev/cli/azd/internal/telemetry"
 	"github.com/azure/azure-dev/cli/azd/pkg/output"
 	"github.com/spf13/cobra"
@@ -320,6 +321,11 @@ func NewRootCmd(
 			},
 		}).
 		UseMiddleware("hooks", middleware.NewHooksMiddleware)
+	root.
+		Add("add", &actions.ActionDescriptorOptions{
+			Command:        add.NewAddCmd(),
+			ActionResolver: add.NewAddAction,
+		})
 
 	// Register any global middleware defined by the caller
 	if len(middlewareChain) > 0 {

cli/azd/cmd/testdata/TestUsage-azd-add.snap

@@ -0,0 +1,18 @@
+
+Add a component to your project. (Alpha)
+
+Usage
+  azd add [flags]
+
+Flags
+        --docs 	: Opens the documentation for azd add in your web browser.
+    -h, --help 	: Gets help for add.
+
+Global Flags
+    -C, --cwd string 	: Sets the current working directory.
+        --debug      	: Enables debugging and diagnostics logging.
+        --no-prompt  	: Accepts the default value instead of prompting, or it fails if there is no default.
+
+Find a bug? Want to let us know how we're doing? Fill out this brief survey: https://aka.ms/azure-dev/hats.
+
+

cli/azd/internal/appdetect/appdetect.go

@@ -265,7 +265,7 @@ func detectAny(ctx context.Context, detectors []projectDetector, path string, en
 			log.Printf("Found project %s at %s", project.Language, path)
 
 			// docker is an optional property of a project, and thus is different than other detectors
-			docker, err := detectDocker(path, entries)
+			docker, err := detectDockerInDirectory(path, entries)
 			if err != nil {
 				return nil, fmt.Errorf("detecting docker project: %w", err)
 			}

cli/azd/internal/appdetect/docker.go

@@ -11,18 +11,19 @@ import (
 	"strings"
 )
 
-func detectDocker(path string, entries []fs.DirEntry) (*Docker, error) {
+func detectDockerInDirectory(path string, entries []fs.DirEntry) (*Docker, error) {
 	for _, entry := range entries {
 		if strings.ToLower(entry.Name()) == "dockerfile" {
 			dockerFilePath := filepath.Join(path, entry.Name())
-			return detectDockerFromFile(dockerFilePath)
+			return AnalyzeDocker(dockerFilePath)
 		}
 	}
 
 	return nil, nil
 }
 
-func detectDockerFromFile(dockerFilePath string) (*Docker, error) {
+// AnalyzeDocker analyzes the Dockerfile and returns the Docker result.
+func AnalyzeDocker(dockerFilePath string) (*Docker, error) {
 	file, err := os.Open(dockerFilePath)
 	if err != nil {
 		return nil, fmt.Errorf("reading Dockerfile at %s: %w", dockerFilePath, err)

cli/azd/internal/appdetect/docker_test.go

@@ -1,11 +1,12 @@
 package appdetect
 
 import (
-	"github.com/azure/azure-dev/cli/azd/pkg/osutil"
-	"github.com/stretchr/testify/assert"
 	"os"
 	"path/filepath"
 	"testing"
+
+	"github.com/azure/azure-dev/cli/azd/pkg/osutil"
+	"github.com/stretchr/testify/assert"
 )
 
 func TestParsePortsInLine(t *testing.T) {
@@ -28,7 +29,7 @@ func TestParsePortsInLine(t *testing.T) {
 	}
 }
 
-func TestDetectDockerFromFile(t *testing.T) {
+func TestAnalyzeDockerFromFile(t *testing.T) {
 	tests := []struct {
 		dockerFileContent string
 		expectedPorts     []Port
@@ -52,7 +53,7 @@ func TestDetectDockerFromFile(t *testing.T) {
 			err = os.WriteFile(tempFile, []byte(tt.dockerFileContent), osutil.PermissionFile)
 			assert.NoError(t, err)
 
-			docker, err := detectDockerFromFile(tempFile)
+			docker, err := AnalyzeDocker(tempFile)
 			assert.NoError(t, err)
 			actual := docker.Ports
 			assert.Equal(t, tt.expectedPorts, actual)