Support¶

Table of Contents¶

Quick Help
Getting Support
Before Contacting Support
Self-Service Resources
Reporting Bugs
Feature Requests
Service Level Agreement (SLA)
License Validation Issues
Troubleshooting Resources
Updates and Announcements
Feedback
Additional Resources
Legal

Get help with S3 Provisioner.

Quick Help¶

Documentation¶

README - Quick start guide
User Guide - Complete command reference
Configuration Reference - YAML configuration guide
Troubleshooting - Common issues and solutions
IAM Permissions - Required AWS permissions
ML Lifecycle Policies - Lifecycle policy guidance

Common Issues¶

Configuration validation errors

Check your S3 configuration YAML file in configs/ directory
Verify YAML syntax (indentation, quotes)
Ensure all required sections present (client, environment, s3)
See CONFIGURATION.md for complete schema
Run validate-config action to check

AWS credential errors

Check credentials file exists: ls -la ~/.aws/credentials
Check which profile is used: echo $AWS_PROFILE (if empty, uses [default])
Test authentication: aws sts get-caller-identity
Verify permissions (see IAM_PERMISSIONS.md)

Permission denied

Check current identity: aws sts get-caller-identity
Test S3 permissions: aws s3 ls --region us-west-1
Test CloudFormation access: aws cloudformation list-stacks --region us-west-1 --max-items 5
Generate required IAM policy: Run create-policy action
See IAM_PERMISSIONS.md for complete permissions list

Bucket already exists

List buckets in region: aws s3 ls
Bucket names must be globally unique
Use bucket_name_override with different name
Check if bucket exists in different region/account

Stack already exists

List stacks in region: aws cloudformation list-stacks --region us-west-1 --stack-status-filter CREATE_COMPLETE --output table
S3 stack names must be unique
Delete existing: Use tear-down --force action
Or rename: Use different bucket_name_override

Docker errors

Verify Docker is running: docker ps
Check volume mounts are correct
Ensure files exist in mounted directories

Getting Support¶

AWS Marketplace Support¶

For issues related to:

Product subscription and licensing
Billing questions
AWS Marketplace portal issues
License validation errors

Contact: AWS Marketplace Customer Support through your AWS account

How to Contact:

Log into AWS Console
Navigate to AWS Marketplace
Go to “Manage Subscriptions”
Select S3 Provisioner
Click “Get Support”

Response Time: Per AWS Marketplace SLA

Product Support¶

For issues related to:

Product functionality
Configuration questions
Bug reports
Feature requests
Technical questions

Contact:

Log into AWS Console
Navigate to AWS Marketplace
Go to “Manage Subscriptions”
Select S3 Provisioner
Click “Contact Seller”

Support Hours: Monday-Friday, 9 AM - 5 PM Pacific Time (business days)

Response Time:

Critical issues: Within 1 business day
High priority: Within 2 business days
Medium priority: Within 3 business days
Low priority: Within 5 business days

Before Contacting Support¶

Please gather the following information:

1. Product Version¶

docker inspect s3-provisioner:latest | grep Created

2. Configuration File¶

Sanitize sensitive data (account IDs, bucket names) before sharing:

client:
  company_name: REDACTED
  company_prefix: REDACTED
  account_id: "REDACTED"
  tenant_id: "REDACTED"

environment:
  env: prod
  region: us-west-1

s3:
  bucket_name_override: ""
  versioning: true
  lifecycle_policy: ml-optimized

3. Error Message¶

Copy the complete error message from console output or log files.

4. Command Used¶

Provide the exact Docker command:

docker run --rm \
  -v ~/.aws:/home/s3user/.aws:ro \
  -v $(pwd)/s3/configs:/app/configs:ro \
  -v $(pwd)/s3/reports:/app/reports \
  -v $(pwd)/s3/templates:/app/templates \
  s3-provisioner:latest \
  --config edge-prod-a001-us-west-1-s3.yaml \
  --action create-bucket \
  --solution master-solution \
  --force

5. AWS Region¶

Specify the AWS region where you’re deploying.

6. Expected vs Actual Behavior¶

What you expected to happen
What actually happened
Steps to reproduce

7. CloudFormation Stack Events¶

If stack creation failed:

aws cloudformation describe-stack-events \
  --stack-name your-s3-stack-name \
  --max-items 20

Self-Service Resources¶

Validate Your Configuration¶

docker run --rm \
  -v $(pwd)/s3/configs:/app/configs:ro \
  -v $(pwd)/s3/reports:/app/reports \
  s3-provisioner:latest \
  --config edge-prod-a001-us-west-1-s3.yaml \
  --action validate-config

Check AWS Credentials¶

# View credentials file
cat ~/.aws/credentials

# Test credentials
aws sts get-caller-identity

# Test S3 access
aws s3 ls

Verify IAM Permissions¶

# Check current user/role
aws sts get-caller-identity

# Test S3 bucket creation permission
aws s3api create-bucket \
  --bucket test-bucket-name-12345 \
  --region us-east-1 \
  --dry-run

