Installation Instructions for macOS

In this chapter, we will learn how to set up the tools required to run the commands described in this book on macOS. We will also learn how to get access to the source code of the book.

The following topics will be covered in this chapter:

• Technical requirements
• Installing tools
• Accessing the source code

If you are using a Windows PC, you should follow the instructions in Chapter 22, Installation Instructions for Microsoft Windows with WSL 2 and Ubuntu.

Technical requirements

All of the commands described in this book are run on a MacBook Pro with macOS Ventura and use bash, a command shell. All commands have been verified on both an Intel and Apple silicon-based MacBook Pro.

If you are using another shell, such as zsh, I recommend that you switch to bash before running commands from this book using this command:

/bin/bash

Installing tools

In this section, we will learn how to install and configure the tools. Here is a list of the tools we will install, with a link to more information on downloading and installation, if required:

• Git: https://git-scm.com/downloads
• Docker Desktop for Mac: https://hub.docker.com/editions/community/docker-ce-desktop-mac/
• Java: https://adoptium.net/installation
• curl: https://curl.haxx.se/download.html
• jq: https://stedolan.github.io/jq/download/
• The Spring Boot CLI: https://docs.spring.io/spring-boot/docs/3.0.4/reference/html/getting-started.html#getting-started.installing.cli
• Siege: https://github.com/JoeDog/siege#where-is-it
• Helm: https://helm.sh/docs/intro/install/
• kubectl: https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/
• Minikube: https://minikube.sigs.k8s.io/docs/start/
• Istioctl: https://istio.io/latest/docs/setup/getting-started/#download

The following versions have been...

Accessing the source code

The source code for this book can be found in the GitHub repository: https://github.com/PacktPublishing/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition.

To be able to run the commands that are described in this book, download the source code to a folder and set up an environment variable, $BOOK_HOME, that points to that folder.

Sample commands are as follows:

export BOOK_HOME=~/Documents/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition 
git clone https://github.com/PacktPublishing/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition.git $BOOK_HOME

The Java source code is written for Java SE 8 and uses a Java SE 17 JRE when executed in Docker containers. The following versions of Spring are used:

• Spring Framework: 6.0.6
• Spring Boot: 3.0.4
• Spring Cloud: 2022.0.1

The code examples in each chapter all come from the source code in $BOOK_HOME/ChapterNN, where NN is the number...

Summary

In this chapter, we learned how to install, configure, and verify the tools required to run the commands described in this book on macOS. For development, we will use git, docker, java, and spring. To create a Kubernetes environment to deploy our microservice at runtime, we will use minikube, helm, kubectl, and istioctl. Finally, to run tests to verify that the microservices work as expected at runtime, we will use curl, jq, and siege.

We also learned how to access the source code from GitHub and how the source code is structured.

In the next chapter, we will learn how to set up the same tools in an environment based on Microsoft Windows with Windows Subsystem for Linux v2 (WSL 2), where we will use a Linux server based on Ubuntu.