사전 환경 구성 

Openproject 다운로드 및 디렉토리 생성 

• openproject 를 git clone 으로 다운로드 받는다. 
• 다운로드 받은 openproject 폴더로 이동후 docker pull 을 통해 openproject 이미지를 다운로드 받는다. 

git clone https://github.com/opf/openproject-deploy --depth=1 --branch=stable/13 openproject

cd openproject/compose

# 설정 파일 복사 
cp .env.example .env

docker-compose pull

sudo OPENPROJECT_HTTPS=false docker-compose up -d

• 정상 기동되면 아래와 같이 컨테이너가 실행 된다. 

• openproject 디렉토리 

• openproject 포트 변경 
• .env 파일의 Port 를 변경 한다. 

TAG=13
OPENPROJECT_HTTPS=false
OPENPROJECT_HOST__NAME=xxx.xxx.xxx.xxx
PORT=5055
OPENPROJECT_RAILS__RELATIVE__URL__ROOT=
IMAP_ENABLED=false
DATABASE_URL=postgres://postgres:p4ssw0rd@db/openproject?pool=20&encoding=unicode&reconnect=true
RAILS_MIN_THREADS=4
RAILS_MAX_THREADS=16
PGDATA="/var/lib/postgresql/data"
OPDATA="/var/openproject/assets"

Openproject  접속

• http://xxx.xxx.xxx.xxx:[port] 로 접속을 한다. 
• admin/admin 으로 접속 한다. 

• 최초 접속후 admin 비번을 수정해줘야 한다. 

• 비밀번호를 변경하고 접속 하게 되면 openproject 메인 화면을 확인 할수 있다. 

• 한국어 설정을 원할경우 My account -> settting -> Language 에서 한국어를 선택 한다. 

dial unix /run/user/0/bus: connect: permission denied 에러 

• 현상:
  • level=error msg="failed to move the rootless netns pasta process to the systemd user.slice: dial unix /run/user/0/bus: connect: permission denied"
  • rootless 환경에서 Podman을 실행 중인데, DBus 및 systemd 관련 문제가 있어 발생 하는 문제 

• 조치 
  • Linger=yes 설정 확인 

whoami
id
loginctl show-user $(whoami)
loginctl enable-linger $(whoami)

• DBus 및 systemd user session 문제 해결
  • 모든 네트워크 및 DNS 설정 삭제 & Podman 시스템 전체 초기화 

rm -rf ~/.config/containers/aardvark-dns
rm -rf ~/.local/share/containers/networks

podman system reset

Error: creating container storage: the container name "ora19c" is already in use

• podman ps -a  | grp [container 이름]:현재 실행 중인  컨테이너 확인
• 실행중인 컨테이너 삭제 
• 삭제 안될시 강제 삭제 

#컨테이너 중지및 삭제 
podman stop ora19c
podman rm ora19c

#컨테이너 명으로 삭제 
podman rm -f ora19c
#컨테이너 ID 로 삭제 
podman rm -f 4f831c2930bf

Django Unit Test

• github 에서 Django 를 git clone 하면 ~/django/tests 디렉토리에 테스트 스위트가 있다.
• 테스트 환경은 Tibero7 과 Django 5.1 버전을 연동하여 테스트해본다.
• Django 5.1  사용하기 위해서는 Python 3.10 버전 이상을 설치해야 한다. 
• https://docs.djangoproject.com/ko/5.1/faq/install/

Django UnitTest 환경 셋팅

• Django  Unit Test  튜토리얼을 참고한다. 
• https://docs.djangoproject.com/ko/5.1//internals/contributing/writing-code/unit-tests/#running-tests-using-django-docker-box

$ git clone https://github.com/YourGitHubName/django.git django-repo
$ cd django-repo/tests
$ python -m pip install -e ..
$ python -m pip install -r requirements/py3.txt
$ ./runtests.py

Django UnitTest 수행

• runtests.py  실행하여 단위 테스트를 실행할 수 있다.

python runtests.py --settings=test_tibero

#특정 테스트 스위트만 수행 하고 자 할때
python runtests.py --settings=test_tibero  generic_relations

#수행된 SQL 정보를 확인하고 싶다면  --debug-sql 옵션을 추가 합니다.
./runtests.py --settings=test_tibero  queries  --debug-sql

#--verbosity=3 옵션을 적용 하면 현재 테스트 진행중인 SQL 실행 내역을 실시간으로 확인 가능 합니다. 
./runtests.py --settings=test_tibero  queries  --debug-sql --verbosity=3

Django UnitTest 결과 확인

• 테스트 수행 결과를 확인하기 위해서는 xmlrunner 패키지를 추가해서 테스트를 진행하면 된다.
• 테스트 수행이 완료되면 TEST_OUTPUT_DIR 로 설정한 디렉토리에 xml 파일로 Reporting 결과가 남고
• junit2html 팩키지를 통해 xml 파일을 html 파일로 변경 하면 가독성면에서 테스터가 결과를 한눈에 확인 가능 하다.
• 또한 allure 팩키지를 사용 하면 html 파일 보다 더욱 가독성있게 테스트결과를 한눈에 확인 가능 하다 (추천)

pip install unittest-xml-reporting
pip install allure-pytest
pip install junit2html   

• test_tibero.py 설정 추가

TEST_OUTPUT_DIR = "/home/django/django/tests/output/xunit"
TEST_RUNNER = 'xmlrunner.extra.djangotestrunner.XMLTestRunner'
TEST_OUTPUT_VERBOSE = 2  # 상세 출력
TEST_OUTPUT_DESCRIPTIONS = True

HTML 파일로 변경 해서 결과 확인 하는 방법

• junit2html 를 통해 xml 결과 html 로 변경 하는 방법
  • TEST-generic_relations.tests.GenericRelationsTests-20250312034521.xml -> report.html 파일로 변경

junit2html /home/django/django/tests/output/xunit/TEST-generic_relations.tests.GenericRelationsTests-20250312034521.xml 
/home/django/django/tests/output/xunit/report.html

allure 를 사용 해서 브라우저를 통해 결과 확인 하는 방법

• allure 최신 버전 다운로드 후 설치를 진행 한다.

wget https://github.com/allure-framework/allure2/releases/download/2.21.0/allure-2.21.0.tgz

tar -xvzf allure-2.21.0.tgz
sudo mv allure-2.21.0 /opt/allure

sudo ln -s /opt/allure/bin/allure /usr/local/bin/allure
allure --version

• 테스트 실행 후 Allure 결과 생성

allure generate /home/django/django/tests/output/xunit -o /home/django/django/tests/output/allure_report --clean

• 정상적으로 리포팅 결과 가 변환 되면 allure_report 디렉토리에 여러 파일들이 생성 된다 .

• /home/django/django/tests/output/allure_report 

• index.html 파일을 실행 하면 결과 확인이 가능 하다.
• http://127.0.0.1:3001/django/tests/output/allure_report/index.html 

7z 파일 압축 해제 방법 

• 압축 해제 방벙 

#7z 파일 압축 해제
7z x 파일명.7z

#특정 폴더에 압축 해제
7z x 파일명.7z -o/경로/디렉토리

#압축 해제 시 기존 파일 덮어쓰기 없이 진행
7z x 파일명.7z -o/경로/디렉토리 -aos

#암호가 걸린 7z 파일 압축 해제방법
7z x 파일명.7z -p비밀번호

# 압축된 파일 내부 목록 확인
7z l 파일명.7z

• 에러발생시 팩키지 설치 필요 

#EPEL 저장소를 활성화
sudo dnf install -y epel-release

#설치
sudo dnf install -y p7zip p7zip-plugins

7z 파일 압축  방법 

• 압축 방법 

#기본 7z 압축 방법
#7z a 압축파일명.7z 파일명

7z a archive.7z myfile.txt

#여러 개의 파일을 압축
#7z a archive.7z 파일1 파일2 디렉토리
7z a mydata.7z file1.txt file2.txt folder1/

#특정 확장자의 파일만 압축
7z a archive.7z *.txt

#암호 설정  압축
#7z a -p비밀번호 archive.7z 파일명
7z a -p1234 secret.7z confidential.txt

Podman Registry 설정 방법

기본 레지스트리 지정 방법

• 설정 파일 : /etc/containers/registries.conf
• 등록 방법 :unqualified-search-registries

unqualified-search-registries = ["docker.io", "quay.io", "registry.fedoraproject.org"]

