welcome to stacksmith! goals supported platforms ... · for aws: having an aws account connected...

Bitnami StacksmithEvaluator Guide

Welcome to Stacksmith!

An increasing number of companies are moving their applications to the cloud and container platforms. Public cloud is a cost effective and secure option for disaster recovery, while Kubernetes is becoming an excellent solution for migrating legacy applications.

Modernizing your DevOps pipeline to automate the application packaging for today's cloud and container platforms is a must.

Bitnami Stacksmith helps you package, optimize, and maintain your applications for quickly moving them to container and cloud platforms. It generates cloud images and deployment templates ready to be deployed natively to the cloud or container services.

It can be used both in new application development (as shown here) and in legacy applications to prepare them for replatforming from your datacenter to the cloud.

Bitnami | 900 Kearny Street, Suite 500, San Francisco, CA 94133-5100

M-xxxx-10/2018

Website: www.bitnami.com

Contact us: [email protected]

Advantages

Application-centric Approach

Stacksmith's application-centric approach emphasizes the orchestration of applications and associated processes, instead of an infrastructure-centric approach which looks at the world through the lens of machines to which software is connected.

Index

AdvantagesSupported PlatformsGoalsRequirementsGetting StartedStacksmith UI overviewNext UpPackage your application Maintain your application up to date What’s Next

https://bitnami.com/stacksmith

mailto:[email protected]


M-xxxx-10/2018



Continuous Maintenance

Stacksmith delivers monitoring, notifications, and a simple updating process to relieve the Ops burden and minimizes corporate risk / vulnerabilities.

Cloud and Format Agnostic

Stacksmith's uniform process of building containers and VM images in their assorted formats enables easy deployment on multiple clouds.

PluggableAs many companies already have existing tooling in place for artifact storage, CI/CD, testing and more, Stacksmith is pluggable into your existing tooling and workflows.

Addresses industry standards● Obtain immutable templates and images of your application

that follow cloud providers best practices and policies.● Simplify auditing, compliance, policy enforcement, and

security thanks to Stacksmith continuous monitoring for updates and security events.

Supported Platforms Stacksmith lets you build for multiple targets / formats at the same time, for when you need the same application running on different platforms.

Index




M-xxxx-10/2018



It builds the necessary deployment assets in the same packaging process:

● AWS: Cloud Formation Template (CFT).● Azure: Azure Resource Manager Template (ARM).● Azure Container Service: Docker container.● Kubernetes: Helm chart.

Goals

This guide shows you how to package a basic ToDo application made up of MongoDB, Express, Angular, and Node.js (MEAN) to deploy it on your preferred target platform. You can find the application in this GitHub repository.

Requirements

● Having a Bitnami account.● Being logged in to stacksmith.bitnami.com with your Bitnami

account.● For AWS: Having an AWS account connected with

Stacksmith. ● For Azure: Having an Azure account connected with

Stacksmith.● For Kubernetes: Having Docker, Helm, and the Kubernetes

command-line tool, kubectl, installed.

All the necessary dependencies are handled by npm. It requires some configuration to connect to the database. This configuration is in the Database.js file you can find in the sample GitHub repository.

Index



https://github.com/bitnami-labs/stacksmith-nodejs-with-nosql

https://bitnami.com/account/sign_up

https://stacksmith.bitnami.com/

https://stacksmith.bitnami.com/+/support/onboard-aws

https://stacksmith.bitnami.com/+/support/onboard-aws

https://stacksmith.bitnami.com/+/support/onboard-azure

https://stacksmith.bitnami.com/+/support/onboard-azure

https://www.docker.com/

https://helm.sh/

https://kubernetes.io/docs/user-guide/kubectl-overview/

https://github.com/bitnami-labs/stacksmith-nodejs-with-nosql/blob/master/app/config/database.js



M-xxxx-10/2018



Getting Started with Stacksmith

Stacksmith UI overviewStacksmith user interface is very easy to use. It has four key components that allow you to follow the Stacksmith workflow: package, deploy, migrate, and maintain your application code.

A- Project and user menu: Select the project in which you are working, create a new one, access Stacksmith documentation, and manage your user account from this menu. B- Project settings: Check the privacy of your project, configure the project and stack templates settings, or add a new application to your project just clicking the plus sign.

Index




M-xxxx-10/2018



Stacksmith UI overview

C- Applications dashboard: Have an overview of your packaged applications or package a new one from this dashboard.D- Support bar: Submit a ticket to contact the Stacksmith support team.

Next UpLet’s see how easy it is to start packaging an application on Stacksmith. Then, we will explore how to keep your application always up-to-date. To do so, we are going to upgrade your live MEAN application by adding new features and new versions of dependent packages to it.

Package your application with Stacksmith

1. Download application source files2. Package the application

Maintain your application up to date with Stacksmith

3. Update system dependencies4. Update application code

Index




M-xxxx-10/2018



Package your application with StacksmithAutomate packaging and optimize your application for container and cloud platforms with Stacksmith. It provides a set of “stack templates” that you can use to better suit your application requirements. In addition, Stacksmith will generate all the dependencies required by the different cloud platforms. That way, at the end of the packaging process you will have all deployable artifacts needed to launch your application in the target platform of your choice.

