Add project

pull/7404/head
Kamran Ahmed 1 month ago
parent 8f8cca4be3
commit ea7b55cb64
  1. 3
      src/data/projects/iac-digitalocean.md
  2. 63
      src/data/projects/nodejs-service-deployment.md

@ -36,5 +36,4 @@ Write Ansible playbook that will configure the server. You can use the same play
<hr /> <hr />
Once you are done with the project, you should have a good understanding of setting up a basic infrastructure on DigitalOcean using Terraform and configuring it using Ansible. Once you are done with the project, you should have a good understanding of setting up a basic infrastructure on DigitalOcean using Terraform and configuring it using Ansible.

@ -0,0 +1,63 @@
---
title: 'Node.js Service Deployment'
description: 'Use GitHub Actions to Deploy a Node.js Service to a remote server'
isNew: false
sort: 10
difficulty: 'intermediate'
nature: 'CI/CD'
skills:
- 'nodejs'
- 'docker'
- 'devops'
seo:
title: 'Node.js Service Deployment'
description: 'Use GitHub Actions to Deploy a Node.js Service to a remote server'
keywords:
- 'Node.js'
- 'DigitalOcean'
- 'Docker'
roadmapIds:
- 'devops'
---
The goal of this project is to practice setting up a CI/CD pipeline for a Node.js service using GitHub Actions. You will practice using GitHub Actions for deployment (including Secrets and environment variables), Terraform to provision a server, Ansible to configure the server, and SSH to deploy the application.
## Requirements
If you haven't completed the previous projects for [Configuration Management](/projects/configuration-management) and [IaC](/projects/iac-digitalocean), you should do that first. You will be able to reuse the Ansible and Terraform code from those projects.
You are required to have the following setup:
- Setup a [DigitalOcean droplet using Terraform](/projects/iac-digitalocean)
- Setup the server using [Ansible](/projects/configuration-management) including installing Node.js and `npm`
- Create a simple Node.js service that just has a `/` route which returns `Hello, world!`
- Push the codebase to GitHub repository
Once you have the above setup, you are required to implement the following:
### Task #1: Manual Ansible Deployment
- Setup a role in ansible called `app` that will connect to the server, clone the repository, install the dependencies, build the application, and start the application.
- You should be able to run the playbook using the following command and the application should be up and running on port `80`:
```bash
ansible-playbook node_service.yml --tags app
```
- You should be able to access the application using the public IP address of the server.
### Task #2: Automate Deployment using GitHub Actions
Write a GitHub Action workflow that will deploy the application to the server using one of the following methods. You are welcome to try both options, but you are not required to do that. You are also welcome to use any other method to accomplish the same result.
#### Option #1: Run the playbook in GitHub Actions
Use the `ansible-playbook` command to run the playbook and deploy the application
#### Option #2: Use SSH to connect and deploy the application
Use SSH to connect and deploy the application. Look into [rsync](https://linux.die.net/man/1/rsync) and these GitHub Actions to accomplish this: [ssh-agent](https://github.com/webfactory/ssh-agent), [appleboy/ssh-action](https://github.com/appleboy/ssh-action).
<hr />
Once you have the application deployed, you should have a good understanding of automating the process of setting up a server and deploying an application to it.
Loading…
Cancel
Save