Code

Changes between Initial Version and Version 1 of DjangoDocumentKoreanTranslation/install-ko.txt


Ignore:
Timestamp:
11/12/07 09:13:29 (6 years ago)
Author:
spike
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DjangoDocumentKoreanTranslation/install-ko.txt

    v1 v1  
     1{{{ 
     2===================== 
     3장고를 설치하는 방법 
     4===================== 
     5 
     6이 문서로 장고를 운영할 수 있습니다. 
     7 
     8파이썬(Python) 설치부터 
     9============== 
     10 
     11장고는 파이썬 2.3 이상이 필요합니다. http://www.python.org 에서 
     12파이썬을 내려받아서 설치하세요. 리눅스나 Mac OSX라면 아마 시스템에 
     13이미 설치되어 있을 것입니다. 
     14 
     15아파치(Apache)와 mod_python 설치 
     16============================= 
     17 
     18장고를 한번 둘러보려는 거라면 이 섹션은 그냥 넘어가세요.; 장고는 
     19가벼운 웹서버를 가지고 있어서 이 웹서버로 테스트해볼 수 있습니다. 
     20아파치는 실제 환경에서 장고를 운영할 때 사용하세요. 
     21 
     22장고를 실제 운영환경에서 운영하려면 mod_perl과 유사한 아파치의 `mod_python`_을 
     23사용하세요. -- mod_python은 아파치에 파이썬을 집어넣어서 웹서버가 
     24시작할 때 파이썬을 메모리에 올려둡니다. 아파치 프로세스가 실행되는 
     25동안 코드는 메모리에서 내려가지 않습니다. 이런 점은 다른 서버 
     26운영방법에 비해서 많은 성능향상을 가져옵니다. mod_python을 포함시켜서 
     27아파치를 설치하세요. 장고는 아파치 2.x, mod_python 3.x 이상에서 
     28실행됩니다. 
     29 
     30mod_python을 설정하는 좀더 자세한 내용은 `mod_python에서 장고 운영하기`_에서 
     31살펴보세요. 
     32 
     33어떤 이유에서든지 mod_python을 사용하지 않기로 했다면 걱정하지 마세요. 
     34장고는 `WSGI`_ 기준을 따르고 있습니다. `WSGI`_는 여러 웹서버 플랫폼을 
     35지원합니다. `장고 웹서버 지원 위키 페이지`_에서 여러 웹서버에서 
     36설치하는 내용을 확인하세요. 
     37 
     38.. _Apache: http://httpd.apache.org/ 
     39.. _mod_python: http://www.modpython.org/ 
     40.. _WSGI: http://www.python.org/peps/pep-0333.html 
     41.. _mod_python에서 장고 운영하기: ../modpython/ 
     42.. _장고 웹서버 지원 위키 페이지: http://code.djangoproject.com/wiki/ServerArrangements 
     43 
     44 
     45데이터베이스를 실행하세요. 
     46========================= 
     47 
     48장고 데이터베이스 API를 사용하려면 데이터베이스가 필요합니다. 장고는 
     49`PostgreSQL`_, `MySQL`_, `Oracle`_ 그리고 `SQLite`_ (물론 SQLite는 서버를 
     50실행시킬 필요는 없습니다.) 
     51 
     52당연하지만 데이터베이스를 파이썬에서 사용하기 위해서 해당 
     53데이터베이스에 맞는 모듈을 설치해야 합니다. 
     54 
     55    * PostgreSQL은 `psycopg`_ 패이키지 필요합니다. 장고는 버전1과 2 모두 
     56      지원합니다. (장고를 설정할 때, 데이터베이스 항목을 버전 1은 
     57      ``postgresql``, 버전 2는 ``postgresql_psycopg2``로 설정하세요.) 
     58 
     59      윈도우라면 비공식으로 `컴파일된 윈도우즈 버전`_을 알아보세요. 
     60 
     61    * MySQL이라면 `MySQLdb`_ 1.2.1p2나 그 이상 버전이 필요합니다. `MySQL backend`_에서 좀더 자세한 내용을 살펴보세요. 
     62 
     63    * 파이썬 2.3, 2.4에서 SQLite를 사용한다면 `pysqlite`_ 2.0.3 혹은 그 이상 
     64      버전이 필요합니다. 파이썬 2.5는 표준 라이브러리로 sqlite를 포함하고 
     65      있어서 따로 설치할 것이 없습니다. 
     66 
     67    * Oracle이라면, `cx_Oracle`_ 4.3.1이나 그 이상 버전이 필요합니다. 
     68      `Oracle backend`_에서 더 자세한 내용을 살펴보세요. 
     69 
     70장고에서 지원하는 ``manage.py syncdb``로 모델(model)에 맞게 
     71데이터베이스에 테이블을 만드는 경우에는, 데이터베이스에 적절한 권한이 
     72있는지 먼저 확인합니다.; 손수 테이블을 만들 때는 ``SELECT``, 
     73``INSERT``, ``UPDATE`` and ``DELETE``에 대해서만 권한을 부여하세요. 
     74``ALTER TABLE`` 권한은 필요없습니다. 장고의 `testing framework`_를 
     75data fixtures와 함께 사용하는 경우엔 데이터베이스에 임시 
     76데이터베이스(temporary test database)를 만드는 권한이 필요합니다. 
     77 
     78.. _PostgreSQL: http://www.postgresql.org/ 
     79.. _MySQL: http://www.mysql.com/ 
     80.. _Django's ticket system: http://code.djangoproject.com/report/1 
     81.. _psycopg: http://initd.org/tracker/psycopg 
     82.. _컴파일된 윈도우즈 버전: http://stickpeople.com/projects/python/win-psycopg/ 
     83.. _MySQLdb: http://sourceforge.net/projects/mysql-python 
     84.. _SQLite: http://www.sqlite.org/ 
     85.. _pysqlite: http://initd.org/tracker/pysqlite 
     86.. _MySQL backend: ../databases/ 
     87.. _cx_Oracle: http://cx-oracle.sourceforge.net/ 
     88.. _Oracle: http://www.oracle.com/ 
     89.. _Oracle backend: ../databases/#oracle-notes 
     90.. _testing framework: ../testing/ 
     91 
     92이전 장고 버전 지우기 
     93================================= 
     94 
     95예전 버전에서 업그레이드하는 경우에는 설치하기 전에 설치된 장고를 
     96지워야 합니다. 
     97 
     98``setup.py install``로 장고를 설치했으면 파이썬의 ``site-packages`` 
     99디렉토리 아래에 있는 ``django`` 디렉토리를 지워서 장고를 지울 수 
     100있습니다. 
     101 
     102파이썬 egg(Python egg)로 장고를 설치했으면 ``.egg`` 파일을 지우고 
     103``site-packages`` 아래에 있는 ``easy-install.pth``에서 이 egg 파일을 
     104가리키는 내용도 지웁니다. 
     105 
     106.. admonition:: ``site-packages``는 어디에? 
     107 
     108    ``site-packages`` 디렉토리는 운영체제 환경과 파이썬이 설치된 환경에 
     109    따라서 조금씩 다릅니다. 아래 명령으로 ``site-packages``를 확인할 
     110    수 있습니다.:: 
     111        python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()" 
     112 
     113(위 명령은 셀에서 실행시켜야 합니다. 파이썬 대화환경이 아니라.) 
     114 
     115 
     116장고 설치하기 
     117======================= 
     118 
     119장고를 설치하는 방법은 배포판이 제공하는 패키지, 장고 공식 릴리즈를 
     120내려받거나, 혹은 최신 개발버전을 설치할 수 있습니다. 
     121 
     122배포판이 제공하는 패키지로 설치하기 
     123~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
     124 
     125`각 배포판별 장고`_에서 여러분이 사용하는 운영체제를 장고가 
     126공식적으로 제공하는 패키지로 지원하는지 확인해보세요. 배포판에 맞는 
     127패키지는 쉽게 자동으로 의존성까지 고려해서 설치할 수 있습니다. 
     128 
     129 
     130공식 릴리즈 설치하기 
     131~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
     132 
     133    1. `내려받기 페이지`_에서 최신 버전을 내려받으세요. 
     134 
     135    2. 내려받은 파일을 풉니다. (예, ``tar xzvf Django-NNN.tar.gz``. 
     136       NNN은 버전번호입니다.) 윈도우라면 명령행에서 사용할 수 있도록 
     137       bsdtar_를 내려받아서 사용하세요. GUI 툴인 7-zip을 사용할 수도 
     138       있습니다. 
     139 
     140    3. ``cd Django-NNN``으로 새로 만들어진 디렉토리로 이동하세요. 
     141 
     142    4. 리눅스, Mac OSX 혹은 유닉스류의 운영체제에서는 셀에서 
     143       ``sudo python setup.py install``라고 실행시켜서 설치하도록 
     144       합니다. 윈도우에서는 관리자 권한으로 ``setup.py install``을 
     145       실행시킵니다. 
     146 
     147위에서 설명한 명령들은 ``site-packages``에 장고를 설치합니다. 
     148 
     149.. _각 배포판별 장고: ../distributions/ 
     150.. _bsdtar: http://gnuwin32.sourceforge.net/packages/bsdtar.htm 
     151.. _7-zip: http://www.7-zip.org/ 
     152 
     153개발 버전 설치하기 
     154~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
     155 
     156장고 개발버전은 버그가 제거되고 성능이 향상된 최신 코드를 가지고 
     157있습니다. 다음 과정을 따라가세요.: 
     158 
     159 1. `Subversion`_을 사용할 수 있어야 합니다. (셀에서 ``svn help``라고 
     160   쳐보세요.) 
     161 
     162 2. 장고 SVN에서 개발 branch를 svn으로 내려받습니다.:: 
     163 
     164       svn co http://code.djangoproject.com/svn/django/trunk/ django-trunk 
     165 
     166 
     167 
     1683. 다음으로 파이썬에서 장고 코드를 읽을 수 있도록 합니다. 여러 방법이 
     169   있지만 리눅스, Mac OSX 등 유닉스류의 운영체제에서라면 간단하게 
     170   심볼릭 링크를 사용할 수 있습니다.:: 
     171 
     172       ln -s `pwd`/django-trunk/django SITE-PACKAGES-DIR/django 
     173 
     174(``SITE-PACKAGES-DIR``은 ``site-packages`` 디렉토리 경로입니다. 위에서 설명한 "``site-packages``는 어디에?"을 참고하세요.) 
     175 
     176   다른 방법으로, ``PYTHONPATH`` 환경변수를 설정해줄 수 있습니다. 
     177   ``django-trunk`` 아래 ``django`` 디렉토리를 지정해줍니다. 앞에서 
     178   설명한 심볼릭 링크가 지원되지 않는 윈도우즈 시스템이라면 가장 간단한 
     179   방법입니다. (윈도우즈 `제어판`_에서 환경변수를 
     180   지정하세요.) 
     181 
     182   .. admonition:: 아파치와 mod_python에서는? 
     183 
     184      아파치 설정에서 ``PythonPath``를 지정하세요. 
     185 
     186      더 자세한 방법은 `mod_python에서 장고 운영하기`_을 참고하세요. 
     187 
     188      .. _mod_python에서 장고 운영하기: ../modpython/ 
     189 
     190 4. ``django-trunk/django/bin/django-admin.py``를 
     191   ``/usr/local/bin``(유닉스)나 ``C:\Python24\Scripts``(윈도우즈)처럼 
     192   어느 디렉토리에서도 ``django-admin.py``로 바로 실행할 수 있는 
     193   경로로 복사합니다. 
     194 
     195``python setup.py install``를 *일부러 실행할 필요는 없습니다*. 3, 4번째 
     196항목에서 이미 비슷한 작업을 했습니다. 
     197 
     198``django-trunk`` 디렉토리에서 ``svn update``으로 장고 소스코드를 
     199업데이트할 수 있습니다. `Subversion`_이 알아서 지난 변경사항을 
     200내려받아둡니다. 
     201 
     202.. _내려받기 페이지: http://www.djangoproject.com/download/ 
     203.. _Subversion: http://subversion.tigris.org/ 
     204.. _제어판: http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/sysdm_advancd_environmnt_addchange_variable.mspx 
     205 
     206}}}