Skip to content

Add make targets for local development setup and documentation - #137

Open
PuneetPunamiya wants to merge 1 commit into
redhat-data-and-ai:mainfrom
PuneetPunamiya:adds-make-targers-for-local-setup
Open

Add make targets for local development setup and documentation#137
PuneetPunamiya wants to merge 1 commit into
redhat-data-and-ai:mainfrom
PuneetPunamiya:adds-make-targers-for-local-setup

Conversation

@PuneetPunamiya

@PuneetPunamiya PuneetPunamiya commented Apr 8, 2026

Copy link
Copy Markdown
Contributor
  • Add DEVELOPMENT.md guide covering the complete local development
    workflow including LocalStack setup, CRD installation, controller
    configuration, and e2e testing with required environment variables

  • Introduce make targets (local-dev-setup, local-dev-cleanup) with
    corresponding shell scripts to automate local environment creation,
    including S3 buckets, SQS queues, and Docling service setup.

  • Fix test-e2e target to pass KIND_CLUSTER and SKIP_CLUSTER_SETUP
    environment variables, preventing duplicate cluster creation and
    aligning local test execution with CI workflow.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces automated local development environment setup and cleanup through new Makefile targets and bash scripts. The scripts handle Kind cluster creation, namespace setup, local caching, Docling service management, and LocalStack resource configuration. Feedback was provided to improve the scripts' robustness by adding dependency checks, using relative paths for configuration files, removing unused variables, and ensuring the cleanup process removes the local cache directory.

Comment thread scripts/local-dev-setup.sh Outdated
Comment thread scripts/local-dev-setup.sh Outdated
Comment thread scripts/local-dev-setup.sh Outdated
Comment thread scripts/local-dev-cleanup.sh
@PuneetPunamiya
PuneetPunamiya force-pushed the adds-make-targers-for-local-setup branch from 3f32894 to f6639f8 Compare April 14, 2026 06:23
@PuneetPunamiya PuneetPunamiya changed the title Add make targets for local development environment setup Add make targets for local development setup and documentation Apr 14, 2026
Comment thread DEVELOPMENT.md Outdated
Comment thread scripts/local-dev-setup.sh Outdated
Comment thread DEVELOPMENT.md
Comment thread DEVELOPMENT.md Outdated
Comment thread DEVELOPMENT.md Outdated
Comment thread DEVELOPMENT.md Outdated
Comment thread DEVELOPMENT.md
@pradeepto

Copy link
Copy Markdown

Can we priortise this? I would like to try this as customer 0. Thanks.

Comment thread scripts/local-dev-cleanup.sh
Comment thread scripts/local-dev-setup.sh Outdated
#!/usr/bin/env bash
set -e

export AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION:-us-east-1}"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we move this to yaml

Comment thread scripts/local-dev-setup.sh Outdated
CACHE_DIR="${CACHE_DIR:-tmp/cache}"
DATA_STORAGE_BUCKET="${DATA_STORAGE_BUCKET:-data-storage-bucket}"
DATA_INGESTION_BUCKET="${DATA_INGESTION_BUCKET:-data-ingestion-bucket}"
OUTPUT_RESULT_BUCKET="${OUTPUT_RESULT_BUCKET:-output-result-bucket}"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why such name?

can we follow the convention defined

Comment thread scripts/local-dev-setup.sh Outdated
CACHE_DIR="${CACHE_DIR:-tmp/cache}"
DATA_STORAGE_BUCKET="${DATA_STORAGE_BUCKET:-data-storage-bucket}"
DATA_INGESTION_BUCKET="${DATA_INGESTION_BUCKET:-data-ingestion-bucket}"
OUTPUT_RESULT_BUCKET="${OUTPUT_RESULT_BUCKET:-output-result-bucket}"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why we are introducing these variables in script, these should be part of yaml

this is defining them again, we can keep kind and namespace thing

echo "✓ Docling is already running"
else
echo "Starting Docling in the background..."
nohup docling-serve run --enable-ui > /tmp/docling.log 2>&1 &

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this will create dep to install this and not sure how it will work on other system, can we do via sh

--bucket "${DATA_INGESTION_BUCKET}" \
--notification-configuration "file://${NOTIFICATION_FILE}"
echo "✓ S3 bucket notification configured (queue ARN from LocalStack)"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what about ollama setup

Comment thread scripts/local-dev-setup.sh Outdated
echo "✓ S3 bucket notification configured (queue ARN from LocalStack)"

echo ""
echo "✓ Local development environment setup complete!"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dont we need to create create and controller config also, or we can do till make install and run

Comment thread DEVELOPMENT.md
```bash
make run
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

make local dev should cover till here i think, i will let @concaf chime in

Comment thread DEVELOPMENT.md Outdated

```yaml
apiVersion: operator.dataverse.redhat.com/v1alpha1
kind: SQSInformer

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this can be created also, as queue is getting created in script

Comment thread DEVELOPMENT.md Outdated
### Export Environment Variables

```bash
export IMG=<your-image-registry>/<image-name>:<tag>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we can take these variables as input and create controller config and secret also

Add  DEVELOPMENT.md guide covering the complete local development
workflow including LocalStack setup, CRD installation, controller
configuration, and e2e testing with required environment variables

Introduce make targets (local-dev-setup, local-dev-cleanup) with
corresponding shell scripts to automate local environment creation,
including S3 buckets, SQS queues, and Docling service setup.

Fix test-e2e target to pass KIND_CLUSTER and SKIP_CLUSTER_SETUP
environment variables, preventing duplicate cluster creation and
aligning local test execution with CI workflow.

Signed-off-by: Puneet Punamiya <ppunamiy@redhat.com>
@PuneetPunamiya
PuneetPunamiya force-pushed the adds-make-targers-for-local-setup branch from f940fad to 5541946 Compare June 5, 2026 12:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants