feat: Add version via input; build stac server lambdas via null resource (#4)

* Add version via input; build stac server lambdas via null resource

* small tweaks to local_setup

* Clarify input vars

* changelog

* precommit cleanup

Author: KayakinCoder

.github/pull_request_template.md

@@ -18,6 +18,6 @@ This change was validated by the following observations:
 - [ ] Changelog
   - [ ] I have added my changes to CHANGELOG.md
   - [ ] No changelog entry is necessary
-- [ ] stac-server Version
-  - [ ] I have noted a version bump in the stac-server lambdas in CHANGELOG.md, and updated the `STAC_SERVER_TAG` throughout `/.github/workflows`
+- [ ] stac-server Default, Built-In Version
+  - [ ] I have noted a version bump in the stac-server lambdas in CHANGELOG.md, updated the `STAC_SERVER_TAG` throughout `/.github/workflows`, and `inputs.stac_server_version` default value
   - [ ] No stac-server version bump was performed

.github/workflows-WIP/release-tests.yml

@@ -24,6 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       CI: true
+      # Ensure this matches inputs.stac_server_version default value
       STAC_SERVER_TAG: v3.10.0
     steps:
       - uses: actions/checkout@v5

.github/workflows/ci.yml

@@ -14,6 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       CI: true
+      # Ensure this matches inputs.stac_server_version default value
       STAC_SERVER_TAG: v3.10.0
     steps:
       - uses: actions/checkout@v5

.gitignore

@@ -28,3 +28,5 @@ stac-server.tgz
 terraform-visual-report
 terraform.tgz
 historical-ingest/lambda/package/*
+user_init_lambda_zip.zip 
+waiting_for_opensearch_lambda_zip.zip

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## Unreleased
 
+- Support inputs.stac_server_version usage
+
 ### Added
 
 ### Changed

CONTRIBUTING.md

@@ -4,7 +4,7 @@
 
 - tfenv
 - pre-commit
-- nvm (if updating the built-in stac-server version)
+- nvm (if updating the default, built-in stac-server version)
 
 **General Updates**
 
@@ -16,10 +16,10 @@
 
 4. Fill out the PR template
 
-**Updating the Built-In stac-server Version**
+**Updating the Default, Built-In stac-server Version**
 
 We prepackage a specific stac-server version with each release of this repository. To change this prepackaged version:
 
 1. Build stac-server and get its lambdas: `./scripts/update-lambdas.bash v3.10.0`
 
-2. Follow the steps in the PR template to note this version change
+2. Follow the steps in the PR template to note and propagate the change to appropriate files

inputs.tf

@@ -1,3 +1,23 @@
+variable "stac_server_version" {
+  description = <<-DESCRIPTION
+  stac-server version. Leave this null to use the default, prepackaged version of stac-server.
+
+  If you need to use a custom version, set this variable to the desired version string *and* set
+  deploy_local_stac_server_artifacts = true. Note though that custom versions of stac-server are not
+  guaranteed to be compatible with this module.
+  DESCRIPTION
+
+  type    = string
+  default = "v3.10.0"
+}
+
+variable "deploy_local_stac_server_artifacts" {
+  description = "Deploy STAC Server artifacts for local deploy"
+  type        = bool
+  default     = false
+  nullable    = false
+}
+
 variable "stac_id" {
   description = "STAC identifier"
   type        = string

providers.tf

@@ -19,6 +19,5 @@ terraform {
       source  = "hashicorp/archive"
       version = "~> 2.4"
     }
-
   }
 }

stac_server_local_setup.tf

@@ -0,0 +1,14 @@
+# Sets up artifacts for a local stac server deploy
+resource "null_resource" "stac_server_local_artifact_setup" {
+  count = var.deploy_local_stac_server_artifacts == true && var.stac_server_version != null ? 1 : 0
+
+  triggers = {
+    stac_server_version = var.stac_server_version
+  }
+
+  provisioner "local-exec" {
+    interpreter = ["bash", "-ec"]
+    working_dir = path.module
+    command     = "./scripts/update-lambdas.bash ${var.stac_server_version}"
+  }
+}