Skip to content

Commit

Permalink
Merge pull request #14 from lablup/docs/update-admin-menu
Browse files Browse the repository at this point in the history
docs: update configuration per job scheduler
  • Loading branch information
lizable committed May 24, 2021
2 parents e01321d + b18ce1b commit c1dc15b
Show file tree
Hide file tree
Showing 12 changed files with 792 additions and 742 deletions.
21 changes: 18 additions & 3 deletions docs/admin_menu/admin_menu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -515,13 +515,28 @@ guarantee the Integrity of the image.
.. image:: system_setting_about_image.png
:alt: System setting about image

You can also choose job scheduler. Currently, there are three types: ``FIFO``, ``LIFO``,
and ``DRF``. Each method of the scheduling is exactly same as
:ref:`scheduling methods<scheduling-methods>` above.
You can also change settings for scaling and plugins.

.. image:: system_setting_about_scaling_plugins.png
:alt: System setting about scaling and plugins

You can edit the configuration per job scheduler by clicking the config button.
The values in the scheduler setting are the defaults to use when there is no scheduler
setting in each :ref:`resource group<scheduling-methods>`. If there is a resource
group-specific setting, this value will be ignored.

Currently supported scheduling methods include ``FIFO``, ``LIFO``, and ``DRF``.
Each method of scheduling is exactly the same as the :ref:`scheduling methods<scheduling-methods>` above.
Scheduler options include session creation retries. Session creation retries refers to the number
of retries to create a session if it fails. If the session cannot be created within the trials,
the request will be ignored and Backend.AI will process the next request. Currently, changes are
only possible when the scheduler is FIFO.

.. image:: system_setting_dialog_scheduler_settings.png
:width: 350
:align: center
:alt: System setting dialog scheduler settings

.. note::
We will continue to add broader range of setting controls.

Expand Down
Binary file modified docs/admin_menu/system_setting_about_scaling_plugins.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1,164 changes: 601 additions & 563 deletions docs/locale/ko/LC_MESSAGES/admin_menu/admin_menu.po

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@ msgstr ""

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:161
msgid "Manage Resource Policy"
msgstr "리소스 정책 관리"
msgstr "자원 정책 관리"

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:163
msgid ""
Expand All @@ -301,8 +301,8 @@ msgid ""
"resource policies can be created, for example, user / research purposes, and "
"apply them separately to each keypair."
msgstr ""
"리소스 정책을 통해 키페어 별로 자원 사용 및 기타 세션 사용 관련 정책을 설정할 "
"수 있습니다. 필요에 따라 사용자용/연구용 등 목적으로 여러 가지 리소스 정책을 설"
"자원 정책을 통해 키페어 별로 자원 사용 및 기타 세션 사용 관련 정책을 설정할 "
"수 있습니다. 필요에 따라 사용자용/연구용 등 목적으로 여러 가지 자원 정책을 설"
"정하여 키페어에 분리 적용할 수 있습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:174
Expand Down Expand Up @@ -488,7 +488,7 @@ msgid ""
"You can create a new resource policy by clicking the CREATE POLICY button. "
"Each setting value is the same as described above."
msgstr ""
"CREATE POLICY 버튼을 클릭하여 새로운 리소스 정책을 생성할 수도 있습니다. 각 설"
"CREATE POLICY 버튼을 클릭하여 새로운 자원 정책을 생성할 수도 있습니다. 각 설"
"정값의 위미는 상기 설명과 동일합니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:251
Expand All @@ -498,7 +498,7 @@ msgid ""
"Controls panel of the desired keypair, and click the Select Policy field to "
"choose it."
msgstr ""
"리소스 정책을 생성한 후 키페어에 연결하기 위해서는 Users 페이지의 Credentials "
"자원 정책을 생성한 후 키페어에 연결하기 위해서는 Users 페이지의 Credentials "
"탭으로 가서 원하는 키페어의 Controls 열에 위치한 톱니바퀴 설정 버튼을 누른 후 "
"Select Policy 필드를 클릭하여 선택하면 됩니다."

Expand Down Expand Up @@ -672,12 +672,12 @@ msgstr ""
"에서 allowed docker registries 필드에 해당 레지스트리를 등록해야 도메인 또는 그"
"룹 소속 사용자가 레지스트리 이미지에 접근할 수 있습니다. Allowed docker "
"registries 등록은 도메인과 그룹 관리 기능이 있는 Manager Hub를 이용해서 할 수 "
"있습니다. 키페어의 리소스 정책에서 allowed docker registries를 설정하는 기능은 "
"있습니다. 키페어의 자원 정책에서 allowed docker registries를 설정하는 기능은 "
"아직 제공하지 않고 있습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:373
msgid "Manage resource preset"
msgstr "리소스 프리셋 설정"
msgstr "자원 프리셋 설정"

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:375
msgid ""
Expand All @@ -686,7 +686,7 @@ msgid ""
"resource presets."
msgstr ""
"연산 세션을 생성할 때 Resource allocation 패널에서 다음과 같은 사전 정의된 리소"
"스 프리셋이 출력 됩니다. Super admin에게는 이 리소스 프리셋을 설정할 수 있는 기"
"스 프리셋이 출력 됩니다. Super admin에게는 이 자원 프리셋을 설정할 수 있는 기"
"능을 제공합니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:384
Expand All @@ -708,7 +708,7 @@ msgid ""
"than the amount of resources defined in the preset, the corresponding preset "
"would not be shown."
msgstr ""
"Controls 열의 설정 아이콘(톱니바퀴 모양)을 클릭하여 리소스 프리셋이 제공할 "
"Controls 열의 설정 아이콘(톱니바퀴 모양)을 클릭하여 자원 프리셋이 제공할 "
"CPU, RAM, fGPU 등의 자원을 설정할 수 있습니다. 아래 예제의 경우 Backend.AI 서버"
"의 GPU 제공 모드가 shares이므로 GPU 필드는 비활성화 되어 있습니다. 원하는 값으"
"로 자원을 설정한 후 저장하고 연산 세션 생성 시 해당 프리셋이 출력되는지 확인해 "
Expand All @@ -728,7 +728,7 @@ msgid ""
msgstr ""
"Super admin의 경우 Resources 페이지의 Connected 탭에서는 현재 Backend.AI에 연결"
"된 agent 워커 노드를 조회할 수 있습니다. 노드의 IP와 연결된 시간, 현재 사용중"
"인 실제 리소스 등을 조회할 수 있습니다. 콘솔 앱에서는 별도로 agent 노드를 조작"
"인 실제 자원 등을 조회할 수 있습니다. 콘솔 앱에서는 별도로 agent 노드를 조작"
"하는 기능은 제공하지 않습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:416
Expand All @@ -742,7 +742,7 @@ msgstr ""

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:425
msgid "Manage resource group"
msgstr "리소스 그룹 관리"
msgstr "자원 그룹 관리"

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:427
msgid ""
Expand All @@ -752,10 +752,10 @@ msgid ""
"group three V100 agents into one resource group, and the remaining two P100 "
"agents into another resource group."
msgstr ""
"Agent는 리소스 그룹이라는 단위로 묶일 수 있습니다. 예를 들어, V100 GPU를 탑재"
"Agent는 자원 그룹이라는 단위로 묶일 수 있습니다. 예를 들어, V100 GPU를 탑재"
"한 agent가 3대, P100 GPU를 탑재한 agent가 2대 있는데, 사용자에게 두 GPU 자원을 "
"별도로 노출하고 싶을 경우 V100 agent 3대를 하나의 리소스 그룹으로 묶고, 나머지 "
"P100 agent 2대를 다른 리소스 그룹으로 묶어서 관리할 수 있습니다."
"별도로 노출하고 싶을 경우 V100 agent 3대를 하나의 자원 그룹으로 묶고, 나머지 "
"P100 agent 2대를 다른 자원 그룹으로 묶어서 관리할 수 있습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:433
msgid ""
Expand All @@ -764,9 +764,9 @@ msgid ""
"installation location and restart the agent daemon. Management of the resource "
"groups is possible in Scaling Group tab of the Resource page."
msgstr ""
"리소스 그룹에 특정 agent를 추가하는 작업은 현재 UI 상에서 처리되지 않으며, "
"자원 그룹에 특정 agent를 추가하는 작업은 현재 UI 상에서 처리되지 않으며, "
"agent 설치 폴더의 설정 파일 옵션을 수정한 뒤 agent를 재시작 하는 방식으로 가능"
"합니다. 리소스 그룹은 Resources 페이지의 Scaling Group 탭에서 조회할 수 있습니"
"합니다. 자원 그룹은 Resources 페이지의 Scaling Group 탭에서 조회할 수 있습니"
"다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:441
Expand All @@ -779,21 +779,21 @@ msgid ""
"Fairness, and it aims to provide resources as fair as possible for each user. "
"You can deactivate a resource policy by turning off Active Status."
msgstr ""
"Control 열에서 설정 아이콘을 클릭하여 리소스 그룹을 편집할 수 있습니다. Select "
"Control 열에서 설정 아이콘을 클릭하여 자원 그룹을 편집할 수 있습니다. Select "
"scheduler 필드에서 연산 세션 생성 스케줄링 방식을 선택할 수 있는데, 현재 지원하"
"는 방식은 FIFO, LIFO, DRF 세 가지 입니다. FIFO 와 LIFO 는 가장 처음 또는 가장 "
"마지막에 작업 큐에 들어 온 연산 세션을 먼저 생성하는 방식으로 스케줄링 방식이"
"고, DRF 는 Dominant Resource Fairness 의 약자로 사용자 별로 최대한 공평하게 자"
"원 할당이 가능하도록 조절하여 스케줄링 하는 방식입니다. Active Status 를 꺼서 "
"해당 리소스 정책을 비활성화 할 수 있습니다."
"해당 자원 정책을 비활성화 할 수 있습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:454
msgid "You can create a new resource policy by clicking the CREATE button."
msgstr "CREATE 버튼을 클릭하여 새로운 리소스 정책을 생성할 수 있습니다."
msgstr "CREATE 버튼을 클릭하여 새로운 자원 정책을 생성할 수 있습니다."

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:458
msgid "Download session lists"
msgstr "세션 리소스 다운로드"
msgstr "세션 자원 다운로드"

