# Spring PetClinic

import { Tabs, TabsContent, TabsList, TabsTrigger } from "zudoku/ui/Tabs"

{/* vale off */}
{/* THIS FILE WAS AUTOGENERATED FROM THE PUBLIC EXAMPLE REPOSITORY. DO NOT EDIT THIS FILE DIRECTLY. */}


[Spring PetClinic](https://github.com/spring-projects/spring-petclinic) is an example project that uses Spring boot to model a simple pet clinic.

To run this example, follow these steps:

1. Install the [unikraft CLI](/cli).
   You need a [BuildKit](https://github.com/moby/buildkit) builder. The easiest way to get one is via [Docker](https://docs.docker.com/engine/install/).
   Alternatively, you can also directly set up and use BuildKit, see the [quick start](https://github.com/moby/buildkit#quick-start).

2. Clone the [`examples` repository](https://github.com/unikraft-cloud/examples) and `cd` into the `examples/httpserver-java17-spring-petclinic/` directory:

   ```bash
   git clone https://github.com/unikraft-cloud/examples
   cd examples/httpserver-java17-spring-petclinic/
   ```

Make sure to log into Unikraft Cloud and pick a [metro](/platform/metros) close to you.
This guide uses `fra` (Frankfurt, 🇩🇪):

```bash
unikraft login
```

When done, invoke the following command to deploy this app on Unikraft Cloud:

```bash
unikraft build . --output <my-org>/httpserver-java17-spring-petclinic:latest
unikraft run --metro fra \
  -m 1G \
  -p 443:8080/tls+http \
  --scale-to-zero policy=idle,cooldown-time=1000,stateful=true \
  --image <my-org>/httpserver-java17-spring-petclinic:latest
```

The output shows the instance address and other details:

```ansi
[1mmetro[22m:        fra
[1mname[22m:         httpserver-java17-spring-petclinic-r4s3x
[1muuid[22m:         5a3b7e2c-1f4d-4a8e-b6c9-2d3f8a1e7b4c
[1mstate[22m:        [38;2;144;161;185mstarting[0m
[1mimage[22m:        <my-org>/httpserver-java17-spring-petclinic
[1mresources[22m:
[3m  memory[23m:     1024MiB
[3m  vcpus[23m:      1
[1mservice[22m:
[3m  uuid[23m:       f4c2b1a0-3e5d-8b7a-9c6d-1e2f3a4b5c6d
[3m  name[23m:       bitter-dust-a7b2c3d4
[3m  domains[23m:
[3m  - fqdn[23m:     bitter-dust-a7b2c3d4.fra.unikraft.app
[1mnetworks[22m:
[3m- uuid[23m:       7d6e5f4a-3b2c-1d0e-9f8a-7b6c5d4e3f2a
[3m  private-ip[23m: 10.0.4.2
[3m  mac[23m:        12:b0:4a:1c:8f:73
[1mtimestamps[22m:
[3m  created[23m:    just now
```

In this case, the instance name is `httpserver-java17-spring-petclinic-r4s3x` and the address is `https://bitter-dust-a7b2c3d4.fra.unikraft.app`.
They're different for each run.

After deploying, point your browser to the provided URL.

You can list information about the instance by running:

```bash
unikraft instances list
```

```ansi
[1mMETRO[22m  [1mNAME[22m                                      [1mSTATE[22m    [1mIMAGE[22m                                        [1mARGS[22m  [1mMEMORY[22m   [1mVCPUS[22m  [1mFQDN[22m                                   [1mCREATED[22m
fra    httpserver-java17-spring-petclinic-r4s3x  [38;2;0;188;125mrunning[0m  <my-org>/httpserver-java17-spring-petclinic        1024MiB  1      bitter-dust-a7b2c3d4.fra.unikraft.app  2 minutes ago
```

When done, you can remove the instance:

```bash
unikraft instances delete <instance-name>
```

## Learn more

- [Spring Boot Reference](https://docs.spring.io/spring-boot/docs/current/reference/html/)
- [Unikraft Cloud's Documentation](https://unikraft.cloud/docs/)
- [Building `Dockerfile` Images with `Buildkit`](https://unikraft.org/guides/building-dockerfile-images-with-buildkit)


Use the `--help` option for detailed information on using Unikraft Cloud:

```bash
unikraft --help
```

Or visit the [CLI Reference](/cli/unikraft).
{/* vale on */}
