jotamartos / stacksmith-nodejs-with-nosql

This is a simple ToDo application to show how to deploy a MEAN application using Bitnami Stacksmith

MEAN ToDo Application

This is a simple ToDo application to show how to deploy a MEAN application using Bitnami Stacksmith

Package and deploy with Stacksmith

1. Go to stacksmith.bitnami.com.

2. Create a new application and select the Node.js with NoSQL DB (MongoDB) stack template.

3. Select the targets you are interested on (AWS, Kubernetes,...).

4. Compress the app/ folder from this repo and upload it as application files:

   git clone https://github.com/bitnami-labs/stacksmith-nodejs-with-nosql
   cd stacksmith-nodejs-with-nosql/todo
   tar czf app.blue.tar.gz app

You can also download app.blue.tar.gz from the releases page.

5. Select Git repository for the application scripts and paste the URL of this repo. Use master as the Repository Reference.
6. Click the Create button.
7. Wait for app to be built and deploy it in your favorite target platform.

Stacksmith will compare the latest commit for a reference (e.g. new commits made to a branch) against the last commit used during packaging. If there are any new commits available, these will be available to view within the Repository Details pane in the application history. If you choose to repackage your application, these newer commits will be incorporated and used during the packaging.

Update the application with Stacksmith

1. Change something on the app. As an example you can apply the patch change_color.patch that changes the color of the task counter:

   cd stacksmith-nodejs-with-nosql/todo
   git apply ./change_color.patch
   tar czf app.orange.tar.gz app

You can also download app.orange.tar.gz from the releases page.

2. Go to your app stacksmith.bitnami.com
3. Click on Edit configuration, delete app.blue.tar.gz and upload app.orange.tar.gz
4. Click Update.
5. Wait for the new version to be built and re-deploy it in your favorite target platform.

Stacksmith will use the latest Application Scripts from the GitHub repository.

Use the Stacksmith CLI for automating the process

1. Go to stacksmith.bitnami.com, create a new application and select the Node.js with NoSQL DB (MongoDB) stack template.

2. Install Stacksmith CLI and authenticate with Stacksmith.

3. Create a tarball with your application code. You can use the sample demo from releases:

   wget https://github.com/bitnami-labs/stacksmith-nodejs-with-nosql/releases/download/v1/app.blue.tar.gz

4. Edit the Stackerfile.yml, update the appId with the URL of your project and the name of userUploads.

5. Run the build for a specific target like aws or docker. E.g.

   stacksmith build --target docker

6. Wait for app to be built and deploy it in your favorite target platform.

Update the application via CLI

1. Change the app and build a new tarball. You can use the second example from releases:

   wget https://github.com/bitnami-labs/stacksmith-nodejs-with-nosql/releases/download/v1/app.orange.tar.gz

2. Update the version and the tarball name in the Stackerfile.yml.

3. Run the build for a specific target like aws or docker. E.g.

   stacksmith build --target docker

4. Wait for the new version to be built and re-deploy it in your favorite target platform.

Scripts

In the stacksmith/user-scripts folder, you can find the required scripts to build and run this application:

build.sh

This script takes care of installing the application and its dependencies. It performs the next steps:

• Adds the system user that will run the application.
• Uncompress the application code to the /opt/app folder.
• Adjust the application files permissions.
• Install dependencies.

boot.sh

This script takes care of configuring the application.

run.sh

This script just starts the application with the proper user.