#: ../../admin_user_keypair_management/admin_user_keypair_management.rst:460
msgid ""
Expand Down Expand Up @@ -918,8 +918,8 @@ msgstr ""
#~ "If necessary, multiple resource policies can be created, for example, "
#~ "user / research purposes, and apply them separately to each keypair."
#~ msgstr ""
#~ "리소스 정책은 Users 페이지의 Resource Policies에서 조회 및 수정할 수 있습니"
#~ "다. 리소스 정책을 통해 키페어 별로 자원 사용 및 기타 세션 사용 관련 정책을 "
#~ "자원 정책은 Users 페이지의 Resource Policies에서 조회 및 수정할 수 있습니"
#~ "다. 자원 정책을 통해 키페어 별로 자원 사용 및 기타 세션 사용 관련 정책을 "
#~ "설정할 수 있습니다. 필요에 따라 사용자용/연구용 등 목적으로 여러 가지 리소"
#~ "스 정책을 설정하여 키페어에 분리 적용할 수 있습니다."

Expand All @@ -928,7 +928,7 @@ msgstr ""
#~ "You can change the resource policy by clicking the settings icon in the "
#~ "Control column. After changing the settings, click UPDATE to save."
#~ msgstr ""
#~ "위 예제 이미지에서는 ``default`` 라는 이름의 리소스 정책 하나가 있습니다. "
#~ "위 예제 이미지에서는 ``default`` 라는 이름의 자원 정책 하나가 있습니다. "
#~ "Control 열의 설정 아이콘을 클릭하여 자원 정책을 변경할 수 있습니다. 설정값"
#~ "을 변경한 후 UPDATE를 클릭하면 저장할 수 있습니다."

Expand All @@ -945,11 +945,11 @@ msgstr ""
#~ "much as the server permits. This also applies to other resource settings."
#~ msgstr ""
#~ "CPU: 키페어가 사용할 수 있는 최대 CPU core 수. 예를 들어, 4로 설정한다면 해"
#~ "당 리소스 정책을 사용하는 키페어는 4개 이상의 코어를 컨테이너에 할당할 수 없"
#~ "당 자원 정책을 사용하는 키페어는 4개 이상의 코어를 컨테이너에 할당할 수 없"
#~ "습니다. 이 때, 코어 수는 키페어가 생성한 모든 컨테이너의 합을 기준으로 제한"
#~ "을 걸게 됩니다. 만약 3개의 코어로 컨테이너를 하나 할당한 상황이라면 새로운 "
#~ "컨테이너는 1개의 코어만 할당할 수 있습니다. 또한, Unlimited에 체크하면 별도 "
#~ "리소스 정책을 정하지 않고 서버 자원이 허용하는 대로 자원 할당이 가능합니다. "
#~ "자원 정책을 정하지 않고 서버 자원이 허용하는 대로 자원 할당이 가능합니다. "
#~ "이는 다른 자원 설정에도 마찬가지로 적용됩니다."

