Merge pull request #9 from ibm-cloud-architecture/bck-updates

Bck updates
ibm-cloud-architecture · Jan 3, 2025 · e82e60f · e82e60f
2 parents 5cf699c + 2172dc5
commit e82e60f
Show file tree

Hide file tree

Showing 4 changed files with 127 additions and 114 deletions.
diff --git a/docs/cloud-native/app-dev.md b/docs/cloud-native/app-dev.md
@@ -82,18 +82,18 @@ If you keep deploying new services without cleaning up the old ones which are in
 
 ## Twelve factor design methodology
 
-- *Code base* - One code base tracked in revision control, many deploys.
-- *Dependencies* - Explicitly declare and isolate dependencies.
-- *Config* - Store config in the environment.
-- *Backing services* - Treat backing services as attached resources.
-- *Build, release, run* - Strictly separate build and run stages.
-- *Processes* - Execute the app as one (or more) stateless process(es).
-- *Port binding* - Export services through port binding.
-- *Concurrency* - Scale-out through the process model.
-- *Disposability* - Maximize robustness with fast startup and graceful shutdown.
-- *Dev/prod parity* - Keep development, staging, and production as similar as possible.
-- *Logs* - Treat logs as event streams.
-- *Admin processes* - Run admin/management tasks as one-off processes.
+- _Code base_ - One code base tracked in revision control, many deploys.
+- _Dependencies_ - Explicitly declare and isolate dependencies.
+- _Config_ - Store config in the environment.
+- _Backing services_ - Treat backing services as attached resources.
+- _Build, release, run_ - Strictly separate build and run stages.
+- _Processes_ - Execute the app as one (or more) stateless process(es).
+- _Port binding_ - Export services through port binding.
+- _Concurrency_ - Scale-out through the process model.
+- _Disposability_ - Maximize robustness with fast startup and graceful shutdown.
+- _Dev/prod parity_ - Keep development, staging, and production as similar as possible.
+- _Logs_ - Treat logs as event streams.
+- _Admin processes_ - Run admin/management tasks as one-off processes.
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/jufe_sHejXc" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
@@ -151,6 +151,6 @@ We discussed the cloud-native application design, implementations of cloud nativ
 
 ## References
 
