Skip to content

Commit

Permalink
docs: use folder explorer and create a new folder in session launcher
Browse files Browse the repository at this point in the history
  • Loading branch information
ironAiken2 committed Oct 25, 2024
1 parent e40bfef commit cce4541
Show file tree
Hide file tree
Showing 5 changed files with 51 additions and 20 deletions.
61 changes: 41 additions & 20 deletions docs/locale/ko/LC_MESSAGES/mount_vfolder/mount_vfolder.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Backend.AI Console User Guide 19.09\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-06-13 11:09+0900\n"
"POT-Creation-Date: 2024-10-24 10:51+0900\n"
"PO-Revision-Date: 2023-03-25 23:38+0900\n"
"Last-Translator: Jonghyun Park <[email protected]>\n"
"Language: ko\n"
Expand Down Expand Up @@ -72,6 +72,26 @@ msgstr ""

#: ../../mount_vfolder/mount_vfolder.rst:34
msgid ""
"By clicking on a folder name, you can use ''Folder Explore''' to view the"
" stored files or folders inside the folder or upload new files or "
"folders. For more information on how to use it, please refer "
":ref:`Explore Folder<explore_folder>` section."
msgstr ""
"폴더 이름을 클릭하면 ''폴더 탐색기''를 통해 폴더 내부 정보를 확인하거나 새로운 파일 혹은 폴더를 "
"업로드 할 수 있습니다. ''폴더 탐색기''에 대한 자세한 사용방법은 :ref:`폴더 내용 조회하기<explore_folder>` 를 확인하세요. "

#: ../../mount_vfolder/mount_vfolder.rst:38
msgid ""
"Alternatively, you can create a new virtual folder by clicking the '+' "
"button. For more information on how to create a new folder in session "
"launcher page, please refer :ref:`Create storage "
"folder<create_storage_folder>` section."
msgstr ""
"추가적으로, '+' 버튼을 클릭해 새로운 폴더를 생성할 수도 있습니다. 세션 런처에서 새로운 폴더를 "
"생성하는 자세한 방법은, :ref:`Storage 폴더 생성<create_storage_folder>` 를 확인하세요. "

#: ../../mount_vfolder/mount_vfolder.rst:42
msgid ""
"Now, open the terminal by clicking the terminal icon in the created "
"session. If you run ``ls`` command in the terminal, you can see that the "
"``user1-ml-test`` and ``user2-vfolder`` folders are mounted under the "
Expand All @@ -80,7 +100,7 @@ msgstr ""
"생성된 세션에서 터미널 아이콘을 클릭해 터미널 창을 띄워 봅시다. 터미널에서 ``ls`` 명령을 내려보면 ``user1-ml-"
"test`` 폴더와 ``user2-vfolder`` 폴더가 홈 디렉토리 하위에 마운트 되어 보이는 것을 알 수 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:39
#: ../../mount_vfolder/mount_vfolder.rst:47
msgid ""
"The selected folder, by default, will be mounted with its name under "
"``/home/work/`` inside the compute session. For example, if a folder's "
Expand All @@ -97,7 +117,7 @@ msgstr ""
"``/workspace`` 로 입력한 경우, ``test`` 폴더가 연산 세션 내의 ``/workspace`` 경로에 마운트 "
"됩니다. 상대 경로를 입력하면 ``/home/work/`` 아래에 마운트 됩니다."

#: ../../mount_vfolder/mount_vfolder.rst:47
#: ../../mount_vfolder/mount_vfolder.rst:55
msgid ""
"Let's create a ``test_file`` under ``user2-vfolder`` to see if the file "
"can be preserved after the compute session is terminated. The contents of"
Expand All @@ -110,7 +130,7 @@ msgstr ""
msgid "Mounted folders in terminal"
msgstr ""

#: ../../mount_vfolder/mount_vfolder.rst:54
#: ../../mount_vfolder/mount_vfolder.rst:62
msgid ""
"If you run ``ls`` command against ``user2-vfolder``, you can see that the"
" file was created successfully. Also note the contents of the file with "
Expand All @@ -119,7 +139,7 @@ msgstr ""
"``user2-vfolder`` 를 대상으로 ``ls`` 명령을 실행해보면 파일이 잘 생성된 것을 확인할 수 있습니다. "
"``cat`` 명령으로 파일 내용도 확인해 보았습니다."

