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,76 @@
+# CodePipeline
+
+Floci implements the AWS CodePipeline JSON 1.1 API and a local pipeline execution engine.
+
+**Protocol:** `POST /` with `Content-Type: application/x-amz-json-1.1` and
+`X-Amz-Target: CodePipeline_20150709.<Action>`.
+
+## Supported Operations (44 total)
+
+The complete CodePipeline 2015-07-09 API surface is routed:
+
+- Pipeline lifecycle, state, execution history, start, stop, retry, and rollback
+- Stage transitions, manual approvals, action and rule execution history
+- Custom action types and AWS/third-party worker job polling
+- Webhook registration and tag lifecycle
+
+Pipeline definitions, executions, custom action types, jobs, webhooks, tags, and transition
+state use Floci's configured storage backend.
+
+## Execution
+
+Stages execute in declaration order. Actions with the same `runOrder` execute in parallel.
+`SUPERSEDED`, `QUEUED`, and `PARALLEL` execution modes are recognized, with `QUEUED` and
+`PARALLEL` restricted to V2 pipelines.
+A `QUEUED` or `PARALLEL` pipeline holds at most 50 active executions, as on AWS;
+`StartPipelineExecution` beyond that returns `ConcurrentPipelineExecutionsLimitExceededException`.
+
+S3 source actions poll for source changes by default, matching AWS when `PollForSourceChanges` is
+omitted or set to `true`. Floci establishes a baseline for the configured object and starts one new
+execution when its version ID or ETag changes, recording `PollForSourceChanges` as the execution
+trigger. Set `PollForSourceChanges` to `false` to disable this polling path.
+
+The following providers execute against local Floci services:
+
+| Category | Provider | Behavior |
+|---|---|---|
+| Source | S3 | Reads the configured object and publishes the output artifact |
+| Build/Test | CodeBuild | Starts and monitors the configured local CodeBuild project |
+| Deploy | S3 | Writes the input artifact to the configured bucket and key |
+| Deploy | CodeDeploy | Starts and monitors a local CodeDeploy deployment |
+| Invoke | Lambda | Invokes the configured local Lambda function |
+| Invoke | CodePipeline | Starts a nested local pipeline execution |
+| Approval | Manual | Waits for `PutApprovalResult` |
+| Custom/third-party | Any registered action | Uses poll, acknowledge, success, and failure job APIs |
+
+AWS-managed providers without a corresponding Floci execution adapter fail the action with an
+AWS-shaped action error. Floci does not call real AWS accounts or third-party SaaS providers.
+
+## Approvals
+
+`PutApprovalResult` completes waiting Manual approval actions with AWS-shaped validation
+and error responses. Floci validates the stage and action names, enforces `result.status`
+as `Approved` or `Rejected`, limits `result.summary` to 512 characters, returns
+`InvalidApprovalTokenException` for unknown tokens, and returns
+`ApprovalAlreadyCompletedException` if the same approval token is reused after completion.
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `FLOCI_SERVICES_CODEPIPELINE_ENABLED` | `true` | Enables the CodePipeline API |
+| `FLOCI_STORAGE_SERVICES_CODEPIPELINE_MODE` | global mode | Overrides CodePipeline storage mode |
+| `FLOCI_STORAGE_SERVICES_CODEPIPELINE_FLUSH_INTERVAL_MS` | `5000` | Hybrid storage flush interval |
+
+## Example
+
+```bash
+aws --endpoint-url http://localhost:4566 codepipeline create-pipeline \
+  --pipeline file://pipeline.json
+
+aws --endpoint-url http://localhost:4566 codepipeline start-pipeline-execution \
+  --name local-release
+
+aws --endpoint-url http://localhost:4566 codepipeline list-pipeline-executions \
+  --pipeline-name local-release
+```