Harbor for small site (LV.1)

Architecture

1 VM & no HA

Pre-Requisite

Server minimum requirement

CPU: 2 vCPUs
Memory: 4GB
Disk: 40GB
OS: Ubuntu

Firewall requirement

port 80 & 443

Setup

Install docker engine

apt update && apt install -y docker.io

(Optional) Install Docker-compose

ใน Ubuntu version เก่า package ของ docker engine จะ version เก่าไป ซึ่งจะยังไม่มี docker compose build-in ติดมา จึงต้องติดตั้งเอง

sudo curl -SL https://github.com/docker/compose/releases/download/v2.29.6/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Set GPG key

gpg --keyserver hkps://keyserver.ubuntu.com --receive-keys 644FF454C0B4115C

Prepare Server SSL certificate

เตรียม certificate ที่จะให้ harbor ใช้งาน เช่น จด cert จาก Let's Encrypt ด้วย certbot หรือซื้อ cert จาก trusted CA

Download harbor package

download package จากเว็บ github release

https://github.com/goharbor/harbor/releases

online package สำหรับกรณีทั่วไป offline package สำหรับ site ที่ไม่สามารถออก internet ได้หรือมีความเร็ว internet ที่ต่ำ

wget https://github.com/goharbor/harbor/releases/download/v2.11.1/harbor-offline-installer-v2.11.1.tgz
tar xzvf harbor-*.tgz

Config Harbor YAML file

cd harbor
cp -p harbor.yml.tmpl harbor.yml
vi harbor.yml

แก้ไข yaml ดังนี้

harbor.yml

hostname: ใส่ชื่อ subdomain name ที่จะให้ harbor ใช้
https:
  certificate: ใส่ path ที่เก็บ cert ที่จะให้ harbor ใช้
  private_key: ใส่ path ที่เก็บ private key ที่เข้าคู่กับ cert
harbor_admin_password: ใส่ password ของ user admin

Install

mkdir -p /var/log/harbor/
sudo ./install.sh

Test

เปิดเว็บ browser แล้วระบุ url ตามที่ set ใน hostname

Reconfigure

execute install script อีกรอบ เช่น add trivy โดยการ execute command ร่วมกับ option --with-trivy

sudo ./install.sh --with-trivy

Uninstall & Remove all data

sudo docker-compose down -v

---

การใช้ backend ของ container image เป็น S3

ในตัวอย่างนี้ เราจะใช้ AWS S3 เป็นพื้นที่เก็บ image แทน local storage ซึ่งจะช่วยป้องกันเรื่อง data loss ได้ ในกรณีเช่น VM พัง หรือ filesystem corrupt

สร้าง policy ซึ่งมี content ดังนี้

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "S3",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:ListMultipartUploadParts",
                "s3:ListBucketMultipartUploads",
                "s3:ListBucket",
                "s3:GetObject",
                "s3:GetBucketLocation",
                "s3:DeleteObject",
                "s3:AbortMultipartUpload"
            ],
            "Resource": [
                "arn:aws:s3:::novice-solutions-example/*",
                "arn:aws:s3:::novice-solutions-example"
            ]
        }
    ]
}

อย่างลืมเปลี่ยนชื่อ bucket ใน policy เป็นของตัวเอง

สร้าง user สำหรับเป็น service account ขึ้นใน AWS IAM user และ map policy

สร้าง access key และ secret key

config ใน harbor.yml เพิ่ม ดังนี้

storage_service:
  s3:
    accesskey: xxxx
    secretkey: yyyy
    region: ap-southeast-1
    bucket: novice-solutions-example

หลังจากนั้นสั่งคำสั่งเพื่อ generate compose ใหม่

sudo ./prepare --with-trivy
sudo docker-compose up -d