#~ msgid "RAM: Maximum memory."
Expand Down Expand Up @@ -1043,10 +1043,10 @@ msgstr ""
#~ "each users. You can deactivate a resource policy by turning off Active "
#~ "Status."
#~ msgstr ""
#~ "Control 열에서 설정 아이콘을 클릭하여 리소스 그룹을 편집할 수 있습니다. "
#~ "Control 열에서 설정 아이콘을 클릭하여 자원 그룹을 편집할 수 있습니다. "
#~ "Select scheduler 필드에서 연산 세션 생성 스케줄링 방식을 선택할 수 있는데, "
#~ "현재 지원하는 방식은 FIFO, LIFO, DRF 세 가지 입니다. FIFO와 LIFO는 가장 처"
#~ "음 또는 가장 마지막에 작업 큐에 들어온 연산 세션을 먼저 생성하는 방식으로 스"
#~ "케줄링 방식이고, DRF는 Dominant Resource Fairness의 약자로 사용자 별로 최대"
#~ "한 공평하게 자원 할당이 가능하도록 조절하여 스케줄링 하는 방식입니다. "
#~ "Active Status를 꺼서 해당 리소스 정책을 비활성화 할 수 있습니다."
#~ "Active Status를 꺼서 해당 자원 정책을 비활성화 할 수 있습니다."
6 changes: 3 additions & 3 deletions docs/locale/ko/LC_MESSAGES/appendix/appendix.po
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@ msgid ""
msgstr ""
"잠시 기다리면 세 개의 연산 세션이 나타납니다. 상태 패널을 자세히 살펴보면 세 개의 연산 세션 중 두 개는 RUNNING 상태에 "
"있지만 다른 연산 세션은 PENDING 상태로 남아 있음을 알 수 있습니다. 이 PENDING 세션은 작업 대기열에만 등록되며 "
"GPU 리소스 부족으로 인해 실제로 컨테이너 할당을 받지 못했습니다."
"GPU 자원 부족으로 인해 실제로 컨테이너 할당을 받지 못했습니다."

#: ../../appendix/appendix.rst:108
msgid ""
Expand Down Expand Up @@ -576,10 +576,10 @@ msgstr "백업 데이터를 통해 Etcd 설정을 복원하려면 다음과 같
#~ "total accessible resources."
#~ msgstr ""
#~ "LAUNCH 버튼을 클릭하여 연산 세션을 생성하면 상단의"
#~ " 리소스 인디케이터에 CPU, RAM, FGPU 의 양이"
#~ " 자원 인디케이터에 CPU, RAM, FGPU 의 양이"
#~ " 변화되는 것을 볼 수 있습니다. 현재 할당해서 "
#~ "사용하고 있는 지원의 양과 할당 가능한 총 자원의"
#~ " 양을 볼 수 있습니다. 리소스 인디케이터는 위, "
#~ " 양을 볼 수 있습니다. 자원 인디케이터는 위, "
#~ "아래 두 부분으로 나누어져 있습니다. 윗 부분은 "
#~ "현재 자원 그룹 내의 지원 할당 상태를 보여주고,"
#~ " 아랫 부분은 접근 가능한 총 자원 상태를 "
Expand Down
4 changes: 2 additions & 2 deletions docs/locale/ko/LC_MESSAGES/cluster_session/cluster_session.po
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ msgid ""
"Containers under a cluster session are created across one or more Agent "
"nodes which belon to a resource group."
msgstr ""
"클러스터 세션을 구성하는 컨테이너는 한 리소스 그룹에 속한 하나 이상의 Agent "
"클러스터 세션을 구성하는 컨테이너는 한 자원 그룹에 속한 하나 이상의 Agent "
"노드에 걸쳐 생성 됩니다."

