xcentury-lab/podman-ws-csa

Podman workshop materials

podman-ws-csa

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

このプロジェクトはPodmanを活用するための基本的な操作と実際のPod作成を交えたデモおよびハンズオンのためのドキュメントです。

(back to top)

Built With

このデモ/ハンズオンに関する主要なツールや関連したコンポーネントは以下になります。

• 
• 
• 

(back to top)

Getting Started

このデモ/ハンズオンはユーザがPodmanの基礎を理解するためのものです。ローカル環境でコンテナ、Podを動作させ、Podのライフサイクルを理解しkubernetes環境への展開を準備することを目的としています。 以降のドキュメントでは対象の環境をRHELとして説明しますが、WindowsおよびMacでも同じように動かすことができます。

まずは、前提条件を理解し、環境の準備を行なってください。

Prerequisites

1. 前提条件としてユーザが以下の環境及びスキルを備えていること

   • コンテナに関する前提知識を学習していること
   • Podmanに関する前提知識を学習していること(事前にワークショップにて座学を実施します)
   • コマンドラインインターフェースでの操作ができること
   • Podman/PodmanDesktopをインストール可能なクライアント(RHEL/OtherLinux/Windows/Mac)を準備する
   • クライアントからインターネットに接続可能であること
   • Gitを利用可能であること

2. また、下記の注意事項は各位のクライアントによる環境差異が起きる可能性を示します

   • ローカルの仮想環境やDockerにてportが利用されていないこと

   • 既にPodmanまたはPodmanDesktopを利用していないことを確認

     podman -v

Installation

Podmanのインストールを実施します。また必要に応じてGitからドキュメントや教材をダウンロードする必要があるためGitも準備しておきます

1. Podmanの準備

• GUI環境(Windows/Mac/RHEL)を利用する場合

  https://podman-desktop.io からクライアントに対応したpodman desktopをダウンロードしてインストールしてください。PodmanDesktopを起動して、Podmanが未インストールの場合、Installボタンが表示されるのでそこからインストールを実施してください。

  Podmanのインストールが完了するとPodmanDesktopにRun Podmanのスイッチが表示されるので今度はそれを有効化してください。podman machineが起動し、Podman is Runnning と表示されPodmanのバージョンが表示されたら準備完了です。

• CUI環境(Windows/Mac)を利用する場合

  もしpodman desktopを利用しない場合はPodmanのインストール後にPodman machineを起動してください(以下はMacの例なのでbrewでinstallしています)

  podman install

   brew install podman 

  初期化

   podman machine init 

  起動

   podman machine start 

• CUI環境(RHEL)を利用する場合

  yumまたはdnfからpodmanをインストールします。

   yum install podman

2. 教材の準備

• クローンするだけですのでGitHubのアカウントは不要です

  yum install git

  教材の取得

  git clone https://github.com/toomorirh/podman-ws-csa.git

3. 確認

• Podmanのバージョンを確認してください(v4.3.0以上)

  podman version 4.3.0

(back to top)

Usage

チェックアウトした教材フォルダを参照します。フォルダにはプリフィックス番号があるので、それに従ってコンテンツを進行します。詳細はそれぞれのフォルダにあるREADME.mdを参照してください。どのコンテンツから始めることもできますが、前提条件として前工程がある場合はそれを先に完了してください。

コンテンツリスト

• 共通

  1. podmanを使ったコンテナの実行 ...1_run_container
  2. podmanを使ったコンテナの管理 ...2_manage_container
  
  

• 開発者向け

  3. podmanを使ったアプリケーションの実行と更新 ...3_update_container
  
  

• 運用者向け

  4. 準備中
  
  

• 応用

  5. Podman を使ったPodの作成 ...5_create_pod

(back to top)

Roadmap

• Contents Creation
  • For Developer
  • For Operator
• Run Your Pod on k8s/OpenShift

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b ***/***)
3. Commit your Changes (git commit -m 'Add some ***')
4. Push to the Branch (git push origin ***/***)
5. Open a Pull Request

(back to top)

License

Distributed under the Apache-2.0 License. See LICENSE for more information.

(back to top)

Contact

Tomoki Omori - [email protected]

Project Link: None

(back to top)