second first commit

2026-09-22 08:57:00 -04:00
parent e88d7e2ff3
commit 0aef7fb2d8
4766 changed files with 1236986 additions and 0 deletions
@@ -0,0 +1,121 @@
+# AppConfig
+
+Floci supports AWS AppConfig and AppConfigData for local configuration management.
+
+## Management Plane (AppConfig)
+
+The management plane allows you to create and manage applications, environments, configuration profiles, and hosted configuration versions.
+
+### Supported Operations
+
+- `CreateApplication`
+- `GetApplication`
+- `ListApplications`
+- `DeleteApplication`
+- `CreateEnvironment`
+- `GetEnvironment`
+- `ListEnvironments`
+- `CreateConfigurationProfile`
+- `GetConfigurationProfile`
+- `ListConfigurationProfiles`
+- `DeleteConfigurationProfile`
+- `CreateHostedConfigurationVersion`
+- `GetHostedConfigurationVersion`
+- `DeleteHostedConfigurationVersion`
+- `CreateDeploymentStrategy`
+- `GetDeploymentStrategy`
+- `ListDeploymentStrategies`
+- `DeleteDeploymentStrategy`
+- `StartDeployment`
+- `GetDeployment`
+- `ListDeployments` (`GET /applications/{ApplicationId}/environments/{EnvironmentId}/deployments`)
+
+## Data Plane (AppConfigData) {#data-plane}
+
+The data plane is used by applications to retrieve the active configuration for an environment and profile.
+
+### Supported Operations
+
+- `StartConfigurationSession`
+- `GetLatestConfiguration`
+
+Basic `AWS.AppConfig.FeatureFlags` profiles are returned in AWS retrieval-time JSON format. Multi-variant
+feature flags require context evaluation and Amazon Ion output, which Floci does not yet emulate. Floci
+returns those configurations unchanged.
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `FLOCI_SERVICES_APPCONFIG_ENABLED` | `true` | Enable or disable the AppConfig management plane |
+| `FLOCI_SERVICES_APPCONFIGDATA_ENABLED` | `true` | Enable or disable the AppConfigData retrieval plane |
+
+## Example Usage
+
+### 1. Create an Application and Environment
+
+```bash
+# Create application
+aws appconfig create-application --name my-app --endpoint-url http://localhost:4566
+
+# Create environment
+aws appconfig create-environment --application-id <app-id> --name dev --endpoint-url http://localhost:4566
+```
+
+### 2. Create a Hosted Configuration
+
+```bash
+# Create configuration profile
+aws appconfig create-configuration-profile \
+  --application-id <app-id> \
+  --name my-profile \
+  --location-uri hosted \
+  --type AWS.Freeform \
+  --endpoint-url http://localhost:4566
+
+# Create hosted configuration version
+aws appconfig create-hosted-configuration-version \
+  --application-id <app-id> \
+  --configuration-profile-id <profile-id> \
+  --content "{\"foo\": \"bar\"}" \
+  --content-type application/json \
+  --endpoint-url http://localhost:4566
+```
+
+### 3. Deploy the Configuration
+
+```bash
+# Create immediate deployment strategy
+aws appconfig create-deployment-strategy \
+  --name immediate \
+  --deployment-duration-in-minutes 0 \
+  --growth-factor 100 \
+  --final-bake-time-in-minutes 0 \
+  --endpoint-url http://localhost:4566
+
+# Start deployment
+aws appconfig start-deployment \
+  --application-id <app-id> \
+  --environment-id <env-id> \
+  --configuration-profile-id <profile-id> \
+  --configuration-version 1 \
+  --deployment-strategy-id <strategy-id> \
+  --endpoint-url http://localhost:4566
+```
+
+### 4. Retrieve Configuration via Data Plane
+
+```bash
+# Start configuration session
+TOKEN=$(aws appconfigdata start-configuration-session \
+  --application-identifier <app-id> \
+  --environment-identifier <env-id> \
+  --configuration-profile-identifier <profile-id> \
+  --query "InitialConfigurationToken" --output text \
+  --endpoint-url http://localhost:4566)
+
+# Get latest configuration
+aws appconfigdata get-latest-configuration \
+  --configuration-token $TOKEN \
+  --endpoint-url http://localhost:4566
+```