Pipery npm CD#

Repository: pipery-npm-cd
Release tag: v1
Catalog: /catalog/

Reusable GitHub Action for npm/Node.js CD — download package or image, deploy, and verify — with structured logging via Pipery.

Usage#

name: CD
on:
  push:
    branches: [main]

jobs:
  cd:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pipery-dev/pipery-npm-cd@v1
        with:
          package_name: my-app
          package_version: latest
          deploy_target: cloud-run
          cloud_run_service: my-service
          cloud_run_region: us-central1

Pipeline steps#

Step	Description	Skip input
Download	`npm pack` or `docker pull` the package/image	`skip_download`
Deploy	Deploy via ArgoCD, Cloud Run, Helm, or Ansible	`skip_deploy`
Status check	Verify deployment health	`skip_status_check`

Inputs#

Name	Default	Description
`package_name`	``	npm package name to download.
`package_version`	`latest`	npm package version.
`image_name`	``	Docker image to pull (alternative to npm package).
`image_tag`	`latest`	Docker image tag.
`project_path`	`.`	Path to the project source tree.
`config_file`	`.pipery/config.yaml`	Path to Pipery config file.
`deploy_target`	`argocd`	Deployment target: `argocd`, `cloud-run`, `helm`, or `ansible`.
`deploy_strategy`	`rolling`	Deployment strategy: `rolling`, `blue-green`, or `canary`.
`argocd_server`	``	ArgoCD server URL.
`argocd_app`	``	ArgoCD application name.
`argocd_token`	``	ArgoCD authentication token.
`cloud_run_service`	``	Cloud Run service name.
`cloud_run_region`	`us-central1`	Cloud Run region.
`cloud_run_image`	``	Container image to deploy to Cloud Run.
`helm_release`	``	Helm release name.
`helm_chart`	``	Helm chart path or reference.
`helm_namespace`	`default`	Kubernetes namespace.
`ansible_playbook`	``	Path to Ansible playbook.
`ansible_inventory`	``	Path to Ansible inventory.
`log_file`	`pipery.jsonl`	Path to the JSONL structured log file.
`skip_download`	`false`	Skip the download step.
`skip_deploy`	`false`	Skip the deploy step.
`skip_status_check`	`false`	Skip the post-deploy status check.

About Pipery#

Pipery is an open-source CI/CD observability platform. Every step script runs under psh (Pipery Shell), which intercepts all commands and emits structured JSONL events — giving you full visibility into your pipeline without any manual instrumentation.

Browse logs in the Pipery Dashboard
Find all Pipery actions on GitHub Marketplace
Source code: pipery-dev

Development#

# Run the action locally against test-project/
pipery-actions test --repo .

# Regenerate docs
pipery-actions docs --repo .

# Dry-run release
pipery-actions release --repo . --dry-run