Skip to content

Add GitHub Actions documentation for quickstart image #702

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link

@Copilot Copilot AI commented Jul 10, 2025

Adds comprehensive documentation for the GitHub Action introduced in PR #671, making it discoverable for developers who want to use the quickstart image in their CI/CD workflows.

What's Added

  • New "Using in GitHub Actions" section in README.md with:
    • Supported platforms (Linux, macOS Intel) and limitations
    • Basic usage example
    • Complete configuration options reference
    • Advanced health check settings
    • Real-world workflow example for smart contract testing

Usage Examples

Basic usage:

- name: Run Stellar quickstart
  uses: stellar/quickstart@main

With configuration:

- name: Run Stellar quickstart
  uses: stellar/quickstart@main
  with:
    network: "local"
    enable: "core,horizon,rpc"

Full workflow example for testing:

- name: Start Stellar network
  uses: stellar/quickstart@main
  with:
    network: "local"
    enable: "core,horizon,rpc"

- name: Run contract tests
  run: |
    # Services available at:
    # - Horizon: http://localhost:8000
    # - RPC: http://localhost:8000/rpc  
    # - Friendbot: http://localhost:8000/friendbot

The documentation covers all available inputs and provides clear guidance on platform support, making the action easily discoverable and usable.

Fixes #684.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

@Copilot Copilot AI changed the title [WIP] Add docs for quickstart GitHub Action Add GitHub Actions documentation for quickstart image Jul 10, 2025
@Copilot Copilot AI requested a review from sagpatil July 10, 2025 19:36
Copilot finished work on behalf of sagpatil July 10, 2025 19:36
@sagpatil sagpatil marked this pull request as ready for review July 10, 2025 19:37
@sagpatil sagpatil enabled auto-merge (squash) July 10, 2025 19:38
README.md Outdated
- name: Start Stellar network
uses: stellar/quickstart@main
with:
network: "local"
Copy link
Contributor

Choose a reason for hiding this comment

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

Should not list network and enable here because it uses default values anyway.
Otherwise very good description

README.md Outdated
Comment on lines 171 to 185
```yaml
- name: Run Stellar quickstart
uses: stellar/quickstart@main
with:
tag: "latest" # Image tag (default: "latest")
image: "docker.io/stellar/quickstart" # Image name (default: "docker.io/stellar/quickstart")
network: "local" # Network: local, testnet, futurenet (default: "local")
enable: "core,horizon,rpc" # Services to enable (default: "core,horizon,rpc")
enable_logs: "true" # Enable container logs (default: "true")
```

**Advanced Health Check Options:**
- `health_interval`: Time between health checks in seconds (default: "10")
- `health_timeout`: Maximum time for each health check in seconds (default: "5")
- `health_retries`: Number of consecutive failures before marking unhealthy (default: "50")
Copy link
Member

Choose a reason for hiding this comment

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

Move the advanced health check options into the yaml block describing each config option.

Copy link
Author

Choose a reason for hiding this comment

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

Moved the advanced health check options into the main YAML configuration block as requested. Commit 1bf7f9b

@Copilot Copilot AI requested a review from leighmcculloch July 10, 2025 21:20
Copilot finished work on behalf of leighmcculloch July 10, 2025 21:20
auto-merge was automatically disabled July 10, 2025 21:22

Head branch was pushed to by a user without write access

Copilot finished work on behalf of leighmcculloch July 10, 2025 21:23
@sagpatil sagpatil enabled auto-merge (squash) July 10, 2025 21:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Backlog (Not Ready)
Development

Successfully merging this pull request may close these issues.

Add docs for quickstart GitHub Action
4 participants