-- https://learning.oreilly.com/library/view/managing-cloud-native/9781492037071/[Justin Garrison, Kris Nova, (2018). Managing cloud native applications. Publisher: O'Reilly Media, Inc.]
-- https://learning.oreilly.com/library/view/cloud-native-architectures/9781787280540/[Piyum Zonooz, Erik Farr, Kamal Arora, Tom Laszewski, (2018). Cloud Native Architectures. Publisher: Packt Publishing]
-- https://12factor.net/codebase[12factor.net]
+- [Justin Garrison, Kris Nova, (2018). Managing cloud native applications. Publisher: O'Reilly Media, Inc.](https://learning.oreilly.com/library/view/managing-cloud-native/9781492037071)
+- [Piyum Zonooz, Erik Farr, Kamal Arora, Tom Laszewski, (2018). Cloud Native Architectures. Publisher: Packt Publishing](https://learning.oreilly.com/library/view/cloud-native-architectures/9781787280540)
+- [12factor.net](https://12factor.net/codebase)
diff --git a/docs/containers/index.md b/docs/containers/index.md
@@ -40,9 +40,9 @@ There are many different container standards available today. Some of them are a
 
 Among them, Docker was one of the most popular mainstream container software tools.
 
-***Open Container Initiative (OCI)***
+!!! info "Open Container Initiative (OCI)"
 
-A Linux Foundation project developing a governed container standard. Docker and Rocket are OCI-compliant. But, Garden is not.
+    A Linux Foundation project developing a governed container standard. **Docker** and **Rocket** are OCI-compliant. But, **Garden** is not.
 
 ## Benefits
 
@@ -52,10 +52,12 @@ A Linux Foundation project developing a governed container standard. Docker and
 - Portable
 - Supports agile development
 
-To know more about Containerization, we have couple of guides. Feel free to check them out.
+???+ note "Containerization Guides"
 
-- [Containerization: A Complete Guide](https://www.ibm.com/cloud/learn/containerization).
-- [Containers: A Complete Guide](https://www.ibm.com/cloud/learn/containers).
+    To know more about Containerization, we have couple of guides. Feel free to check them out.
+
+    - [Containerization: A Complete Guide](https://www.ibm.com/cloud/learn/containerization).
+    - [Containers: A Complete Guide](https://www.ibm.com/cloud/learn/containers).
 
 ## Docker
 
@@ -81,28 +83,37 @@ These images are build from the `Dockerfile`.
 - It specifies the operating system.
 - It also includes things like environmental variables, ports, file locations etc.
 
-If you want to try building docker images, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/) (Interactive Learning Platform).
+???+ note "Interactive Learning"
+
+    If you want to try building docker images, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/){target="_blank"} (Interactive Learning Platform).
 
-- [Building Container Images](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video4_2/) -  Estimated Time: 12 minutes.
+    - [Building Container Images](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video4_2/){target="_blank"} - Estimated Time: 12 minutes.
 
 ### Docker Container
 
 The standard unit where the application service is located or transported. It packages up all code and its dependencies so that the application runs quickly and reliably from one computing environment to another.
 
-If you want to try deploying a docker container, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video4_2/#t11m27s) (Interactive Learning Platform).
+???+ note "Interactive Learning"
+
+    If you want to try deploying a docker container, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/){target="_blank"} (Interactive Learning Platform).
+
+    - [Deploying a Docker Container](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video4_2/#t11m27s){target="_blank"}
 
 ### Docker Engine
 
 Docker Engine is a program that creates, ships, and runs application containers. The engine runs on any physical or virtual machine or server locally, in private or public cloud. The client communicates with the engine to run commands.
 
-If you want to learn more about docker engines, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video7_1/)
+???+ note "Interactive Learning"
+
+    If you want to learn more about docker engines, try this course on [O'Reilly](https://learning.oreilly.com/videos/docker-for-the/9781788991315/){target="_blank"} (Interactive Learning Platform).
+
+    - [Docker Networking](https://learning.oreilly.com/videos/docker-for-the/9781788991315/9781788991315-video7_1/){target="\_blank"}
 
 ### Docker Registry
 
 The registry stores, distributes, and shares container images. It is available in software as a service (SaaS) or in an enterprise to deploy anywhere you that you choose.
 
-**Docker Hub** is a popular registry. It is a registry which allows you to download docker images which are built by different communities. You can also store your own images there. You can check out various images available on docker hub [here](https://hub.docker.com/search?q=&type=image).
-
+**Docker Hub** is a popular registry. It is a registry which allows you to download docker images which are built by different communities. You can also store your own images there. You can check out various images available on docker hub [here](https://hub.docker.com/search?q=&type=image){target="\_blank"}.
 
 <iframe width="640" height="480" src="https://www.youtube.com/embed/CPJLKqvR8II" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 

diff --git a/docs/containers/reference.md b/docs/containers/reference.md
@@ -12,14 +12,14 @@ For example, Docker created standard way to create images for Linux Containers.
 | Run `hello-world` Container | `docker run hello-world`                    |
 | List Running Containers     | `docker ps`                                 |
 | Stop a container            | `docker stop <container-name/container-id>` |
-| List Docker Images          | `docker images`                            |
+| List Docker Images          | `docker images`                             |
 | Login into registry         | `docker login`                              |
 | Build an image              | `docker build -t <image_name>:<tag> .`      |
-| Inspect a docker object     | `docker inspect <name/id>`                 |
-| Inspect a docker image      | `docker inspect image <name/id>`           |
-| Pull an image               | `docker pull <image_name>:<tag>`           |
-| Push an Image               | `docker push <image_name>:<tag>`           |
-| Remove a container          | `docker rm <container-name/container-id>`  |
+| Inspect a docker object     | `docker inspect <name/id>`                  |
+| Inspect a docker image      | `docker inspect image <name/id>`            |
+| Pull an image               | `docker pull <image_name>:<tag>`            |
+| Push an Image               | `docker push <image_name>:<tag>`            |
+| Remove a container          | `docker rm <container-name/container-id>`   |
 
 ## Running Docker
 
@@ -50,6 +50,7 @@ For example, Docker created standard way to create images for Linux Containers.
     ``` bash
     ibmcloud cr login --client docker
     ```
+
 <!---
 === "Docker on Kubernetes/OpenShift"
 
@@ -74,7 +75,7 @@ For example, Docker created standard way to create images for Linux Containers.
         ``` bash
         docker version
         ```
-    
+
     === "Kubernetes"
 
         1. If you have already configured your Kubernetes, skip to step 5. First, add a user by setting credentials. Feel free to change the credential name, username and password to whatever you like.
@@ -112,11 +113,12 @@ For example, Docker created standard way to create images for Linux Containers.
         docker version
         ```
 --->
+
 ## Activities
 
-| Task                    | Description                                                     | Link                                                                                                                         | Time   |
-| ----------------------- | --------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | ------ |                                                       |                                                                                                                              |        |
-| IBM Container Registry  | Build and Deploy Run using IBM Container Registry               | [IBM Container Registry](../labs/containers/container-registry/index.md)                                                                           | 30 min |
-| Docker Lab              | Running a Sample Application on Docker                          | [Docker Lab](../labs/containers/index.md)                                                                                                  | 30 min |
+| Task                   | Description                                       | Link                                                                     | Time   |
+| ---------------------- | ------------------------------------------------- | ------------------------------------------------------------------------ | ------ |
+| IBM Container Registry | Build and Deploy Run using IBM Container Registry | [IBM Container Registry](../labs/containers/container-registry/index.md) | 30 min |
+| Docker Lab             | Running a Sample Application on Docker            | [Docker Lab](../labs/containers/index.md)                                | 30 min |
 
 Once you have completed these tasks, you should have a base understanding of containers and how to use Docker.