DEV Community: s-vamshi

🚀 Deploying Spring Boot Microservices using Cyclops ☸️⚓

s-vamshi — Tue, 06 Aug 2024 11:51:35 +0000

Hello folks,

Let me quickly introduce you guys about Cyclops before we start.

What is Cyclops?

Cyclops is a web-based tool designed to simplify the containerization process of apps in Kubernetes. Cyclops gives as an intuitive web form where we can configure our app seamlessly and also it provides us a dashboard where we can view all our pods, deployments, services. Moreover, it provides us key metrics like cluster's performance, resource utilization and health. It helps us to onboard quickly without spending much time on configuring things.

GitHub Link: https://github.com/cyclops-ui/cyclops

Now that you know about Cyclops, let's dive in by deploying Spring Boot Microservices in Cyclops.

Setting up Cyclops Locally
Creating Microservices and Deploying to Cyclops
How I Contributed to Cyclops

Setting up Cyclops Locally

We need a Kubernetes Cluster to try out Cyclops. If you don't have one you can install MiniKube which provides use local kubernetes cluster. For more details on installation process, click here.
Now that Minikube is installed, let's start it!
```
minikube start
```

Now we need to install Cyclops into our cluster, to do that run below command:

kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/cyclops/v0.8.2/install/cyclops-install.yaml
kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/cyclops/v0.8.2/install/demo-templates.yaml

To access Cyclops outside of the cluster, run the below command:
```
kubectl port-forward svc/cyclops-ui 3000:3000 -n cyclops
```
Now when you hit localhost:3000 in your browser, it shows you
cyclops-ui!

Creating Microservices and Deploying to Cyclops

I have created a student service which communicates with library service using rest template, repo link

Dockerfile of student service is as below

FROM openjdk:17-jdk-alpine
WORKDIR /studentService
COPY target/studentService-0.0.1-SNAPSHOT.jar studentService.jar
EXPOSE 8090
ENTRYPOINT ["java", "-jar", "studentService.jar"]

Dockerfile of library service is as below

FROM openjdk:17-jdk-alpine
WORKDIR /libraryService
COPY target/libraryService-0.0.1-SNAPSHOT.jar libraryService.jar
EXPOSE 8090
ENTRYPOINT ["java", "-jar", "libraryService.jar"]

Now we will build the images of both the services by checking out to each service folder where Dockerfile is present:
```
docker build -t student-service .
docker build -t library-service .
```

Let's tag this images and push to docker hub!

docker tag student-service your-dockerhub-username/student-service:latest
docker tag library-service your-dockerhub-username/library-service:latest
docker push your-dockerhub-username/student-service:latest
docker push your-dockerhub-username/library-service:latest

To deploy this services we generally define Deployment and Service YAML files. But here Cyclops comes into play and does that for us. We just need to create modules and wait for it to be up and running!
Now that we deployed microservices to Cyclops, we should also be able to access them from our browser and to do that forward the ports!
```
kubectl port-forward svc/student-service 8091:8091
kubectl port-forward svc/library-service 8092:8092
```

How I Contributed to Cyclops

Cyclops team has opened issues(features/bugs) on their GitHub Repository for us to built Cyclops together!

And issues on which I worked were:

Broken links in deployed modules

After creating a modules, the module card shows repo and path link. Now, this when path link was clicked it used to take use to broken Github link by eating current page.
Solution:
I have made changes such that when path link is clicked it opens in a new tab. And also, broken path link was fixed by using resolvedVersion _in url if present, if not then by using _version _ else using _main.
Enhancing Node Conditions card

Nodes page used to show the status of the node when clicked on details of specific node.
Solution:
I have also added lastHeartbeatTime, lastTransitionTime, and message of a particular condition of the node

Running Swirl Search🌌in an instant on Gitpod🌐💻and GitHub Codespaces🌩️🚀

s-vamshi — Sun, 15 Oct 2023 06:51:40 +0000

Hello folks,

Let me quickly introduce you guys about Swirl before we start.

What is Swirl?

Swirl is an open-source search engine which is built using Python and Django. Things which makes Swirl more special is that individual developers and organizations can use Swirl without paying single penny and even customize the search results by connecting to Database (E.g. SQL, NoSQL), Public Data Services (E.g. Google) and Enterprise Sources (E.g. Jira).

GitHub Link: https://github.com/swirlai/swirl-search

Now that you know about Swirl, let's try and explore Swirl using Cloud IDE.

Setting up Swirl using Gitpod
Setting up Swirl using GitHub Codespaces
Contributing to Swirl Community using Cloud IDE

Setting up Swirl using Gitpod

Click on below button to Configure New Workspace in Gitpod
Alternatively, you can open Swirl Repo and prefix Swirl Repo URL with https://gitpod.io/new/# after which it looks something like this https://gitpod.io/#https://github.com/swirlai/swirl-search/tree/develop