See below how easy it is to start packaging applications with Stacksmith.

Download application source files

To package an application with Stacksmith, it is necessary to upload the following application files:

● Application sources● Build script● Boot script● Run script

To get the application sources, use the following link: app.blue.tar.gz.Application scripts can be uploaded directly from the Git repository.

Index



https://github.com/bitnami-labs/stacksmith-examples/releases/download/v1/app.blue.tar.gz



M-xxxx-10/2018



Package the application

1. From the applications dashboard, click to package your application.

2. Fill the resulting form as follows:

● Introduce a name for your app, and a version tag.● Select the Node.js application with NoSQL DB (MongoDB)

stack template.● Select the target platforms you would like to package the app

for (you can select several).● Upload the application code files (app.blue.tar.gz). ● Select the Script Location as “Git repository”. ● Paste the Repository URL.● Set the Repository Reference as “master”.

Index



https://github.com/bitnami-labs/stacksmith-examples/releases/download/v1/app.blue.tar.gz



M-xxxx-10/2018



Index




M-xxxx-10/2018



3. Click Create and wait for the build to complete. 4. Navigate to the Log tab to see the logs of the build live!

5. Once the application is successfully built, you can launch your application in the selected target platforms or download the corresponding templates. Your deployed application should look like this when accessing it through a web browser:

Index




M-xxxx-10/2018



Output details and system packages

Need to go further? Stacksmith provides detailed information about the image, templates, and packages related to the recently packaged application. Let’s see how to check them:

● Navigate to the Details tab to find a summary of the outputs obtained after the process.

● Navigate to the System Packages tab to see a list of the packages included in the image.

Index




M-xxxx-10/2018



Maintain your application up to date with StacksmithNow that your MEAN application is live, understand that your application may need new features or bug fixes in the future. There are typically two types of updates you will want to perform: updating the application packages and / or updating your application code.

Find below how to maintain your application so that it is always secure and up-to-date with Stacksmith.

Index




M-xxxx-10/2018



Update system dependencies

Stacksmith also monitors the components of the packaged application for updates and security patches.

When the image gets outdated and new versions of the application packages are available, you can check them in the System Packages tab.

To update your application image with the latest dependencies, click the Repackage button.

That way, your application will be rebuilt with the same version of your codebase, but with fresh system packages.

Index




M-xxxx-10/2018



Update application code

To try the power of Stacksmith in maintaining your applications, we are going to generate a new version of the application code.

1. Download this tarball that contains some application code changes: app.orange.tar.gz 2. Click Edit configuration. You will see a form with the definition of the application already filled.

3. Change the version tag from 1 to 2.

4. Delete the previous version of the application files and upload the new ones.

5. Click Update and wait for the new version to be built. 6. The process of deploying the new version depends on the target platform you have selected. Your application now should show the counter colored in orange instead of in blue.

Index



https://github.com/bitnami-labs/stacksmith-examples/releases/download/v1/app.orange.tar.gz


M-xxxx-10/2018



Congratulations, you have successfully deployed a new version of your ToDo app!

What’s NextWe encourage you to package more applications and try with different templates by cloning any of the ready-to-fork repositories that Bitnami offers you at its GitHub Bitnami Labs repository.

You can also continue building your Stacksmith knowledge with the following resources:

Index



https://github.com/bitnami-labs/


M-xxxx-10/2018



Useful Guides

● Package and deploy applications on AWS● Package and deploy applications on Azure● Package and deploy applications on Kubernetes● Using a Git repository● How to choose a Stack Template● How to create a customized Stack Template

Videos and webinars

● Bitnami Stacksmith overview and live demonstration● Learn how to package and maintain your applications with Bitnami

Stacksmith● Package and Deploy Your Custom App with Stacksmith and

Optimize for the Cloud with Spotinst

White papers and datasheets

● Bitnami Stacksmith White Paper● Bitnami Stacksmith Datasheet ●

Stay tuned! New features are coming. See all the details at bitnami.com/stacksmith!

Index



https://stacksmith.bitnami.com/+/support/quickstart-aws

https://stacksmith.bitnami.com/+/support/quickstart-azure

https://stacksmith.bitnami.com/+/support/quickstart-k8s

https://stacksmith.bitnami.com/+/support/using-a-git-repository

https://stacksmith.bitnami.com/+/support/choosing-a-stack-template

https://stacksmith.bitnami.com/+/support/creating-a-stack-template

https://www2.bitnami.com/l/537302/2018-09-07/8gv8j

https://www.youtube.com/watch?v=YsTVxNFuXnc&t=102s

https://www.youtube.com/watch?v=YsTVxNFuXnc&t=102s

https://www.youtube.com/watch?v=zZJL8xk5bUk&t=1s

https://www.youtube.com/watch?v=zZJL8xk5bUk&t=1s

https://bitnami.com/downloads/whitepapers/Bitnami_Stacksmith.pdf

https://bitnami.com/downloads/whitepapers/Bitnami_Stacksmith_data_sheet.pdf

https://bitnami.com/stacksmith

welcome to stacksmith! goals supported platforms ... · for aws: having an aws account connected...

Documents