appdrag CLI
A CLI tool for Appdrag, deploy your full-stack apps to the cloud. Work with your local tools (VS Code, Atom, ...) and build process, then push your compiled code to your app in appdrag
This tool is recommended for:
- Develop locally with your usual tools (VS Code, Atom, ...) and build process (Webpack, ...)
- Setup a CI/CD pipeline
- Setup an external backup of your app
- Export/Import full-stack projects
Installation
Install with
npm install -g appdrag
Commands
appdrag-cli
Usage : appdrag command <args> [-options]
or
appdrag [-options] command <args>
Options list :
-a [APPID]
Input your appId directly in the command line instead of using init.
-t [TOKEN]
Input your token directly in the command line instead of using login.
-i [SUFFIX]
(fs pull specific) Only pulls files with the specified suffix.
-e [SUFFIX]
(fs pull specific) Exclude files with the specified suffix from bein pulled.
--skip-existing-files
(fs pull specific) Skip files already existing in your filesystem.
Available commands :
Setup
appdrag login Login to our service
appdrag init <app-id> Link folder with your app-id
Filesystem
appdrag fs pull <source-folder> Pull folder from SERVER to LOCAL
appdrag fs push <folder-to-push> <opt: dest> Push folder from LOCAL to SERVER
Database - CloudBackend
appdrag db pull Retrieve .sql file of your database from SERVER to LOCAL
appdrag db push <sql-file> Restore the database on SERVER from the LOCAL .sql backup provided
Api - CloudBackend
api pull <opt: function_id> Pull all (or one) function(s) of your CloudBackend to LOCAL
api push <opt: function_id> Push all (or one) function(s) from LOCAL to your CloudBackend
Export
export <path> Export your project to the specified folder
Help
help Display this help text
Usage examples
After logging-in through our login command or using the -t flag, and setting up your appId with -a or with init. You will be able to use the CLI.
Here are some examples to help you through the process.
Pulling only files ending by ".js" in the root folder of your appdrag app.
appdrag fs pull -i .js.
Pulling specific functions using a Function Id
appdrag api pull FUNCTION_ID
To be able to find your function ID you simply need to visit the specific function in your cloudbackend and look at the URL. It will look like this : https://prod.appdrag.com/cloudbackend.html?appId=YOUR_APP_ID#FUNCTION_ID Simply copy the function ID after the '#', and paste it into your command.
Pushing specific folder from your local files into your project
appdrag fs push YOUR_FOLDER
Our CLI will create a zip of our folder and push it to the root of your appdrag project.
Pushing specific folder from your local files into a specific folder in your project
appdrag fs push YOUR_FOLDER DESTINATION_FOLDER
Setting up continuous delivery from development project A to production project B
Import API Functions from project A:
appdrag -a dev-project-a -t USER_API_TOKEN api pull
Push API Functions to production project B:
appdrag -a prod-project-b -t USER_API_TOKEN api push
Up to date functions on the production project won't be updated if their last update date are greater or equal to the ones on the dev project on AppDrag. If you do changes locally, don't forget to push it on the dev project before pushing to the production, if not, updates will be skipped.