finfocus-analyzer-setup

name

finfocus-analyzer-setup

description

Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation during pulumi preview. Use when setting up the analyzer, configuring the policy pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi workflows. Triggers on: "set up analyzer", "configure analyzer", "install analyzer", "Pulumi preview costs", "inline cost estimates", "policy pack setup", "analyzer integration", "zero-click cost estimation", "analyzer check", or any task involving finfocus Pulumi Analyzer configuration.

FinFocus Analyzer Setup

Inline cost estimation during pulumi preview via the Pulumi Analyzer protocol. All diagnostics are ADVISORY — never blocks deployments.

Prerequisites

finfocus --version          # FinFocus CLI installed
pulumi version              # Pulumi CLI installed
finfocus plugin list        # At least one cost plugin installed

Quick Setup

finfocus analyzer install           # Install + create policy pack
finfocus analyzer check             # Verify all 4 checks pass

# Add to PATH (required for Pulumi to discover the binary)
export PATH="$HOME/.finfocus/analyzer:$PATH"

# Run preview with costs
pulumi preview --policy-pack ~/.finfocus/analyzer

For persistent PATH, add the export to ~/.bashrc or ~/.zshrc.

Windows (PowerShell): Add to your PowerShell profile ($PROFILE):

$env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH"

Restart PowerShell for changes to take effect.

What analyzer install Does

1. Creates ~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus (symlink on Unix, copy on Windows)
2. Creates ~/.finfocus/analyzer/PulumiPolicy.yaml (runtime: finfocus)
3. Creates ~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus (binary reference)

Use --force to reinstall after upgrading finfocus. Use --target-dir to override the Pulumi plugin directory.

Verification

finfocus analyzer check                # Table output
finfocus analyzer check --output json  # JSON for CI

Runs 4 sequential checks (later checks skip if earlier ones fail):

Check	Verifies
policy_pack_dir	~/.finfocus/analyzer/ exists
pulumi_policy_yaml	PulumiPolicy.yaml has runtime: finfocus
binary_in_path	pulumi-analyzer-policy-finfocus on PATH
grpc_smoke_test	analyzer serve starts and responds to RPC

Expected Output

Policies:
    finfocus@v0.3.3 (local: ~/.finfocus/analyzer)
        - [advisory]  cost-estimate  (aws:ec2/instance:Instance: my-instance)
          Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws)
        - [advisory]  stack-cost-summary  (pulumi:pulumi:Stack: my-stack)
          Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed)

CI/CD Usage

export PULUMI_POLICY_PACK_PATH="$HOME/.finfocus/analyzer"
pulumi preview    # No --policy-pack flag needed

Troubleshooting

See references/troubleshooting.md for common failure modes, PATH issues, version mismatches, plugin isolation, and config tuning.

Uninstall

finfocus analyzer uninstall              # Remove from Pulumi plugin dir
finfocus analyzer uninstall --target-dir /custom/path