PHPackages                             adexyme/deploy-tagged-release - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. adexyme/deploy-tagged-release

ActiveLibrary[DevOps & Deployment](/categories/devops)

adexyme/deploy-tagged-release
=============================

Laravel CLI command to deploy a tagged release with custom schema (optional).

v1.0.2(12mo ago)010MITPHPPHP ^8.0

Since May 13Pushed 12mo ago1 watchersCompare

[ Source](https://github.com/Adexyme/deploy-tagged-release)[ Packagist](https://packagist.org/packages/adexyme/deploy-tagged-release)[ RSS](/packages/adexyme-deploy-tagged-release/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (4)Used By (0)

📦 Laravel Package: DeployTaggedRelease
======================================

[](#-laravel-package-deploytaggedrelease)

Overview
--------

[](#overview)

DeployTaggedRelease is a Laravel Artisan command designed to:

- Deploy a specific **Git tag** from a configured repository.
- Install dependencies using **Composer** after pulling the code.
- Optionally **create missing tables and columns** in the database (without affecting existing structure).
- Use a **GitHub personal access token** for authenticated repo access.
- Avoid Laravel’s migration system — ideal for rapid deployment or staging setups.

✅ Features
----------

[](#-features)

- Deploy from any GitHub (or Git) repo using a Git tag.
- Specify schema updates inline without needing migrations.
- Auto-create tables if missing.
- Auto-add columns if not present (but never alter or drop anything).
- Use current DB connection if not overridden.
- Full configuration via config/deploy.php.

📦 Installation
--------------

[](#-installation)

### 1. Require via Composer

[](#1-require-via-composer)

bash

CopyEdit

composer require your-vendor/deploy-tagged-release

Replace your-vendor/deploy-tagged-release with your actual Packagist package name once published.

### 2. Register the Service Provider (if not auto-discovered)

[](#2-register-the-service-provider-if-not-auto-discovered)

In config/app.php:

php

CopyEdit

'providers' => \[

// ...

YourVendor\\DeployRelease\\DeployTaggedReleaseServiceProvider::class,

\],

### 3. Publish Configuration File

[](#3-publish-configuration-file)

bash

CopyEdit

php artisan vendor:publish --tag=deploy-config

This creates a config file at:

arduino

CopyEdit

config/deploy.php

⚙️ Configuration
----------------

[](#️-configuration)

In config/deploy.php, define your deployment parameters:

php

CopyEdit

return \[

// Remote Git repository URL

'repo' => env('DEPLOY\_REPO', ''),

// Local path to clone/pull the repo into

'path' => env('DEPLOY\_PATH', base\_path('deployed')),

// Optional: Name of database to use (leave null to use current DB)

'db' => env('DEPLOY\_DB', null),

// Optional: GitHub personal access token for private repos

'token' => env('DEPLOY\_GIT\_TOKEN', null),

\];

Place your GitHub token in .env as DEPLOY\_GIT\_TOKEN=ghp\_xxxxxxxx.

🚀 Usage
-------

[](#-usage)

### Basic Command

[](#basic-command)

bash

CopyEdit

php artisan deploy:tagged-release {tag} \[--schema=...\]

- {tag}: Git tag to deploy (e.g., v1.0.2)
- --schema: Optional semicolon-separated schema definition string.

### Examples

[](#examples)

#### ✅ Deploy a Tag Only

[](#-deploy-a-tag-only)

bash

CopyEdit

php artisan deploy:tagged-release v1.0.0

- Clones or pulls the repo
- Checks out tag v1.0.0
- Installs composer dependencies
- Uses current DB
- Skips schema creation

#### ✅ Deploy with Table Creation

[](#-deploy-with-table-creation)

bash

CopyEdit

php artisan deploy:tagged-release v1.1.0 \\

\--schema="users:id:integer,name:string,email:string;posts:id:integer,title:string,body:text"

- If users or posts tables do not exist, they are created.
- If they exist, new columns are added (but existing columns remain untouched).
- Fields use Laravel column types: string, integer, text, boolean, timestamp, etc.

#### ✅ With Custom DB and Private Repo

[](#-with-custom-db-and-private-repo)

In your .env:

env

CopyEdit

DEPLOY\_REPO=

DEPLOY\_DB=staging\_db

DEPLOY\_PATH=/var/www/releases

DEPLOY\_GIT\_TOKEN=ghp\_yourTokenHere

Then run:

bash

CopyEdit

php artisan deploy:tagged-release v2.0.1 --schema="logs:id:integer,message:string"

🛠 Schema Syntax Details
-----------------------

[](#-schema-syntax-details)

Each --schema entry follows this format:

lua

CopyEdit

table:col:type,col:type;table2:col:type

Example:

bash

CopyEdit

php artisan deploy:tagged-release v3.0.0 \\

\--schema="products:id:integer,name:string,price:integer;orders:id:integer,product\_id:integer,quantity:integer"

💡 Notes
-------

[](#-notes)

- This package **does not use Laravel migrations**.
- It **does not drop or modify existing columns**.
- It is ideal for quick deployments, CI/CD pipelines, and staging automation.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance50

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

362d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3cc8a05f35fa85716288373d67d0d8520b7eda739c8d73c4883f7082048b6ebf?d=identicon)[Adexyme](/maintainers/Adexyme)

---

Top Contributors

[![Adexyme](https://avatars.githubusercontent.com/u/41364653?v=4)](https://github.com/Adexyme "Adexyme (8 commits)")

### Embed Badge

![Health badge](/badges/adexyme-deploy-tagged-release/health.svg)

```
[![Health](https://phpackages.com/badges/adexyme-deploy-tagged-release/health.svg)](https://phpackages.com/packages/adexyme-deploy-tagged-release)
```

###  Alternatives

[timokoerber/laravel-one-time-operations

Run operations once after deployment - just like you do it with migrations!

6481.7M11](/packages/timokoerber-laravel-one-time-operations)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)[sammyjo20/lasso

Lasso - Asset wrangling for Laravel made simple.

355347.9k](/packages/sammyjo20-lasso)[stechstudio/laravel-env-security

Securely manage .env files for different deployment environments

77116.4k1](/packages/stechstudio-laravel-env-security)[aaronfrancis/airdrop

A Laravel package to deploy your application faster by skipping asset compilation when possible.

19594.9k](/packages/aaronfrancis-airdrop)[richdynamix/arc

Production ready docker based development environment for your Laravel project.

1163.1k](/packages/richdynamix-arc)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)