# AppConfig

Source: /aws/services/appconfig/

AppConfig is a service provided by Amazon Web Services (AWS) that simplifies the process of managing and deploying application configurations.
AppConfig offers centralized management of configuration data and the ability to create, manage, and deploy configuration changes separately.
It allows you to avoid deploying the service repeatedly for smaller changes, enables controlled deployments to applications and includes built-in validation checks & monitoring.

LocalStack allows you to use the AppConfig APIs in your local environment to define configurations for different environments and deploy them to your applications as needed.
The supported APIs are available on our [API Coverage section](#api-coverage), which provides information on the extent of AppConfig's integration with LocalStack.

## Getting started

This guide is designed for users new to AppConfig and assumes basic knowledge of the AWS CLI and our [`lstk aws`](/aws/developer-tools/running-localstack/lstk/cloud-and-iac-commands/#aws) command.

Start your LocalStack container using your preferred method.
We will demonstrate how to create an AppConfig application, environment, configuration profiles & feature flags, and deploy the configuration with the AWS CLI.

### Create an AppConfig application and environment

You can create an AppConfig application using the [`CreateApplication`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_CreateApplication.html) API.
The application is a folder/directory that contains the configuration data for your specific application.
The following command creates an application named `my-app`:

```bash
lstk aws appconfig create-application \
    --name my-app \
    --description "My application"
```

The following output would be retrieved:

```bash
{
    "Id": "400c285",
    "Name": "my-app",
    "Description": "My application"
}
```

You can now create an AppConfig environment for your application using the [`CreateEnvironment`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_CreateEnvironment.html) API.
An environment consists of the deployment group of your AppConfig applications.
The following command creates an environment named `my-app-env`:

```bash
lstk aws appconfig create-environment \
    --application-id 400c285 \
    --name my-app-env \
    --description "My application environment"
```

Replace the `application-id` with the ID of the application you created in the previous step.
The following output would be retrieved:

```bash
{
    "ApplicationId": "400c285",
    "Id": "3695ea3",
    "Name": "my-app-env",
    "Description": "My application environment",
    "State": "ReadyForDeployment"
}
```

### Create configuration profiles and feature flags

You can create an AppConfig configuration profile using the [`CreateConfigurationProfile`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_CreateConfigurationProfile.html) API.
A configuration profile contains for the configurations of your AppConfig applications.
The following command creates a configuration profile named `my-app-config`:

```bash
lstk aws appconfig create-configuration-profile \
    --application-id 400c285 \
    --name my-app-config \
    --location-uri hosted \
    --type AWS.AppConfig.FeatureFlags
```

The following output would be retrieved:

```bash
{
    "ApplicationId": "400c285",
    "Id": "7d748f9",
    "Name": "my-app-config",
    "LocationUri": "hosted",
    "Type": "AWS.AppConfig.FeatureFlags"
}
```

You can now create a JSON file to add your feature flag configuration data.
Create a file named `feature-flag-config.json` with the following content:

```json showshowLineNumbers
{
  "allow_mobile_payments": {
    "enabled": false
  },
  "default_payments_per_region": {
    "enabled": true
  }
}
```

You can now use the [`CreateHostedConfigurationVersion`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_CreateHostedConfigurationVersion.html) API to save your feature flag configuration data to AppConfig.
The following command creates a hosted configuration version for the configuration profile you created in the previous step:

```bash
lstk aws appconfig create-hosted-configuration-version \
    --application-id 400c285 \
    --configuration-profile-id 7d748f9 \
    --content-type "application/json" \
    --content file://feature-flag-config.json \
    configuration-data.json
```

```bash title="Output"
{
    "ApplicationId": "400c285",
    "ConfigurationProfileId": "7d748f9",
    "VersionNumber": 1,
    "ContentType": "application/json"
}
```

### Create an AppConfig deployment

You can now create an AppConfig deployment strategy using the [`CreateDeploymentStrategy`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_CreateDeploymentStrategy.html) API.
A deployment strategy defines important criteria for rolling out your configuration to the target environment.
The following command creates a deployment strategy named `my-app-deployment-strategy`:

```bash
lstk aws appconfig create-deployment-strategy \
    --name my-app-deployment-strategy \
    --description "My application deployment strategy" \
    --deployment-duration-in-minutes 10 \
    --growth-factor 1.0
```

```bash title="Output"
{
    "Id": "f2f2225",
    "Name": "my-app-deployment-strategy",
    "Description": "My application deployment strategy",
    "DeploymentDurationInMinutes": 10,
    "GrowthFactor": 1.0
}
```

You can now use the [`StartDeployment`](https://docs.aws.amazon.com/appconfig/latest/APIReference/API_StartDeployment.html) API to deploy the configuration.
The following command deploys the configuration to the environment you created in the previous step:

```bash
lstk aws appconfig start-deployment \
    --application-id 400c285 \
    --environment-id 3695ea3 \
    --deployment-strategy-id f2f2225 \
    --configuration-profile-id 7d748f9 \
    --configuration-version 1 \
    --description "My application deployment"
```

```bash title="Output"
{
    "ApplicationId": "400c285",
    "EnvironmentId": "3695ea3",
    "DeploymentStrategyId": "f2f2225",
    "ConfigurationProfileId": "7d748f9",
    "DeploymentNumber": 1,
    "ConfigurationName": "my-app-config",
    "ConfigurationLocationUri": "hosted",
    "ConfigurationVersion": "1",
    "Description": "My application deployment",
    "DeploymentDurationInMinutes": 0,
    "GrowthFactor": 1.0,
    "State": "BAKING",
    "EventLog": [
        {
            "EventType": "DEPLOYMENT_STARTED",
            "TriggeredBy": "USER",
            "Description": "Deployment started",
            "OccurredAt": "2023-08-28T11:18:43.273250Z"
        }
    ],
    "PercentageComplete": 0.0,
    "StartedAt": "2023-08-28T11:18:43.273250Z",
    "AppliedExtensions": []
}
```

## Resource Browser

The LocalStack Web Application provides a Resource Browser for managing AppConfig applications.
You can access the Resource Browser by opening the LocalStack Web Application in your browser, navigating to the **Resource Browser** section, and then clicking on **AppConfig** under the **Developer Tools** section.

![AppConfig Resource Browser](/images/aws/appconfig-resource-browser.png)

The Resource Browser allows you to perform the following actions:

- **Create new AppConfig applications**: Create new AppConfig applications by clicking **Create Application** and filling in the required details.
- **View AppConfig applications**: View the list of AppConfig applications created in LocalStack by clicking on the application ID.
- **Edit AppConfig applications**: Edit the configuration of an existing AppConfig application by clicking on the application ID and then clicking **Edit Application**.
- **Delete AppConfig applications**: Delete an existing AppConfig application by selecting the application, followed by clicking **Actions** and then **Remove Selected**.

## API Coverage


### AppConfig API coverage

Source service: `appconfig`. 33 of 56 tracked operations are implemented.

Service documentation: /aws/services/appconfig/
License availability: available starting with the Base plan. See /aws/licensing/ for current plan details.

| Operation | Status |
| --- | --- |
| CreateApplication | Implemented |
| CreateConfigurationProfile | Implemented |
| CreateDeploymentStrategy | Implemented |
| CreateEnvironment | Implemented |
| CreateExperimentDefinition | Not implemented |
| CreateExtension | Not implemented |
| CreateExtensionAssociation | Not implemented |
| CreateHostedConfigurationVersion | Implemented |
| DeleteApplication | Implemented |
| DeleteConfigurationProfile | Implemented |
| DeleteDeploymentStrategy | Implemented |
| DeleteEnvironment | Implemented |
| DeleteExperimentDefinition | Not implemented |
| DeleteExtension | Not implemented |
| DeleteExtensionAssociation | Not implemented |
| DeleteHostedConfigurationVersion | Implemented |
| GetAccountSettings | Not implemented |
| GetApplication | Implemented |
| GetConfiguration | Implemented |
| GetConfigurationProfile | Implemented |
| GetDeployment | Implemented |
| GetDeploymentStrategy | Implemented |
| GetEnvironment | Implemented |
| GetExperimentDefinition | Not implemented |
| GetExperimentRun | Not implemented |
| GetExtension | Not implemented |
| GetExtensionAssociation | Not implemented |
| GetHostedConfigurationVersion | Implemented |
| ListApplications | Implemented |
| ListConfigurationProfiles | Implemented |
| ListDeploymentStrategies | Implemented |
| ListDeployments | Implemented |
| ListEnvironments | Implemented |
| ListExperimentDefinitions | Not implemented |
| ListExperimentRunEvents | Not implemented |
| ListExperimentRuns | Not implemented |
| ListExtensionAssociations | Not implemented |
| ListExtensions | Not implemented |
| ListHostedConfigurationVersions | Implemented |
| ListTagsForResource | Implemented |
| StartDeployment | Implemented |
| StartExperimentRun | Not implemented |
| StopDeployment | Implemented |
| StopExperimentRun | Not implemented |
| TagResource | Implemented |
| UntagResource | Implemented |
| UpdateAccountSettings | Not implemented |
| UpdateApplication | Implemented |
| UpdateConfigurationProfile | Implemented |
| UpdateDeploymentStrategy | Implemented |
| UpdateEnvironment | Implemented |
| UpdateExperimentDefinition | Not implemented |
| UpdateExperimentRun | Not implemented |
| UpdateExtension | Not implemented |
| UpdateExtensionAssociation | Not implemented |
| ValidateConfiguration | Implemented |

## API Coverage (AppConfig Data)


### AppConfig Data API coverage

Source service: `appconfigdata`. 2 of 2 tracked operations are implemented.

Service documentation: /aws/services/appconfig/
License availability: available starting with the Base plan. See /aws/licensing/ for current plan details.

| Operation | Status |
| --- | --- |
| GetLatestConfiguration | Implemented |
| StartConfigurationSession | Implemented |