#: ../../mount_vfolder/mount_vfolder.rst:58
#: ../../mount_vfolder/mount_vfolder.rst:66
msgid ""
"Now delete the compute session and go to the Storage page. Locate the "
"``user2-vfolder folder``, open a file explorer and check that the file "
Expand All @@ -135,7 +155,7 @@ msgstr ""
msgid "Download icon in the folder explorer"
msgstr ""

#: ../../mount_vfolder/mount_vfolder.rst:67
#: ../../mount_vfolder/mount_vfolder.rst:75
msgid ""
"Like this, when creating a compute session, you can mount storage folders"
" and perform any file operations on those mounted folders to save data "
Expand All @@ -144,11 +164,11 @@ msgstr ""
"이처럼 연산 세션을 생성할 때 폴더 마운트를 하고, 마운트 된 폴더에서 파일 작업을 수행하면 연산 세션이 종료된 이후에도 데이터를 "
"보존할 수 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:75
#: ../../mount_vfolder/mount_vfolder.rst:83
msgid "Configure a compute session environment using an automount folder"
msgstr "자동 마운트 폴더를 이용하여 연산 세션 환경 구성하기"

#: ../../mount_vfolder/mount_vfolder.rst:77
#: ../../mount_vfolder/mount_vfolder.rst:85
msgid ""
"Sometimes you need a new program or library that is not pre-installed in "
"a compute session. In that case, you can install packages and configure a"
Expand All @@ -160,11 +180,11 @@ msgstr ""
"관계없는 Storage 폴더 특성과 :ref:`자동 마운트 폴더<automount-folder>` 를 이용해서 패키지를 설치하고, "
"연산 세션의 종류에 상관없이 일정한 환경을 구성할 수 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:86
#: ../../mount_vfolder/mount_vfolder.rst:94
msgid "Install Python packages via pip"
msgstr "pip을 통한 파이썬 패키지 설치"

#: ../../mount_vfolder/mount_vfolder.rst:88
#: ../../mount_vfolder/mount_vfolder.rst:96
msgid ""
"Creating a folder named ``.local`` allows a user to install Python user "
"packages in that folder. This is because ``pip`` by default installs the "
Expand All @@ -179,7 +199,7 @@ msgstr ""
"사용자 홈폴더 하위에 마운트 됩니다). 따라서, 만약 ``tqdm`` 이라는 파이썬 패키지를 연산 환경과 상관없이 항상 설치되어 "
"있는 상태를 유지하려면 터미널에서 다음과 같은 명령을 내릴 수 있습니다:"

#: ../../mount_vfolder/mount_vfolder.rst:99
#: ../../mount_vfolder/mount_vfolder.rst:107
msgid ""
"After that, when a new compute session is created, the ``.local`` folder "
"where the ``tqdm`` package is installed is automatically mounted, so you "
Expand All @@ -188,7 +208,7 @@ msgstr ""
"이후, 연산 세션을 새로 생성하게 되면 ``tqdm`` 패키지가 설키된 ``.local`` 폴더가 자동으로 마운트 되므로, "
"``tqdm`` 패키지를 다시 설치하지 않고 사용할 수 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:105
#: ../../mount_vfolder/mount_vfolder.rst:113
msgid ""
"If you spawn multiple sessions that use different Python versions, there "
"may be compatibility issues with the packages. This can be circumvented "
Expand All @@ -200,11 +220,11 @@ msgstr ""
"``.bashrc`` 편집기능을 통해 ``PYTHONPATH`` 를 분기하는 방식으로 적용할 수 있습니다. "
"``PYTHONPATH`` 환경 변수에 지정된 경로에 사용자 ``pip`` 패키지가 설치되기 때문입니다."

#: ../../mount_vfolder/mount_vfolder.rst:114
#: ../../mount_vfolder/mount_vfolder.rst:122
msgid "Install packages via Homebrew"
msgstr "Homebrew를 통해 패키지 설치"

