# DistributedApplicationBuilder

- Module: [Aspire.Hosting](/reference/api/go/aspire.hosting.md)
- Version: `17.0.0`
- Kind: `interface`
- Source: [GitHub](https://github.com/microsoft/aspire/tree/bcfa151cdca6d0a573f22d5d9c23f9c727cb3b2f)

A builder for creating instances of `DistributedApplication`.

## Definition

```go
type DistributedApplicationBuilder interface{}
```

## Properties

- `AppHostDirectory`: `string` `get` -- Directory of the project where the AppHost is located. Defaults to the content root if there's no project.
- `Environment`: [`HostEnvironment`](/reference/api/go/aspire.hosting/hostenvironment.md) `get` -- Gets the Environment property
- `Eventing`: [`DistributedApplicationEventing`](/reference/api/go/aspire.hosting/distributedapplicationeventing.md) `get` -- Eventing infrastructure for AppHost lifecycle.
- `ExecutionContext`: [`DistributedApplicationExecutionContext`](/reference/api/go/aspire.hosting/distributedapplicationexecutioncontext.md) `get` -- Execution context for this invocation of the AppHost.
- `Pipeline`: [`DistributedApplicationPipeline`](/reference/api/go/aspire.hosting/distributedapplicationpipeline.md) `get` -- Gets the deployment pipeline for this distributed application.
- `UserSecretsManager`: [`UserSecretsManager`](/reference/api/go/aspire.hosting/usersecretsmanager.md) `get` -- Gets the service for managing user secrets.

## Methods

- [AddConnectionString](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addconnectionstring.md) -- `method` -- Adds a connection string resource
  ```go
  AddConnectionString(name string, options ...*AddConnectionStringOptions) ResourceWithConnectionString
  ```
- [AddContainer](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addcontainer.md) -- `method` -- Adds a container resource to the application.
  ```go
  AddContainer(name string, image any) ContainerResource
  ```
- [AddContainerRegistry](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addcontainerregistry.md) -- `method` -- Adds a container registry resource
  ```go
  AddContainerRegistry(name string, endpoint any, options ...*AddContainerRegistryOptions) ContainerRegistryResource
  ```
- [AddCSharpApp](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addcsharpapp.md) -- `method` -- Adds a C# application resource
  ```go
  AddCSharpApp(name string, path string, options ...*AddCSharpAppOptions) CSharpAppResource
  ```
- [AddDockerfile](/reference/api/go/aspire.hosting/distributedapplicationbuilder/adddockerfile.md) -- `method` -- Adds a Dockerfile to the application model that can be treated like a container resource.
  ```go
  AddDockerfile(name string, contextPath string, options ...*AddDockerfileOptions) ContainerResource
  ```
- [AddDockerfileBuilder](/reference/api/go/aspire.hosting/distributedapplicationbuilder/adddockerfilebuilder.md) -- `method` -- Adds a container resource built from a programmatically generated Dockerfile
  ```go
  AddDockerfileBuilder(name string, contextPath string, callback func(arg DockerfileBuilderCallbackContext), options ...*AddDockerfileBuilderOptions) ContainerResource
  ```
- [AddDockerfileFactory](/reference/api/go/aspire.hosting/distributedapplicationbuilder/adddockerfilefactory.md) -- `method` -- Adds a Dockerfile to the application model that can be treated like a container resource, with the Dockerfile content generated by an asynchronous factory function.
  ```go
  AddDockerfileFactory(name string, contextPath string, dockerfileFactory func(arg DockerfileFactoryContext) string, options ...*AddDockerfileFactoryOptions) ContainerResource
  ```
- [AddDotnetTool](/reference/api/go/aspire.hosting/distributedapplicationbuilder/adddotnettool.md) -- `method` -- Adds a .NET tool resource to the application model.
  ```go
  AddDotnetTool(name string, packageId string) DotnetToolResource
  ```
- [AddEventingSubscriber](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addeventingsubscriber.md) -- `method` -- Adds an ATS-friendly eventing subscriber callback to the distributed-application builder.
  ```go
  AddEventingSubscriber(subscribe func(arg EventingSubscriberRegistrationContext)) error
  ```
- [AddExecutable](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addexecutable.md) -- `method` -- Adds an executable resource to the application model.
  ```go
  AddExecutable(name string, command string, workingDirectory string, args []string) ExecutableResource
  ```
- [AddExternalService](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addexternalservice.md) -- `method` -- Adds an external service resource
  ```go
  AddExternalService(name string, url any) ExternalServiceResource
  ```
- [AddHealthCheck](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addhealthcheck.md) -- `method` -- Adds a custom health check callback to the distributed-application builder.
  ```go
  AddHealthCheck(name string, check func(...any) *HealthCheckResult) error
  ```
- [AddParameter](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addparameter.md) -- `method` -- Adds a parameter resource
  ```go
  AddParameter(name string, options ...*AddParameterOptions) ParameterResource
  ```
- [AddParameterFromConfiguration](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addparameterfromconfiguration.md) -- `method` -- Adds a parameter resource to the application, with a value coming from configuration.
  ```go
  AddParameterFromConfiguration(name string, configurationKey string, options ...*AddParameterFromConfigurationOptions) ParameterResource
  ```
- [AddParameterWithGeneratedValue](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addparameterwithgeneratedvalue.md) -- `method` -- Adds a parameter with a generated default value
  ```go
  AddParameterWithGeneratedValue(name string, value *GenerateParameterDefault, options ...*AddParameterWithGeneratedValueOptions) ParameterResource
  ```
- [AddProject](/reference/api/go/aspire.hosting/distributedapplicationbuilder/addproject.md) -- `method` -- Adds a .NET project resource
  ```go
  AddProject(name string, projectPath string, options ...*AddProjectOptions) ProjectResource
  ```
- [Build](/reference/api/go/aspire.hosting/distributedapplicationbuilder/build.md) -- `method` -- Builds the distributed application
  ```go
  Build() (DistributedApplication, error)
  ```
- [GetConfiguration](/reference/api/go/aspire.hosting/distributedapplicationbuilder/getconfiguration.md) -- `method` -- Gets the application configuration.
  ```go
  GetConfiguration() Configuration
  ```
- [SubscribeAfterPublish](/reference/api/go/aspire.hosting/distributedapplicationbuilder/subscribeafterpublish.md) -- `method` -- Subscribes to the AfterPublish event, which fires after the application is published.
  ```go
  SubscribeAfterPublish(callback func(arg AfterPublishEvent)) DistributedApplicationEventSubscription
  ```
- [SubscribeAfterResourcesCreated](/reference/api/go/aspire.hosting/distributedapplicationbuilder/subscribeafterresourcescreated.md) -- `method` -- Subscribes to the AfterResourcesCreated event, which fires after all resources are created.
  ```go
  SubscribeAfterResourcesCreated(callback func(arg AfterResourcesCreatedEvent)) DistributedApplicationEventSubscription
  ```
- [SubscribeBeforePublish](/reference/api/go/aspire.hosting/distributedapplicationbuilder/subscribebeforepublish.md) -- `method` -- Subscribes to the BeforePublish event, which fires before the application is published.
  ```go
  SubscribeBeforePublish(callback func(arg BeforePublishEvent)) DistributedApplicationEventSubscription
  ```
- [SubscribeBeforeStart](/reference/api/go/aspire.hosting/distributedapplicationbuilder/subscribebeforestart.md) -- `method` -- Subscribes to the BeforeStart event, which fires before the application starts.
  ```go
  SubscribeBeforeStart(callback func(arg BeforeStartEvent)) DistributedApplicationEventSubscription
  ```
- [TryAddEventingSubscriber](/reference/api/go/aspire.hosting/distributedapplicationbuilder/tryaddeventingsubscriber.md) -- `method` -- Attempts to add an ATS-friendly eventing subscriber callback to the distributed-application builder.
  ```go
  TryAddEventingSubscriber(subscribe func(arg EventingSubscriberRegistrationContext)) error
  ```
- [WithOutputDiffing](/reference/api/go/aspire.hosting/distributedapplicationbuilder/withoutputdiffing.md) -- `method` -- Adds an opt-in target that checks for stale generated pipeline output.
  ```go
  WithOutputDiffing(options ...*WithOutputDiffingOptions) DistributedApplicationBuilder
  ```

## Applies to

- [`DistributedApplicationBuilder`](/reference/api/go/aspire.hosting/distributedapplicationbuilder.md)