• 사용자 지정 프라이빗 레지스트리 등록 방법 : [[registry]]

[[registry]]
location = "myregistry.example.com"
insecure = false

• location : 사용할 레지스트리 주소
• insecure = false : HTTPS(보안 연결) 사용 (기본값)
• insecure = true : HTTP(보안 미사용) 허용 (사내 레지스트리에서 필요할 수 있음)

podman 설정 적용 

• 버전 정보 확인 

podman version

podman compose version

• podman 재시작 

 systemctl  restart podman

podman  기본 사용 명령어 

• podman image 삭제 방법 

#실행 중인 것 포함하여 모든 컨테이너 정리 
podman stop -a
#컨테이너 삭제 
podman rm -a
#podman 사용 이미지 삭제 
podman rmi -a

#모든 pod 삭제 
podman pod rm -a

#캐시 및 네트워크 데이터도 정리 
podman system prune -a

podman error  조치 가이드

• 현상:
  • level=error msg="failed to move the rootless netns pasta process to the systemd user.slice: dial unix /run/user/0/bus: connect: permission denied"
  • rootless 환경에서 Podman을 실행 중인데, DBus 및 systemd 관련 문제가 있어 발생 하는 문제 

• 조치 
  • Linger=yes 설정 확인 

whoami
id
loginctl show-user $(whoami)
loginctl enable-linger $(whoami)

• DBus 및 systemd user session 문제 해결
  • 모든 네트워크 및 DNS 설정 삭제 & Podman 시스템 전체 초기화 

rm -rf ~/.config/containers/aardvark-dns
rm -rf ~/.local/share/containers/networks

podman system reset

Podman의 스토리지 경로를 변경

• 현재 podman 스토리지 설정 경로 확인 및 변경 

mkdir /nvme/podman_storage/run
mkdir /nvme/podman_storage/lib

vi /etc/containers/storage.conf

[storage]
driver = "overlay"

# Temporary storage location
#runroot = "/run/containers/storage"
runroot = "/nvme/podman_storage/run"

#graphroot = "/var/lib/containers/storage"
graphroot = "/nvme/podman_storage/lib"




sudo systemctl stop podman
sudo mv /var/lib/containers/storage /nvme/podman_storage/lib
sudo mv /var/run/containers/storage /nvme/podman_storage/run
sudo systemctl start podman

MkDocs 설치 방법 

• MkDocs를 활용해 Markdown(.md) 형식으로 작성된 가이드 문서를 효율적으로 관리 하는 방법에 대해 알아본다.

python 가상환경 생성 

• MkDocs 는 python 을 통개 개발된 문서 관리 유틸이다. 
• python  에서 제공 하는 가상환경(venv)을 만들어서MkDocs 를 설치 한다. 

#mkdocs 가상환경 생성 
python3 -m venv venv_mkdocs

#가상환경 활성화 
source venv_mkdocs/bin/activate

MkDocs 설치 

• pip 를 이용한 mkdocs 를 설치 한다. 
• 설치후 mkdocs --version 를 이요해 버전을 확인 합니다. 
• 삭제는 pip uninstall mkdocs 명령을 통해 삭제 할수 있습니다. 

pip3 install mkdocs
pip install --upgrade pip

# mkdocs 버전확인
mkdocs --version
mkdocs, version 1.6.1 from /home/guide_doc/venv_mkdocs/lib/python3.8/site-packages/mkdocs (Python 3.8)

MkDocs 프로젝트 생성 

• mkdocs new 명령을 통해 문서를 관리할 프로젝트를 생성한다. 

mkdocs new md_guide

MkDocs 서버 실행 

• mkdocs serve 명령을 실행하면 브라우저에서 실시간으로 작성된 문서를 확인 할수 있다. 
• 기본 수행시 로컬에서만 접속이 가능 하다. 
  • http://127.0.0.1:8000

## 로컬에서만 접속 가능 
mkdocs serve 

##외부 접속을 허용하려면 -a 0.0.0.0:8000 옵션을 사용 한다.
mkdocs serve -a 0.0.0.0:8000

#백그라운드 실행
nohup mkdocs serve -a 0.0.0.0:8000 > mkdocs.log 2>&1 &

• 브라우저에 접속을 하면 아래 URL 을 통해 문서를 확인할수 있다. 

MkDocs  테마 적용 

• MkDocs  는 다양한 테마를 지원합니다. 
• https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes 에서 원하는 테마를 적용해서 사용 합니다. 
• 아래 테마는 dracula 를 설정한 화면 입니다. 

pip install mkdocs-dracula-theme

• vi mkdocs.yml 

site_name: My Docs
theme:
      name: dracula
theme:
    name: dracula

• 가장 많이 사용하는것으로 보이는 material 테마는 아래 링크에서 자세한 기능 및 설명 확인이 가능 하다. 
• https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/

pip install mkdocs-material

MkDocs  플러그인 설치 

mkdocs-awesome-pages-plugin

• 사이드바와 네비게이션을 자동 정렬 하는 플러그인

pip install mkdocs-awesome-pages-plugin

• vi mkdocs.yml 

plugins:
    - search
    - awesome-pages

markdown_extensions

• markdown 기능을 확장해서 사용 할수 있는 기능 

pip install markdown_extensions
pip install pymdown-extensions

• vi mkdocs.yml

markdown_extensions:

  # Python Markdown
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true

  # Python Markdown Extensions
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.highlight
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

확장 이름기능 설명설치 필요 여부

mkdocs-mermaid2-plugin

• Mermaid 를 이용한 다이어그램을 표시해주는 기능 

pip install mkdocs-mermaid2-plugin

• vi mkdocs.yml

markdown_extensions:
  - pymdownx.superfences:
        # make exceptions to highlighting of code:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:mermaid2.fence_mermaid_custom  
plugins:
  - mermaid2:
      version: 10.0.2
      theme: "dark"       # Mermaid 다이어그램 테마 (default, dark 등)
      # securityLevel: "loose" # 보안 수준 (loose로 설정하면 외부 자원 로드 가능)

MkDocs PDF

• pdf 파일을  브라우져에서 출력해주는 기능입니다. 

pip install mkdocs-pdf

• vi mkdocs.yml

# mkdocs.yml
markdown_extensions:
  - attr_list
plugins:
  - mkdocs-pdf

• 사용법

![Alt text](<path to pdf>){ type=application/pdf style="min-height:25vh;width:100%" }

MkDocs navigator 설정 

nav:
  - Home: index.md
  - About: about.md
  - Guides:
      - Getting Started: guides/getting-started.md
      - Advanced Topics: guides/advanced.md

# Welcome to MkDocs

For full documentation visit [mkdocs.org](https://www.mkdocs.org).

## Commands

* `mkdocs new [dir-name]` - Create a new project.
* `mkdocs serve` - Start the live-reloading docs server.
* `mkdocs build` - Build the documentation site.
* `mkdocs -h` - Print help message and exit.

## Project layout

    mkdocs.yml    # The configuration file.
    docs/
        index.md  # The documentation homepage.
        ...       # Other markdown pages, images and other files.​

• mkdocs 디렉토리 구조

Gitlab 프로젝트 VS Code 연결 

• Gitlab 과  VS Code를 연동   하는 방법에 대해 설명 한다. 

GitLens, Git History  설치

• VS code 실행 후 마켓 플레이스 에서GitLens, Git History  를 설치한다. 

VSCode Git Clone 방법 

• F1 버튼을 눌러 git clone 선택합니다.
• Git url 주소를 입력한다. 
  • VS Code 레파지토리 URL 정보 입력 <- gitlab http url 입력 

• 복제할 로컬 디렉토리를 선택합니다. 
• 없을경우 신규 생성 합니다. 
• 작업영역을 추가하면 해당 폴더에 Gitlab 리소스가 로컬 Repository 에 다운로드 됩니다. 

VSCode 파일 변경 사항 커밋 

• 테스트를 위해 test.md 파일을 생성 합니다. 
• 파일에 간단한 내용을 작성합니다. 

• Source Control  항목에 들어가서 변경 사항에 대한 커밋 메시지를 작성한후 커밋 버튼을 클릭합니다. 

• 이후 변경 내용 동기화 버튼을 클릭 합니다. 
• 동기화 하지 않으면 Git 서버에 변경내용이 저장 되지 않습니다. 

• 정상 업로드가 되면 Gitlab 에 추가된 test.md 파일이 업로드 된것을 확인 할수 있습니다. 

VS Code MarkDown 확장 패키지 설치 

• Gitlab 에서 Mark down 문법으로 작성된 문서를 수정하고 또 편하게 보기 위해서는 몇가지 확장 패키를 설치 하면 유용합니다. 
  • Diagram and chart  를 보기위해 아래 패키지를 설치 합니다. 
  • Markdown Preview Mermaid Support

• 확장자를 추가하면 Gitlab 에서 지원하는 다양한 플로우 차트와 다이그램을 VS Code 에서 작성 하고 미리보기 를 통해 확인해볼수 있다. 

"postmaster.pid" 잠금 파일이 이미 있음 에러 

• 원인
  • postmaster.pid 파일은 PostgreSQL 서버가 실행 중일 때 생성되며, 서버가 종료되면 자동으로 삭제 되지만 
  • PostgreSQL  가 비정상 종료 할경우에  파일이 남아있어 에러가 발생 할수 있다. 
• 조치방법 1
  • postmaster.pid 파일 삭제 
  • PostgreSQL 서비스 재시작 

cd /var/lib/pgsql/<version>/data
ls postmaster.pid
rm postmaster.pid
systemctl start postgresql

• 조치방법 2
  • 권한 확인 및 소유자 변경
  • 이후에도 정상 기동이 되지 않으면 OS reboot 이후  PostgreSQL 서비스 재시작 

ls -ld /var/lib/pgsql/<version>/data
chown -R postgres:postgres /var/lib/pgsql/<version>/data

#os reboot
shutdown -r now 
systemctl start postgresql

Remote SSH 원 격 접속 (비번 입력 없이)  방법

• VSCode 에서 Remote 접속 시에 비밀 번호 없이 입력 없이 접속 하는 방법에 대해 설명합니다. 
• 아래처럼 Remote 서버 접속시 매번 비밀번호를 입력하게 된다. 
• 이런 불편한점을 없애고 ssh 인증키를 발급받아 접속하고자하는 Remote 원격 서버에 키를 등록한후 
• 매번 비밀 번호를 입력한후 접속 하는 수고를 덜수 있다. 

윈도우 ssh-key 발급 

• Windows PowerShell 을 실행 시킨후 ssh key 를 발급 받습니다. 

#ssh 인증키 발급
ssh-keygen -t rsa -b 4096

#인증키 확인 
Get-Content .\.ssh\id_rsa.pub

authorized_keys  파일 생성(Remote 서버) 

.ssh 디렉토리 이동후 authorized_keys  파일 생성후 윈도우 에서 발급 받은 key 값을 복사 한다. 

VSCode ssh Config 파일 수정

• vscode ssh 접속 설정 파일에  발급받은 키값을 추가 한다. (IdentityFile D:\200.MyConfig\VSCode\.ssh\id_rsa )

Host rocky-192.168.116.xxx
    HostName 192.168.116.xxx
    User rocky
    Port 22
    IdentityFile D:\200.MyConfig\VSCode\.ssh\id_rsa

추가후 재섭속시 비밀번호 없이 Remote SSH 접속시 비밀번호 업이 접속 할수 있다. 

SVN 설치 

dnf instatall subversion
svn  --version

SVN 기본 명령어 

• 리소드 체크 아웃 

svn checkout https://example.com/svn/my_project/trunk

• 리소스 업데이트 (체크아웃 받은 리소스에 대해 변경된 사항을 로컬로 업데이트 합니다.) 

svn update

• 파일 상태 확인 
  • M: 수정 파일
  • A: 추가 파일
  • D: 삭제 파일
  • ?: 버전 관리되지 않은 파일

svn status

• 파일 정보 저장 및 변경 

#파일 추가 
svn add new_file.txt 

#파일 저장 
svn commit -m "추가한 내용 기록"

#파일 삭제 
svn delete old_file.txt

#파일 내용 비교 
svn diff current_file.txt

#파일 변경 내용 확인
svn log current_file.txt

SVN 트러블 슈팅 

svn: warning: cannot set LC_CTYPE locale 에러 

• 해당 에러는 SVN 클라이언트가 로케일 설정이 맞지 않을때 발생하는 에러 입니다. 
• 위 현상을 해결 하기 위해서는 아래 단계로 현재 로케일 설정을 확인하고 환경에 맞는 로케일 로 설정을 맞춰 줍니다. 
•