Edge Connect Deployment Examples

This repository provides reference examples for deploying applications on the Edge Connect platform using Terraform. Each example demonstrates different deployment patterns and integration scenarios.

Available Examples

with-database

Demonstrates deploying a stateful application (Spring Pet Clinic) on Edge Connect with external database connectivity. This example shows how to:

• Deploy a containerized application to Edge Connect
• Configure network connectivity for external service access
• Integrate with managed database services
• Template Kubernetes manifests with environment-specific configuration

Note on architecture: Edge Connect focuses on edge application deployment and doesn't currently provide managed services like databases. This example uses Open Telekom Cloud (OTC) for the PostgreSQL database, demonstrating a common pattern where edge applications connect to managed services in a central cloud region. While this introduces cross-cloud connectivity considerations, it enables use of mature managed services until equivalent edge-native options become available.

Prerequisites

• Terraform >= 1.0
• Access to Edge Connect API endpoint
• Edge Connect credentials (username/password or token)
• For database examples: Access to a cloud provider for managed services (e.g., Open Telekom Cloud)

Quick Start

Each example includes a complete Terraform configuration. Navigate to an example directory and:

cd with-database/terraform

# Configure required variables (see example's var.tf for details)
export TF_VAR_app_organization="your-org"
export TF_VAR_cloudlet_org="cloudlet-org"
export TF_VAR_cloudlet="cloudlet-name"

# Initialize Terraform
terraform init

# Review the plan
terraform plan

# Apply the configuration
terraform apply

Provider Configuration

These examples use the Edge Connect Terraform Provider. Provider configuration can be set via environment variables:

export EDGE_CONNECT_BASE_URL="https://your-edge-connect-api"
export EDGE_CONNECT_TOKEN="your-token"
# or
export EDGE_CONNECT_USERNAME="your-username"
export EDGE_CONNECT_PASSWORD="your-password"

Alternatively, configure in your Terraform code:

provider "edge-connect" {
  base_url = "https://your-edge-connect-api"
  token    = var.edge_connect_token
}

Example Structure

Each example follows a consistent structure:

• deployment.tf - Edge Connect application and instance definitions
• providers.tf - Terraform provider configuration
• var.tf - Input variables and defaults
• k8sDeployment.yaml - Kubernetes manifest templates (when applicable)
• Additional *.tf files for supporting infrastructure (databases, networking, etc.)

Security Considerations

When connecting edge applications to external services (databases, APIs, etc.):

• Network security: Configure appropriate security groups and firewall rules. The examples use open CIDR blocks for demonstration purposes - restrict these in production.
• Credential management: Use Terraform variables and avoid committing sensitive values. Consider using secret management solutions for production deployments.
• Cross-cloud connectivity: When connecting to services in different cloud providers or regions, ensure you understand the network path, latency implications, and compliance requirements.

Contributing

Additional deployment examples are welcome. When contributing:

• Follow the established directory structure (example-name/terraform/)
• Include a complete, working example with clear variable definitions
• Document any specific prerequisites or configuration requirements
• Focus on demonstrating Edge Connect capabilities and integration patterns

Resources

• Edge Connect Documentation
• Edge Connect Terraform Provider
• Terraform Documentation
• Open Telekom Cloud Documentation

Support

For questions or issues:

• Open an issue in this repository
• Contact the DevFW-CICD team

License

See LICENSE file for details.