#: ../../mount_vfolder/mount_vfolder.rst:116
#: ../../mount_vfolder/mount_vfolder.rst:124
msgid ""
"Package managers like Ubuntu ``apt`` or CentOS ``yum`` usually require "
"the ``root`` permission. For security reasons, ``sudo`` and ``root`` "
Expand All @@ -218,29 +238,29 @@ msgstr ""
"(설정에 따라 접근을 허용할 수도 있습니다), 패키지 설치를 위해 ``sudo`` 접근이 필요하지 않은 `Homebrew on "
"Linux <https://docs.brew.sh/Homebrew-on-Linux>`_ 사용을 권장하고 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:122
#: ../../mount_vfolder/mount_vfolder.rst:130
msgid "Homebrew can be configured as follows:"
msgstr "Homebrew는 다음과 같이 구성할 수 있습니다."

#: ../../mount_vfolder/mount_vfolder.rst:124
#: ../../mount_vfolder/mount_vfolder.rst:132
msgid "Create ``.linuxbrew`` folder in Data & Storage page."
msgstr "Data & Storage 페이지에서 ``.linuxbrew`` 폴더 생성."

#: ../../mount_vfolder/mount_vfolder.rst:125
#: ../../mount_vfolder/mount_vfolder.rst:133
msgid ""
"Create a compute session (``.linuxbrew`` folder is automatically mounted "
"at ``/home/linuxbrew/.linuxbrew``)."
msgstr "연산 세션을 생성(``.linuxbrew`` 폴더가 자동으로 ``/home/linuxbrew/.linuxbrew`` 위치에 마운트)."

#: ../../mount_vfolder/mount_vfolder.rst:127
#: ../../mount_vfolder/mount_vfolder.rst:135
msgid "Install Homebrew in the compute session, if not yet installed."
msgstr "연산 세션 내에서 Homebrew 설치(아직 설치하지 않은 경우)."

#: ../../mount_vfolder/mount_vfolder.rst:133
#: ../../mount_vfolder/mount_vfolder.rst:141
msgid "Homebrew packages can be installed like:"
msgstr "Homebrew 패키지는 다음과 같이설치할 수 있습니다:"

#: ../../mount_vfolder/mount_vfolder.rst:141
#: ../../mount_vfolder/mount_vfolder.rst:149
msgid ""
"``brew`` installs packages under ``/home/linuxbrew/.linuxbrew`` which is "
"automatically mounted when ``.linuxbrew`` folder exists. So, if you "
Expand All @@ -252,3 +272,4 @@ msgstr ""
"``.linuxbrew`` 라는 데이터 폴더가 있다면 연산 세션 생성 시 자동으로 그 위치에 마운트합니다. 따라서, "
"``.linuxbrew`` 라는 자동 마운트 폴더를 생성해두면 연산 세션을 삭제하고 새로운 연산 세션을 생성하더라도 기존에 설치했던"
" Homebrew 패키지를 다시 사용할 수 있습니다."

Binary file modified docs/mount_vfolder/create_session_with_folders.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/mount_vfolder/download_file_from_folder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 8 additions & 0 deletions docs/mount_vfolder/mount_vfolder.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,14 @@ session.
mount. For example, project folders used by other projects are not exposed in
Folders to mount. The storage host for each folder is also displayed under
the folder's name.
.. note::
By clicking on a folder name, you can use ''Folder Explore''' to view the
stored files or folders inside the folder or upload new files or folders.
For more information on how to use it, please refer :ref:`Explore Folder<explore_folder>` section.

Alternatively, you can create a new virtual folder by clicking the '+' button.
For more information on how to create a new folder in session launcher page,
please refer :ref:`Create storage folder<create_storage_folder>` section.

Now, open the terminal by clicking the terminal icon in the created session. If
you run ``ls`` command in the terminal, you can see that the ``user1-ml-test``
Expand Down
2 changes: 2 additions & 0 deletions docs/vfolder/vfolder.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,8 @@ follows.
Explore folder
--------------

.. _explore_folder:

You can click the folder button in the Control column to bring up a file explorer
where you can view the contents of that folder.

Expand Down

0 comments on commit cce4541

Please sign in to comment.