View Container Logs¶

# List recent containers
docker ps -a

# View logs
docker logs <container-id>

# Check reports directory
ls -la reports/
cat reports/*.log

Test Docker Setup¶

# Check Docker version
docker --version

# Test Docker is running
docker ps

# Test volume mounts
docker run --rm \
  -v $(pwd)/s3/configs:/app/configs \
  -v $(pwd)/s3/reports:/app/reports \
  -v $(pwd)/s3/policies:/app/policies \
  -v $(pwd)/s3/templates:/app/templates \
  --entrypoint /bin/sh \
  s3-provisioner:latest \
  -c "ls -la /app/configs"

Reporting Bugs¶

When reporting bugs, include:

Steps to reproduce - Exact sequence of commands
Expected behavior - What should happen
Actual behavior - What actually happened
Error messages - Complete error output
Configuration file - Sanitized YAML
Environment details - OS, Docker version, AWS region
CloudFormation events - Stack events if applicable

Contact: AWS Marketplace support channel

Feature Requests¶

We welcome feature requests! See our Feedback page for submission guidelines and templates.

For planned features and voting, see Roadmap.

Service Level Agreement (SLA)¶

Response Times¶

Priority	Response Time	Resolution Target
Critical (P1)	1 business day	2 business days
High (P2)	2 business days	3 business days
Medium (P3)	3 business days	5 business days
Low (P4)	5 business days	Best effort

Priority Definitions¶

Critical (P1): Production system down, no workaround available

CloudFormation stack creation fails
Cannot create buckets in production
License validation fails for valid subscription
Data loss or corruption

High (P2): Major feature not working, workaround available

Lifecycle policies not applied correctly
VPC endpoint configuration fails
Template generation errors
Drift detection not working

Medium (P3): Minor feature issue, workaround available

Documentation unclear
Non-critical configuration validation errors
GitKeep management issues
Logging problems

Low (P4): Cosmetic issue, feature request, general questions

Documentation typos
Feature enhancement requests
General usage questions
Best practices guidance

License Validation Issues¶

If you see license validation errors:

1. Verify Subscription¶

Log into AWS Marketplace
Check “Manage Subscriptions”
Verify S3 Provisioner is subscribed and active
Check subscription status (active, expired, cancelled)

2. Verify IAM Permissions¶

Ensure IAM role/user has AWS Marketplace permissions:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe",
        "aws-marketplace:Unsubscribe"
      ],
      "Resource": "*"
    }
  ]
}

3. Contact AWS Marketplace Support¶

For subscription and licensing issues, contact AWS Marketplace Customer Support through your AWS account.

Troubleshooting Resources¶

Documentation¶

TROUBLESHOOTING.md - Comprehensive troubleshooting guide
IAM_PERMISSIONS.md - Required permissions
CONFIGURATION.md - Configuration reference
USER_GUIDE.md - Command reference

AWS Resources¶

AWS S3 Documentation: https://docs.aws.amazon.com/s3/
AWS CloudFormation Documentation: https://docs.aws.amazon.com/cloudformation/
AWS IAM Documentation: https://docs.aws.amazon.com/iam/
AWS Marketplace Documentation: https://docs.aws.amazon.com/marketplace/

Community¶

AWS re:Post: https://repost.aws/
AWS Support Center: https://console.aws.amazon.com/support/

Updates and Announcements¶

Release Notes¶

Check RELEASE_NOTES.md for:

Version updates
New features
Bug fixes
Breaking changes
Migration guides

Product Roadmap¶

Check ROADMAP.md for:

Planned features
Timeline estimates
Feature voting
Early access programs

AWS Marketplace¶

Check AWS Marketplace product listing for:

Latest version availability
Subscription status
Pricing updates
Product announcements

Feedback¶

Your feedback helps us improve the product. We accept feature requests and documentation feedback.

See Feedback for details on how to submit.

Additional Resources¶

AWS Support¶

AWS Support Center: https://console.aws.amazon.com/support/
AWS Documentation: https://docs.aws.amazon.com/
AWS re:Post: https://repost.aws/

AWS Marketplace¶

AWS Marketplace: https://aws.amazon.com/marketplace/
Manage Subscriptions: https://console.aws.amazon.com/marketplace/home#/subscriptions
AWS Marketplace Support: Through AWS Console

Product Documentation¶

README.md - Quick start
USER_GUIDE.md - Complete reference
CONFIGURATION.md - Configuration guide
TROUBLESHOOTING.md - Problem solving
IAM_PERMISSIONS.md - Security setup

Legal¶

Terms of Service¶

See AWS Marketplace listing for complete terms of service.

Privacy Policy¶

AWS Privacy Policy: https://aws.amazon.com/privacy/

License Agreement¶

Commercial license via AWS Marketplace subscription. See AWS Marketplace listing for license terms.

For all support inquiries, please contact support through AWS Marketplace or [company support contact - to be determined].

See LICENSE.txt for terms and conditions.