#: ../../cluster_session/cluster_session.rst:28
Expand Down Expand Up @@ -294,7 +294,7 @@ msgid ""
"node, all of them are created on that node. This is to minimize network "
"latency between the containers."
msgstr ""
"Multi Node: 구성 컨테이너는 리소스 그룹 내에 있는 여러 Agent 노드에 걸쳐 생"
"Multi Node: 구성 컨테이너는 자원 그룹 내에 있는 여러 Agent 노드에 걸쳐 생"
"성됩니다. 다만, 모든 컨테이너가 하나의 Agent 노드에 생성될 수 있는 경우에"
"는, 하나의 Agent 노드에 우선 생성합니다. 이는 컨테이너 간 통신 과정에서 네트"
"워크 지연 시간을 최대한 줄이기 위함입니다."
Expand Down
10 changes: 5 additions & 5 deletions docs/locale/ko/LC_MESSAGES/overview/overview.po
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ msgid ""
"Backend.AI supports the efficient use of GPUs by flexibly dividing one "
"physical GPU, so that multiple users can use it at the same time."
msgstr ""
"Backend.AI 는 오픈소스 클라우드 리소스 관리 플랫폼입니다. Backend.AI 는 클라우"
"Backend.AI 는 오픈소스 클라우드 자원 관리 플랫폼입니다. Backend.AI 는 클라우"
"드 또는 온-프레미스 클러스터 환경에서 연산 자원을 효율적으로 관리하며 언제 어디"
"서나 on-demand 로 계산에 필요한 가상화된 연산 환경을 제공합니다. 또한, Backend."
"AI 의 컨테이너 기반 GPU 분할 가상화 기술을 통해 하나의 물리 GPU 를 유연하게 나"
Expand Down Expand Up @@ -296,15 +296,15 @@ msgstr "클러스터 묶음"

#: ../../overview/overview.rst:120
msgid "Resource groups by H/W spec and usage"
msgstr "하드웨어 스펙과 사용 형태에 따른 리소스 그룹"
msgstr "하드웨어 스펙과 사용 형태에 따른 자원 그룹"

#: ../../overview/overview.rst:122
msgid "(Enterprise) Access control of users to resource group"
msgstr "(엔터프라이즈) 사용자 리소스 그룹 배치"
msgstr "(엔터프라이즈) 사용자 자원 그룹 배치"

#: ../../overview/overview.rst:125
msgid "(Enterprise) Access control of group to resource group"
msgstr "(엔터프라이즈) 사용자 그룹 리소스 그룹 배치"
msgstr "(엔터프라이즈) 사용자 그룹 자원 그룹 배치"

#: ../../overview/overview.rst:128
msgid "Security"
Expand Down Expand Up @@ -499,7 +499,7 @@ msgstr "사용자 설정 (UserSettings)"
#~ "AI helps scientists, DevOps, enterprise, and AI enthusiasts to scale up "
#~ "efficiently."
#~ msgstr ""
#~ "Backend.AI는 오픈소스 클라우드 리소스 관리 플랫폼입니다. Backend.AI는 클라우"
#~ "Backend.AI는 오픈소스 클라우드 자원 관리 플랫폼입니다. Backend.AI는 클라우"
#~ "드 또는 온-프레미스 클러스터 환경에서 연산 자원을 효율적으로 관리하며 언제 "
#~ "어디서나 on-demand로 계산에 필요한 가상화된 연산 환경을 제공합니다. GPU 분"
#~ "할 가상화를 제공하여, 과학자, 데브옵스, 기업 및 AI 애호가들이 효율적으로 규"
Expand Down
2 changes: 1 addition & 1 deletion docs/locale/ko/LC_MESSAGES/session_list/session_list.po
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ msgstr ""
#~ " lower part shows the allocation "
#~ "status of total accessible resources."
#~ msgstr ""
#~ "화면 상단에는 리소스 표시부가 출력됩니다. 현재 사용자가"
#~ "화면 상단에는 자원 표시부가 출력됩니다. 현재 사용자가"
#~ " 할당받아 사용하고 있는 자원의 양과 할당 가능한 "
#~ "총 자원의 양을 확인할 수 있습니다. 위, 아래"
#~ " 두 부분으로 나누어 표시바가 출력되는데, 위쪽은 "
Expand Down

0 comments on commit c1dc15b

Please sign in to comment.