| 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
pulumi version
finfocus plugin list
Quick Setup
finfocus analyzer install
finfocus analyzer check
export PATH="$HOME/.finfocus/analyzer:$PATH"
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
- Creates
~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus
(symlink on Unix, copy on Windows)
- Creates
~/.finfocus/analyzer/PulumiPolicy.yaml (runtime: finfocus)
- 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
finfocus analyzer check --output json
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
Troubleshooting
See references/troubleshooting.md for common
failure modes, PATH issues, version mismatches, plugin isolation, and config
tuning.
Uninstall
finfocus analyzer uninstall
finfocus analyzer uninstall --target-dir /custom/path