Support¶

Get help with VPC Provisioner.

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

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

Common Issues¶

Configuration validation errors

Check your VPC configuration YAML file in configs/ directory
Verify YAML syntax (indentation, quotes)
Ensure all required sections present (client, environment, vpc)
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 VPC permissions: aws ec2 describe-vpcs --region us-west-2 --no-paginate
Test CloudFormation access: aws cloudformation list-stacks --region us-west-2 --max-items 5
Generate required IAM policy: Run create-policy action
See IAM_PERMISSIONS.md for complete permissions list

Invalid CIDR block

Use valid CIDR format (x.x.x.x/y)
VPC CIDR must be /16 to /28
Subnet CIDR must be within VPC CIDR

Stack already exists

List stacks in region: aws cloudformation list-stacks --region us-west-2 --stack-status-filter CREATE_COMPLETE --output table
VPC stack names must be unique
Delete existing: Use delete-vpc --force action
Or rename: Use different vpc_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 VPC 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 VPC 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 vpc-provisioner:latest | grep Created

2. Configuration File¶

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

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

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

vpc:
  vpc_name_override: ""
  cidr_block: 10.0.0.0/16
  availability_zones:
    - us-west-2a
  subnets:
    public:
      - name: public-subnet-1
        cidr: 10.0.1.0/24
        az: us-west-2a
  internet_gateway:
    enabled: true
  nat_gateway:
    enabled: true
    high_availability: false

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 \
docker run --rm \
  -v ~/.aws:/home/vpcuser/.aws:ro \
  -v $(pwd)/vpc/configs:/app/configs:ro \
  -v $(pwd)/vpc/reports:/app/reports \
  -v $(pwd)/vpc/templates:/app/templates \
  vpc-provisioner:latest \
  --config edge-prod-b001-us-west-2-vpc.yaml \
  --action create-vpc

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-vpc-stack-name \
  --max-items 20

Self-Service Resources¶

Validate Your Configuration¶

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

Check AWS Credentials¶

# View credentials file
cat ~/.aws/credentials

# Test credentials
aws sts get-caller-identity

# Test VPC access
aws ec2 describe-vpcs --region us-west-2

Verify IAM Permissions¶

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

# Test VPC creation permission
aws ec2 describe-vpcs --region us-west-2

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)/vpc/configs:/app/configs \
  -v $(pwd)/vpc/reports:/app/reports \
  -v $(pwd)/vpc/policies:/app/policies \
  -v $(pwd)/vpc/templates:/app/templates \
  --entrypoint /bin/sh \
  vpc-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 VPCs in production
License validation fails for valid subscription
Data loss or corruption

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

NAT Gateway configuration fails
Internet Gateway not created
Template generation errors
Subnet creation issues

Medium (P3): Minor feature issue, workaround available

Documentation unclear
Non-critical configuration validation errors
Tagging 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 VPC 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 VPC Documentation: https://docs.aws.amazon.com/vpc/
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 AWS Marketplace Customer Support through your AWS account.