1## Configuration Management
2 
3**Note on Smart Shield Evolution:** Argo Smart Routing is being integrated into Smart Shield. Configuration methods below remain valid; Terraform and IaC patterns unchanged.
4 
5### Infrastructure as Code (Terraform)
6 
7```hcl
8# terraform/argo.tf
9# Note: Use Cloudflare Terraform provider
10 
11resource "cloudflare_argo" "example" {
12  zone_id        = var.zone_id
13  smart_routing  = "on"
14  tiered_caching = "on"
15}
16 
17variable "zone_id" {
18  description = "Cloudflare Zone ID"
19  type        = string
20}
21 
22output "argo_enabled" {
23  value       = cloudflare_argo.example.smart_routing
24  description = "Argo Smart Routing status"
25}
26```
27 
28### Environment-Based Configuration
29 
30```typescript
31// config/argo.ts
32interface ArgoEnvironmentConfig {
33  enabled: boolean;
34  tieredCache: boolean;
35  monitoring: {
36    usageAlerts: boolean;
37    threshold: number;
38  };
39}
40 
41const configs: Record<string, ArgoEnvironmentConfig> = {
42  production: {
43    enabled: true,
44    tieredCache: true,
45    monitoring: {
46      usageAlerts: true,
47      threshold: 1000, // GB
48    },
49  },
50  staging: {
51    enabled: true,
52    tieredCache: false,
53    monitoring: {
54      usageAlerts: false,
55      threshold: 100, // GB
56    },
57  },
58  development: {
59    enabled: false,
60    tieredCache: false,
61    monitoring: {
62      usageAlerts: false,
63      threshold: 0,
64    },
65  },
66};
67 
68export function getArgoConfig(env: string): ArgoEnvironmentConfig {
69  return configs[env] || configs.development;
70}
71```
72 
73### Pulumi Configuration
74 
75```typescript
76// pulumi/argo.ts
77import * as cloudflare from '@pulumi/cloudflare';
78 
79const zone = new cloudflare.Zone('example-zone', {
80  zone: 'example.com',
81  plan: 'enterprise',
82});
83 
84const argoSettings = new cloudflare.Argo('argo-config', {
85  zoneId: zone.id,
86  smartRouting: 'on',
87  tieredCaching: 'on',
88});
89 
90export const argoEnabled = argoSettings.smartRouting;
91export const zoneId = zone.id;
92```
93 
94## Billing Configuration
95 
96Before enabling Argo Smart Routing, ensure billing is configured for the account:
97 
98**Prerequisites:**
991. Valid payment method on file
1002. Enterprise or higher plan
1013. Zone must have billing enabled
102 
103**Check Billing Status via Dashboard:**
1041. Navigate to Account → Billing
1052. Verify payment method configured
1063. Check zone subscription status
107 
108**Note:** Attempting to enable Argo without billing configured will result in `editable: false` in API responses.
109 
110## Environment Variable Setup
111 
112**Required Environment Variables:**
113```bash
114# .env
115CLOUDFLARE_API_TOKEN=your_api_token_here
116CLOUDFLARE_ZONE_ID=your_zone_id_here
117CLOUDFLARE_ACCOUNT_ID=your_account_id_here
118 
119# Optional
120ARGO_ENABLED=true
121ARGO_TIERED_CACHE=true
122```
123 
124**TypeScript Configuration Loader:**
125```typescript
126// config/env.ts
127import { z } from 'zod';
128 
129const envSchema = z.object({
130  CLOUDFLARE_API_TOKEN: z.string().min(1),
131  CLOUDFLARE_ZONE_ID: z.string().min(1),
132  CLOUDFLARE_ACCOUNT_ID: z.string().min(1),
133  ARGO_ENABLED: z.string().optional().default('false'),
134  ARGO_TIERED_CACHE: z.string().optional().default('false'),
135});
136 
137export const env = envSchema.parse(process.env);
138 
139export const argoConfig = {
140  enabled: env.ARGO_ENABLED === 'true',
141  tieredCache: env.ARGO_TIERED_CACHE === 'true',
142};
143```
144 
145## CI/CD Integration
146 
147**GitHub Actions Example:**
148```yaml
149# .github/workflows/deploy-argo.yml
150name: Deploy Argo Configuration
151 
152on:
153  push:
154    branches: [main]
155    paths:
156      - 'terraform/argo.tf'
157 
158jobs:
159  deploy:
160    runs-on: ubuntu-latest
161    steps:
162      - uses: actions/checkout@v3
163      
164      - name: Setup Terraform
165        uses: hashicorp/setup-terraform@v2
166        
167      - name: Terraform Init
168        run: terraform init
169        working-directory: ./terraform
170        
171      - name: Terraform Apply
172        run: terraform apply -auto-approve
173        working-directory: ./terraform
174        env:
175          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
176          TF_VAR_zone_id: ${{ secrets.CLOUDFLARE_ZONE_ID }}
177```
178 
179## Enterprise Preview Program
180 
181For early access to Argo Smart Routing features and Smart Shield integration:
182 
183**Eligibility:**
184- Enterprise plan customers
185- Active Cloudflare support contract
186- Production traffic >100GB/month
187 
188**How to Join:**
1891. Contact Cloudflare account team or support
1902. Request Argo/Smart Shield preview access
1913. Receive preview zone configuration
192 
193**Preview Features:**
194- Enhanced analytics and reporting
195- Smart Shield DDoS integration
196- Advanced routing policies
197- Priority support for routing issues