NOTE: Throughout this tutorial we will be working with Gitpod on the develop branch as per contribution guidelines of Swirl. If you intend to use the main branch, please use the following URL: https://gitpod.io/#https://github.com/swirlai/swirl-search/.
After opening the URL, we will see page as shown below:
Click on continue button to create and initialize Swirl Workspace.
We will observe that browser version of VScode getting configured. And in terminal, this command docker-compose pull && docker-compose up will start running.
After few seconds, we can observe INFO Listening on TCP 0.0.0.0:8000 log in the terminal.
Now our server is ready to serve the incoming requests on port 8000, as we are using Gitpod it will generates a dynamic URL for accessing content on port 8000 instead of localhost:8000 as we would in local development environment.
To open this URL in browser, we can click on open browser button through notifications popup as shown below:
Alternatively, we can navigate to PORTS tab next to Terminal and click on link provided in the Address column for Port 8000.
Oops, we encountered an error,
let's check terminal logs to know more about error in VScode
Seems like the dynamic URL which Gitpod generated is not allowed to request our server.
Now we need to make sure that our server accepts requests from our dynamic URL, we can fix this by creating .env file
.env file should be created in root directory of the project as shown below:

And add this line in .env file ALLOWED_HOSTS=localhost,127.0.0.1,** in ALLOWED_HOSTS mean is that we are allowing every host to access our server.
Now that we created .env file, we need to inform docker to use this configuration.
Open docker-compose.yaml and add following line at the end:

    env_file:
      - .env

This is how it looks after we add above lines

As we have changed docker-compose.yaml we need to restart our server for changes to reflect.
To stop the server press CTRL+C key.
To start the server enter docker-compose pull && docker-compose up command in terminal.
Follow Steps 4-6 to check if the URL is working.

NOTE: While committing changes do not stage docker-compose.yaml file.

Setting up Swirl using GitHub Codespaces

Click on below link to open Swirl Repository in develop branch https://github.com/swirlai/swirl-search/tree/develop. NOTE: We will be working with GitHub Codespaces on the develop branch as per contribution guidelines of Swirl. If you intend to use the main branch, please use the following URL: https://github.com/swirlai/swirl-search/.
To create New Codespace on develop branch follow below steps:
1. Click on Code button, which will open dropdown menu containing two tabs in it, namely Local and Codespaces.
2. Then select Codespaces tab.
3. Finally, click on the Create codespace on develop button to initiate the creation of codespace.
We will observe that browser version of VScode getting configured. In the terminal, the installation of pip and others requirements will start. After which docker-compose pull && docker-compose up command will start running.
Now inorder to view logs of the server, press CTRL+SHIFT+P key to open command palette and then search for View Creation log. We can notice new terminal with logs of our server.
After few seconds, we can observe INFO Listening on TCP 0.0.0.0:8000 log in the terminal.
Now our server is ready to serve the incoming requests on port 8000, as we are using GitHub Codespaces it will generates a dynamic URL for accessing content on port 8000 instead of localhost:8000 as we would in local development environment. We can navigate to PORTS tab next to Terminal and click on browser icon after hovering on link provided in the Address column for Port 8000.
In browser, you can observe Swirl login page with Username and Password fields. Enter Username as admin and Password as Password

Contributing to Swirl Community using Cloud IDE

Using Codespaces

Create a new terminal by clicking on + button.
Enter git fetch command to get changes from remote repo.
Now that you are will to contribute to Swirl we need create a new branch and switch to it, to do this use git checkout -b your-branch-name.
Do the changes accordingly and to check which files you created/modified use git status.
To stage all the changes use git add . and to commit the changes use git commit -m "your commit message".
You will see a warning that you don't have write access to swirl repo and to get access we need to create a fork. Github will create use fork after we enter y for Would you like to proceed question.
To push the branch with changes use git push origin your-branch-name. After successfully pushing the changes you will get URL in terminal to create pull request(PR), copy it and paste in new tab.
By default base repository comparing branch is main change it to develop branch by clicking on it.
Finally edit the PR template accordingly based on your changes.

Using Gitpod

Create a new terminal by clicking on + button.
Enter git fetch command to get changes from remote repo.
Now that you are will to contribute to Swirl we need create a new branch and switch to it, to do this use git checkout -b your-branch-name.
Do the changes accordingly and to check which files you created/modified use git status. NOTE: Do not stage docker-compose.yaml file.
To stage all the changes use git add . and to unstage docker-compose.yaml file use git reset -- docker-compose.yaml and to commit the changes use git commit -m "your commit message".
To push the changes, we need to grant GitHub access for Gitpod by following below steps:
1. Navigate to Source Control by clicking on git logo on side panel.
2. Finally, click on horizontal three-dots button.
3. Click on push button in the dropdown.
4. We will get a popup about remote repo, now click on ok to publish newly created branch as shown below
5. We will get another popup whether to create fork of the repository click on Create_Fork.
6. Allow GitHub extension to sign in.
7. Click on Open Access Control button in the Grant permissions notifications.
8. A new tab will open, displaying Gitpod User settings.
9. Click on three vertical dots button present in GitHub row to edit permissions.
10. Now checkmark on read:user,repo and workflow and click on update permissions.
11. Now enter git push origin your-branch-name. From here follow Steps 7-9 from Contribution using Codespaces

Conclusion

With the help of Gitpod and GitHub Codespaces we were able to run instantly Swirl Search with minimal commands and without the need of any installation.

Special Mentions: Thank you @srbhr for your support and guidance.

GitHub: GitHub Repository🧑‍💻

Slack Community: Swirl Slack Community💬📢

Twitter: Follow Swirl on Twitter/𝕏