Skip to content

Beta testing fixes for first-time AWS deployment (ArcGIS/DC deployment)#1

Closed
cstirry wants to merge 4 commits into
developfrom
fix/deployment-docs-and-bugs
Closed

Beta testing fixes for first-time AWS deployment (ArcGIS/DC deployment)#1
cstirry wants to merge 4 commits into
developfrom
fix/deployment-docs-and-bugs

Conversation

@cstirry
Copy link
Copy Markdown

@cstirry cstirry commented Apr 21, 2026

Bugs Fixed

  1. S3 terraform state bucket name hardcoded and caused an issue because S3 bucket names are globally unique across all AWS accounts (confirm). The default name opencontext-terraform-state (cli/commands/configure.py, terraform/bootstrap/variables.tf, terraform/aws/main.tf) gave me an error that already claimed, got a 403 and 409 error. Suggested fix to add an interactive prompt in opencontext configure that suggests a unique name based on the city slug and creates the bucket automatically if it doesn't exist.

  2. terraform validate fails before Lambda zip exists. Pre-deploy validation runs terraform validate which references lambda-deployment.zip, but that file isn't created until the packaging step inside deploy so can't deploy on a first-time run. Suggested fix to remove terraform validate from pre-deploy checks (or edit it), terraform plan (which runs after packaging) catches the same configuration errors (cli/commands/validate.py).

Other Potential Issues (Not Fixed Yet)

  1. opencontext test incorrectly skips API Gateway URL testing, citing auth requirement even when no custom domain is configured and the URL works fine via curl

  2. opencontext test marks 404 responses as passing

  3. pyenv rehash lock on Mac blocks opencontext command after install (workaround: rm ~/.pyenv/shims/.pyenv-shim && pyenv rehash).

  4. Getting Started, README, and Quickstart docs need some updates. Recommend deleting the Quickstart doc to avoid confusion.

Potential Nice to Haves

  1. Deployment engineers might find uv-based install instructions useful, new deployers could be guided to set up a uv virtual environment from the start

  2. Deployment engineers might find some sort of evaluation module useful, its easy to confirm that MCP set up and connected in Claude, but hard to know if results are as expected.

Testing
With a few fixes, deployed successfully to AWS staging environment with ArcGIS plugin pointed at https://opendata.dc.gov/. Verified with curl and Claude Connector.

@cstirry cstirry changed the title Fix/deployment docs and bugs Beta testing fixes for first-time AWS deployment (ArcGIS/DC deployment) Apr 21, 2026
@cstirry
Copy link
Copy Markdown
Author

cstirry commented Apr 21, 2026

Met with Srihari on 4/21, he was aware of the two main bugs and believed they had been fixed in the CLI tools, but it was unclear if those fixes were in the repo yet

@cstirry cstirry closed this May 8, 2026
@cstirry cstirry deleted the fix/deployment-docs-and-bugs branch May 8, 2026 20:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant