/ceph-korean-doc

Korean translation of Ceph Documentation

Primary LanguagePython

πŸ› οΈ Ceph Korean Documentation

Korean translation of ceph Documentation, With Korea Ceph User Group - Facebook

start!

이곳 μ—μ„œ μž„μ‹œλ‘œ μ„œλΉ™μ€‘μΈ λ¬Έμ„œλ₯Ό μ—΄λžŒν•˜μ‹€ 수 μžˆμŠ΅λ‹ˆλ‹€.

μ†Œκ°œ

Ceph Documentation 을 κΈ°μ‘΄ λ ˆμ΄μ•„μ›ƒ κ·ΈλŒ€λ‘œ μ‚¬μš©ν•˜λ©΄μ„œ λ²ˆμ—­ν•˜λ©° μž‘μ—…ν•  수 μžˆλ„λ‘ μ»€μŠ€ν…€λœ λ ˆν¬μ§€ν† λ¦¬μž…λ‹ˆλ‹€.

mimic κΈ°μ€€μœΌλ‘œ κ΅¬μ„±ν–ˆμœΌλ©°, Stable Release λ•Œλ§ˆλ‹€ diff λ₯Ό μΆ”μ ν•˜μ—¬ μ—…λ°μ΄νŠΈν•  μ˜ˆμ •μž…λ‹ˆλ‹€.

ceph/doc 디렉토리λ₯Ό doc-ko λ””λ ‰ν† λ¦¬λ‘œ λŒ€μ²΄ν•˜μ—¬ ceph λ ˆν¬μ§€ν† λ¦¬μ— κ°€μ΄λ“œ ν•˜λŠ” 데둜 λΉŒλ“œν•©λ‹ˆλ‹€. λ‹€μŒ λ ˆν¬μ§€ν† λ¦¬ (drunkard/ceph-Chinese-doc) μ—μ„œ μ˜κ°μ„ λ°›μ•„ μ œμž‘ν•˜μ˜€μŠ΅λ‹ˆλ‹€.

λ²ˆμ—­ κ°€μ΄λ“œ

  1. Ceph 을 κ΅¬μ„±ν•˜λŠ” μš”μ†Œλ“€ (OSD, Monitor, MDS, object, placement group...) 은 ν•œκΈ€λ‘œ λ²ˆμ—­ν•˜μ§€ μ•Šκ³  κ·ΈλŒ€λ‘œ μ”λ‹ˆλ‹€.

ex) Ceph Client κ°€ Ceph Monitor 에 λ°”μΈλ”©λ˜λ©΄, Cluster Map 의 μ΅œμ‹  λ³΅μ œλ³Έμ„ κ²€μƒ‰ν•©λ‹ˆλ‹€.

  1. μƒμœ„ 제λͺ© 및 λΆ€μ œλͺ©λ“€μ€ 원문 κ·ΈλŒ€λ‘œ μ‚¬μš©ν•©λ‹ˆλ‹€.

고유 링크λ₯Ό 가지고 있으며, ν•˜λ‚˜λΌλ„ λ‹€λ₯Έ ν˜•νƒœλ‘œ λ²ˆμ—­λ˜λ©΄, μ˜¬λ°”λ₯΄κ²Œ 접근이 λΆˆκ°€λŠ₯ν•©λ‹ˆλ‹€.

  1. ν•˜λ‚˜μ˜ λ¬Έμ„œ 파일 λ‹Ή PR ν•˜λ‚˜λ‘œ λ²ˆμ—­ν•©λ‹ˆλ‹€. λ˜ν•œ, λ²ˆμ—­μ΄ μ™„λ£Œλ˜λ©΄ λͺ¨λ“  컀밋을 ν•˜λ‚˜λ‘œ λ¬Άμ–΄ Rebase Merge ν•©λ‹ˆλ‹€.

λ¬Έμ„œ λΉŒλ“œ & λ²ˆμ—­ν•˜κΈ°

기본적으둜 Ceph λ ˆν¬μ§€ν† λ¦¬μ˜ 곡식 κ°€μ΄λ“œ λ₯Ό λ”°λ¦…λ‹ˆλ‹€.

  1. ν”„λ‘œμ νŠΈλ₯Ό ν¬ν¬ν•©λ‹ˆλ‹€.

  2. ν¬ν¬ν•œ ν”„λ‘œμ νŠΈλ₯Ό 클둠받고, Submodule Ceph 을 μ—…λ°μ΄νŠΈ ν•©λ‹ˆλ‹€.

git clone https://github.com/{user}/ceph-korean-doc.git
cd ceph-korean-doc
git submodule update --init
cd ceph
git checkout mimic
git pull
cd ..
  1. λ””νŽœλ˜μ‹œλ₯Ό μ„€μΉ˜ν•©λ‹ˆλ‹€.
sudo apt-get install `cat ceph/doc_deps.dep.txt`

Ubuntu ν™˜κ²½μ˜ 경우, doc_deps.deb.txt 파일둜 λ””νŽœλ˜μ‹œλ₯Ό μ„€μΉ˜ν•˜μ—¬ λΉŒλ“œν•  수 μžˆμ§€λ§Œ, λ‹€λ₯Έ ν™˜κ²½μ˜ κ²½μš°μ—λŠ” ν…ŒμŠ€νŠΈν•΄λ³΄μ§€ λͺ»ν–ˆμŠ΅λ‹ˆλ‹€. ν˜Ήμ‹œ μ„±κ³΅ν•˜μ˜€λ‹€λ©΄ μ–Έμ œλ“ μ§€ PR λ³΄λ‚΄μ£Όμ„Έμš”~

  1. λ¬Έμ„œλ₯Ό λ²ˆμ—­ν•©λ‹ˆλ‹€.

doc-ko/ κ°€ μ£Ό ν”„λ‘œμ νŠΈ κ²½λ‘œμž…λ‹ˆλ‹€.

  1. λ¬Έμ„œλ₯Ό λΉŒλ“œν•©λ‹ˆλ‹€.
./build.sh
Top Level States:  ['RecoveryMachine']
Processing /home/sungjunyoung/Naver/sources/ceph-korean-doc/ceph/src/pybind/rados
Building wheels for collected packages: rados
  Running setup.py bdist_wheel for rados ... 
...
  1. serve.sh λ₯Ό μ‹€ν–‰ν•˜μ—¬ localhost:8080 μ—μ„œ ν™•μΈν•©λ‹ˆλ‹€.
./serve.sh
Serving doc at port: http://localhost:8080

PR 올리기

λ²ˆμ—­ ν›„ commit ν•˜κΈ° μ „, ./clean.sh λ₯Ό μ‹€ν–‰ν•˜μ—¬ submodule 을 원상볡ꡬ ν•΄μ€λ‹ˆλ‹€. diff 에 ceph/ ν•˜μœ„ 디렉토리가 μž‘νžˆμ§€ μ•Šλ„λ‘ ν•˜μ—¬ ν‘Έμ‹œν•˜κ³ , ceph-korea/master 브랜치둜 PR 을 μ˜¬λ¦½λ‹ˆλ‹€.