Merge branch 'rtd-theme' into development

This commit is contained in:
Kevin Putnam
2019-07-31 13:43:44 -07:00
8 changed files with 693 additions and 685 deletions
File diff suppressed because it is too large Load Diff
+28 -29
View File
@@ -4,33 +4,32 @@
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"PO-Revision-Date: 2019-07-29 17:41-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/autoproxy.rst:4
msgid "Autoproxy"
msgstr ""
msgstr "Autoproxy"
#: ../../tooling/autoproxy.rst:6
msgid ""
"Autoproxy is provided to enable |CL-ATTR| to work smoothly behind a "
"corporate proxy."
msgstr ""
msgstr "借助 Autoproxy,|CL-ATTR| 可在公司代理服务器后平稳运行。"
#: ../../tooling/autoproxy.rst:14
msgid "Description"
msgstr ""
msgstr "描述"
#: ../../tooling/autoproxy.rst:16
msgid ""
@@ -38,7 +37,7 @@ msgid ""
"automatically resolve the proxy needed for a given connection. With "
"Autoproxy, you can use |CL| inside any proxy environment without having "
"to manually configure the proxies."
msgstr ""
msgstr "Autoproxy 会尝试检测代理自动配置 (PAC) 脚本,并使用其自动解析给定连接所需的代理。使用 Autoproxy,可以在任意代理环境下使用 |CL|,而无需手动配置代理。"
#: ../../tooling/autoproxy.rst:21
msgid ""
@@ -49,7 +48,7 @@ msgid ""
"cloning a repo or checking for updates. With |CL|, all of the work is "
"done behind the scenes to effortlessly use your network and have "
"connections “just work”."
msgstr ""
msgstr "公司和专用网络可能非常复杂,因此出于安全原因需限制和控制网络连接。常见的负面效果是限制或阻止连接,且需手动配置代理以执行最普通的任务,例如克隆存储库或检查是否存在更新。通过 |CL|,所有工作便可在后台完成,以便轻松使用网络并使连接“正常工作”。"
#: ../../tooling/autoproxy.rst:28
msgid ""
@@ -58,11 +57,11 @@ msgid ""
"worrying about the proxy not being set, and you can remove unset proxies "
"from the equation when dealing with network unavailability across "
"systems."
msgstr ""
msgstr "此功能可消除因代理问题所导致的极端复杂的网络连接难题。可以自动执行任务(例如单元测试),而无需担心代理未设置,并可在处理跨系统的网络不可用问题时将未设置代理这一因素排除在外。"
#: ../../tooling/autoproxy.rst:34
msgid "How it works"
msgstr ""
msgstr "工作原理"
#: ../../tooling/autoproxy.rst:36
msgid ""
@@ -73,11 +72,11 @@ msgid ""
"PAC file. The daemon then passes the URL into PACrunner\\*. PACrunner "
"downloads the PAC file and uses the newly implemented Duktape\\* engine "
"to parse it."
msgstr ""
msgstr "我们围绕多数 Linux\\* 发行版提供的工具设计了 Autoproxy,同时还进行了一些小修小补。我们利用从系统获取的 DHCP 和网络信息,创建了 PAC 发现守护程序。该守护程序使用此信息来解析 PAC 文件的 URL。然后,守护程序将此 URL 传入 PACrunner\\*。PACrunner 下载 PAC 文件,使用新实现的 Duktape\\* 引擎来对其进行解析。"
#: ../../tooling/autoproxy.rst:47
msgid "Figure 1: Autoproxy Flow"
msgstr ""
msgstr "图 1:Autoproxy 流程"
#: ../../tooling/autoproxy.rst:49
msgid ""
@@ -88,11 +87,11 @@ msgid ""
"Thus, your environment settings are respected and no time is wasted "
"trying to resolve a proxy. All these steps happen in the background with "
"no user interaction."
msgstr ""
msgstr "此后,所有 cURL\\* 或网络请求均会查询 PACrunner 以使用正确的代理。我们修改了 cURL 库以通过 DBus 与 PACrunner 进行通信。但是,如果未加载 PAC 文件或手动设置代理,cURL 则会忽略 PACrunner 并正常运行。如此一来,环境设置便会得以应用,且不会浪费时间来尝试解析代理。所有这些步骤均在后台执行,而无需用户介入。"
#: ../../tooling/autoproxy.rst:57
msgid "Troubleshooting"
msgstr ""
msgstr "故障排除"
#: ../../tooling/autoproxy.rst:59
msgid ""
@@ -100,63 +99,63 @@ msgid ""
":ref:`swupd <swupd-guide>` and other |CL| tools are implemented on top of"
" libcurl. Tools that do not use libcurl, like git, must be configured "
"independently."
msgstr ""
msgstr "Autoproxy 允许 |CL| 在代理后无缝运行,因为 :ref:`swupd <swupd-guide>` 和其他 |CL| 工具的实现均基于 libcurl。不使用 libcurl 的工具(例如 git)则须单独配置。"
#: ../../tooling/autoproxy.rst:64
msgid ""
"If you are familiar with PAC files and WPAD, you can use "
":command:`pacdiscovery` and :command:`FindProxyForURL` to troubleshoot "
"problems with autproxy."
msgstr ""
msgstr "如果熟悉 PAC 文件和 WPAD,则可使用 :command:`pacdiscovery` 和 :command:`FindProxyForURL`,通过 Autoproxy 进行故障排除。"
#: ../../tooling/autoproxy.rst:70
msgid "Learn more about WPAD, PAC files, and PAC functions at `findproxyforurl`_."
msgstr ""
msgstr "访问 `findproxyforurl`_,了解有关 WPAD、PAC 文件和 PAC 的更多信息。"
#: ../../tooling/autoproxy.rst:74
msgid "Run :command:`pacdiscovery` with no arguments to indicate"
msgstr ""
msgstr "不带参数运行 :command:`pacdiscovery`,可以明确"
#: ../../tooling/autoproxy.rst:76
msgid "if there is a problem resolving the :command:`WPAD` host name resolution:"
msgstr ""
msgstr "解析 :command:`WPAD` 主机名时是否出现问题:"
#: ../../tooling/autoproxy.rst:87
msgid "or if the :command:`pacrunner` service is disabled (masked)."
msgstr ""
msgstr "或是是否已禁用(已屏蔽):command:`pacrunner` 服务。"
#: ../../tooling/autoproxy.rst:98
msgid "Unmask the :command:`pacrunner` service by running:"
msgstr ""
msgstr "运行以下命令取消屏蔽 :command:`pacrunner` 服务:"
#: ../../tooling/autoproxy.rst:104
msgid ""
":command:`FindProxyForURL` with :command:`busctl` can also indicate if "
"the :command:`pacrunner.service` is masked."
msgstr ""
msgstr ":command:`FindProxyForURL` 和 :command:`busctl`,也可以明确是否已屏蔽 :command:`pacrunner.service`。"
#: ../../tooling/autoproxy.rst:117
msgid ""
":command:`FindProxyForURL` returns the URL and port of the proxy server "
"when an external URL and host are provided as arguments."
msgstr ""
msgstr ":command:`FindProxyForURL` 会在外部 URL 和主机作为参数提供时,返回代理服务器的 URL 和端口。"
#: ../../tooling/autoproxy.rst:129
msgid ""
"If a proxy server is not avialable, or if :command:`pacrunner` is running"
" without a PAC file, :command:`FindProxyForURL` will return \"DIRECT\"."
msgstr ""
msgstr "如果无代理服务器或是 :command:`pacrunner` 正在运行但不带 PAC 文件,:command:`FindProxyForURL` 则会返回 \"DIRECT\"。"
#: ../../tooling/autoproxy.rst:141
msgid ""
"Once :command:`pacdiscovery` is able to look up :command:`WPAD`, restart "
"the :command:`pacrunner` service:"
msgstr ""
msgstr ":command:`pacdiscovery` 可查找 :command:`WPAD` 后,立即重新启动 :command:`pacrunner` 服务:"
#: ../../tooling/autoproxy.rst:151
msgid ""
"A \"domain\" or \"search\" entry in :file:`/etc/resolv.conf` is required "
"for short name lookups to resolve. The :file:`resolv.conf` man page has "
"additional details."
msgstr ""
msgstr ":file:`/etc/resolv.conf` 中的 \"domain\" 或 \"search\" 条目是查找短名称以便进行解析所必需的条目。:File:`resolv.conf` 手册页包含其他详细信息。"
+110 -110
View File
@@ -4,23 +4,22 @@
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"PO-Revision-Date: 2019-07-29 17:41-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/autospec.rst:4
msgid "autospec"
msgstr ""
msgstr "autospec"
#: ../../tooling/autospec.rst:6
msgid ""
@@ -29,11 +28,11 @@ msgid ""
"(RPM Package Manager)` build process using :command:`rpmbuild` requires a"
" tarball and :file:`.spec` file to start, autospec requires only a "
"tarball and package name to start."
msgstr ""
msgstr "**autospec** 是在 |CL-ATTR| 中协助自动创建和维护 RPM 封装的工具。其中,使用 :command:`rpmbuild` 的标准 :abbr:`RPM (RPM Package Manager)` 构建流程需要 tarball 和 :file:`.spec` 文件才能启动,而 autospec 只需 tarball 和软件包名称便可启动。"
#: ../../tooling/autospec.rst:16
msgid "Description"
msgstr ""
msgstr "描述"
#: ../../tooling/autospec.rst:18
msgid ""
@@ -43,91 +42,91 @@ msgid ""
" build failures until it has a complete and valid :file:`.spec` file. If "
"needed, you can influence the behavior of autospec and customize the "
"build by providing optional `control files`_ to the autospec tool."
msgstr ""
msgstr "autospec 工具通过分析源代码和 :file:`Makefile` 信息来尝试推断 :file:`.spec` 文件的要求。它会根据从构建失败中发现的新信息不断运行更新后的内部版本,直到它具有完整有效的 :file:`.spec` 文件。如有必要,可以在 autospec 工具中增加可选的 `control files`_,影响 autospec 的行为,定制内部版本。"
#: ../../tooling/autospec.rst:25
msgid ""
"autospec uses **mock** as a sandbox to run the builds. Visit the `mock "
"wiki`_ for additional information on using mock."
msgstr ""
msgstr "autospec 使用 **模拟** 作为沙箱运行内部版本。访问 `mock wiki`_,了解有关使用模拟的其他信息。"
#: ../../tooling/autospec.rst:28
msgid ""
"For a general understanding of how an RPM works, visit the `rpm website`_"
" or the `RPM Packaging Guide`_ ."
msgstr ""
msgstr "要大致了解 RPM 工作原理,请访问 `rpm website`_ 或 `RPM Packaging Guide`_。"
#: ../../tooling/autospec.rst:32
msgid "How it works"
msgstr ""
msgstr "工作原理"
#: ../../tooling/autospec.rst:34
msgid "Learn the autospec tool set up and process."
msgstr ""
msgstr "了解 autospec 工具的设置和流程。"
#: ../../tooling/autospec.rst:41
msgid "Prerequisites"
msgstr ""
msgstr "必备条件"
#: ../../tooling/autospec.rst:43
msgid ""
"The setup for building source in |CL| must be completed before using the "
"autospec tool."
msgstr ""
msgstr "使用 autospec 工具之前,必须先在 |CL| 中完成构建源代码的设置操作。"
#: ../../tooling/autospec.rst:46
msgid ""
"Refer to `Setup environment to build source`_ for instructions on "
"completing the setup."
msgstr ""
msgstr "请参阅 `Setup environment to build source`_,了解有关完成此设置的说明。"
#: ../../tooling/autospec.rst:50
msgid "Create an RPM"
msgstr ""
msgstr "创建 RPM"
#: ../../tooling/autospec.rst:52
msgid "The basic autospec process is described in the following steps:"
msgstr ""
msgstr "autospec 的基本流程如以下步骤所述:"
#: ../../tooling/autospec.rst:54
msgid ""
"The :command:`make autospec` command generates a :file:`.spec` file based"
" on the analysis of code and existing control files."
msgstr ""
msgstr ":command:`make autospec` 命令根据对代码和现有控制文件的分析生成 :file:`.spec` 文件。"
#: ../../tooling/autospec.rst:57
msgid ""
"Any control files should be located in the same directory as the "
"resulting :file:`.spec` file."
msgstr ""
msgstr "所有控制文件均应与所生成 :file:`.spec` 文件位于同一目录。"
#: ../../tooling/autospec.rst:60
msgid "View the `autospec README`_ for more information on `control files`_."
msgstr ""
msgstr "查看 `autospec README`_,了解有关 `control files`_ 的更多信息。"
#: ../../tooling/autospec.rst:62
msgid "autospec creates a build root with mock config."
msgstr ""
msgstr "autospec 通过模拟配置来创建内部版本根目录。"
#: ../../tooling/autospec.rst:64
msgid "autospec attempts to build an RPM from the generated :file:`.spec`."
msgstr ""
msgstr "autospec 会尝试通过所生成的 :file:`.spec` 来构建 RPM。"
#: ../../tooling/autospec.rst:66
msgid "autospec detects any missed declarations in the :file:`.spec`."
msgstr ""
msgstr "autospec 会检测 :file:`.spec` 中的所有缺失声明。"
#: ../../tooling/autospec.rst:68
msgid ""
"If build errors occur, autospec scans the build log to try to detect the "
"root cause."
msgstr ""
msgstr "如果出现构建错误,autospec 则会扫描构建日志,尝试发现根源所在。"
#: ../../tooling/autospec.rst:71
msgid ""
"If autospec detects the root cause and knows how to continue, it restarts"
" the build automatically at step 1 with updated build instructions."
msgstr ""
msgstr "如果 autospec 检测到根源,且知如何继续,则会在步骤 1 中利用更新后的构建指令自动重新启动构建。"
#: ../../tooling/autospec.rst:74
msgid ""
@@ -136,17 +135,17 @@ msgid ""
"and/or editing control files to resolve issues, which may include "
"dependencies or exclusions. See `autospec README`_ for more information "
"on control files."
msgstr ""
msgstr "否则,autospec 会停止构建,以供用户检查,纠正错误。修复源代码问题和/或编辑控制文件,响应构建过程输出,从而解决问题。这些问题可能包括依存关系或排除项。查看 `autospec README`_,了解有关控制文件的更多信息。"
#: ../../tooling/autospec.rst:80
msgid "The user resumes the process at step 1 after errors are resolved."
msgstr ""
msgstr "纠正错误后,用户在步骤 1 中恢复此流程。"
#: ../../tooling/autospec.rst:82
msgid ""
"If a binary dependency doesn't exist in |CL|, you must build it before "
"running autospec again."
msgstr ""
msgstr "如果 |CL| 中不存在二进制依存关系,则须先构建这种关系,然后才能再次运行 autospec。"
#: ../../tooling/autospec.rst:85
msgid ""
@@ -154,64 +153,64 @@ msgid ""
"on new information discovered from build failures, until it has a valid "
":file:`.spec`. If no build errors occur, RPM packages are successfully "
"built."
msgstr ""
msgstr "执行完这些步骤后,autospec 根据从构建失败中发现的新信息继续重新构建软件包,直到它具有有效的 :file:`.spec`。如果未出现构建错误,则会成功构建 RPM 包。"
#: ../../tooling/autospec.rst:90
msgid "Examples"
msgstr ""
msgstr "示例"
#: ../../tooling/autospec.rst:92
msgid "Complete `Setup environment to build source`_ before using these examples."
msgstr ""
msgstr "在使用这些示例之前,请先完成 `Setup environment to build source`_。"
#: ../../tooling/autospec.rst:99
msgid "Example 1: Build RPM with an existing spec file"
msgstr ""
msgstr "例 1:使用现有规格文件构建 RPM"
#: ../../tooling/autospec.rst:101
msgid ""
"This example shows how to build a RPM from a pre-packaged upstream "
"package with an existing spec file. The example uses the ``dmidecode`` "
"package."
msgstr ""
msgstr "本例介绍如何使用现有规格文件通过预封装的上游软件包来构建 RPM。本例采用 ``dmidecode`` 软件包。"
#: ../../tooling/autospec.rst:104 ../../tooling/autospec.rst:160
msgid "Navigate to the autospec workspace and clone the ``dmidecode`` package:"
msgstr ""
msgstr "导航到 autospec 工作区并克隆 ``dmidecode`` 软件包:"
#: ../../tooling/autospec.rst:113
msgid "You can clone all package repos at once using the following command:"
msgstr ""
msgstr "您可使用以下命令一次性克隆所有软件包存储库:"
#: ../../tooling/autospec.rst:119 ../../tooling/autospec.rst:216
msgid "The optional NUM is the number of threads to use."
msgstr ""
msgstr "可选 NUM 参数表示待用线程数量。"
#: ../../tooling/autospec.rst:121
msgid ""
"For a list of available packages, view the "
":file:`~/clearlinux/projects/common/packages` file."
msgstr ""
msgstr "有关可用软件包的列表,请查看 :file:`~/clearlinux/projects/common/packages` 文件。"
#: ../../tooling/autospec.rst:124
msgid "Navigate to the local copy of the ``dmidecode`` package and build it:"
msgstr ""
msgstr "导航到 ``dmidecode`` 软件包的本地副本进行构建:"
#: ../../tooling/autospec.rst:131
msgid ""
"The resulting RPMs are in :file:`./rpms`. Build logs and additional RPMs "
"are in :file:`./results`."
msgstr ""
msgstr "生成的 RPM 位于 :file:`./rpms`。构建日志和其他 RPM 则位于 :file:`./results`。"
#: ../../tooling/autospec.rst:135
msgid "Example 2: Build a new RPM"
msgstr ""
msgstr "例 2:构建新的 RPM"
#: ../../tooling/autospec.rst:137
msgid ""
"This example shows how to build a new RPM with no spec file. The example "
"will create a simple helloclear RPM."
msgstr ""
msgstr "本例介绍如何构建新的 RPM,而不使用规格文件。本例会创建简易的 helloclear RPM。"
#: ../../tooling/autospec.rst:140
msgid ""
@@ -220,52 +219,52 @@ msgid ""
"automatically generate an RPM package using the autospec tool. You must "
"pass the URL to the source tarball and the NAME of the RPM you wish to "
"create:"
msgstr ""
msgstr "导航到 autospec 工作区并构建 helloclear RPM。:file:`Makefile` 提供 :command:`make autospecnew`,可以使用 autospec 工具自动生成 RPM 包。必须将 URL 传递给源 tarball 以及待创建 RPM 的 NAME:"
#: ../../tooling/autospec.rst:150
msgid ""
"The resulting RPMs are in :file:`./packages/helloclear/rpms`. Build logs "
"and additional RPMs are in :file:`./packages/helloclear/results`."
msgstr ""
msgstr "生成的 RPM 位于 :file:`./packages/helloclear/rpms`。构建日志和其他 RPM 则位于 :file:`./packages/helloclear/results`。"
#: ../../tooling/autospec.rst:154
msgid "Example 3: Generate a new spec file with a pre-defined package"
msgstr ""
msgstr "例 3:使用预定义软件包生成新的规格文件"
#: ../../tooling/autospec.rst:156
msgid ""
"This example shows how to modify an existing package to create a custom "
"RPM. In this example you will make a simple change to the ``dmidecode`` "
"package and rebuild the package."
msgstr ""
msgstr "本例介绍如何修改现有软件包来创建定制 RPM。本例会对 ``dmidecode`` 软件包进行简单的更改并重新构建软件包。"
#: ../../tooling/autospec.rst:167
msgid "Navigate into the *dmidecode* directory:"
msgstr ""
msgstr "导航到 *dmidecode* 目录:"
#: ../../tooling/autospec.rst:173
msgid "Open the :file:`excludes` file with an editor and add these lines:"
msgstr ""
msgstr "用编辑器打开 :file:`excludes` 文件,添加以下行:"
#: ../../tooling/autospec.rst:186
msgid ""
"These files aren't needed by dmidecode, so we can remove them without any"
" issues."
msgstr ""
msgstr "dmidecode 不需要这些文件,因此可放心将其删除。"
#: ../../tooling/autospec.rst:189
msgid ""
"In the :file:`dmidecode` directory, build the modified ``dmidecode`` "
"package:"
msgstr ""
msgstr "在 :file:`dmidecode` 目录中,构建修改后的 ``dmidecode`` 软件包:"
#: ../../tooling/autospec.rst:195
msgid "The resulting RPMs are in :file:`./rpms`. Logs are in :file:`./results`."
msgstr ""
msgstr "生成的 RPM 位于 :file:`./rpms`。日志则位于 :file:`./results`。"
#: ../../tooling/autospec.rst:198
msgid "Example 4: Provide control files to autospec"
msgstr ""
msgstr "例 4:为 autospec 提供控制文件"
#: ../../tooling/autospec.rst:200
msgid ""
@@ -273,193 +272,193 @@ msgid ""
"that autospec is unable to resolve. In this example, you will add a "
"missing license and dependencies so autospec can complete a successful "
"build."
msgstr ""
msgstr "本例介绍如何修改控制文件,纠正 autospec 无法进行解析的构建问题。在本例中,您会添加缺少的许可证和依存关系,以便 autospec 成功完成构建。"
#: ../../tooling/autospec.rst:204
msgid "Navigate to the autospec workspace:"
msgstr ""
msgstr "导航到 autospec 工作区:"
#: ../../tooling/autospec.rst:210
msgid "If you have not already, clone all upstream package repos:"
msgstr ""
msgstr "如果尚未克隆所有上游数据包存储库,则进行克隆:"
#: ../../tooling/autospec.rst:220
msgid ""
"In a later step of this example, we will search the cloned package repos "
"for a missing dependency."
msgstr ""
msgstr "在本例的后续步骤中,我们搜索克隆的软件包存储库中是否存在缺少的依存关系。"
#: ../../tooling/autospec.rst:223
msgid "Build the opae-sdk RPM:"
msgstr ""
msgstr "构建 opae-sdk RPM:"
#: ../../tooling/autospec.rst:229
msgid "This results in an error for a missing license file:"
msgstr ""
msgstr "此操作会因缺少许可证文件而出错:"
#: ../../tooling/autospec.rst:235
msgid "Navigate to the package with build failures:"
msgstr ""
msgstr "导航到包含构建问题的软件包:"
#: ../../tooling/autospec.rst:241
msgid ""
"Add one or more valid license identifiers from the `SPDX License List "
"<https://spdx.org/licenses/>`_. In the example below, two different "
"licenses are appropriate based on the opae-sdk project licensing:"
msgstr ""
msgstr "添加一个或多个来自 `SPDX License List <https://spdx.org/licenses/>`_ 的有效许可证标识符。在下例中,根据 opae-sdk 项目许可,有两个不同的许可证适用:"
#: ../../tooling/autospec.rst:250
msgid "Run autospec again:"
msgstr ""
msgstr "再次运行 autospec:"
#: ../../tooling/autospec.rst:256
msgid "This results in a generic error:"
msgstr ""
msgstr "此操作会导致一般错误:"
#: ../../tooling/autospec.rst:262
msgid "Open the build log to view the error details:"
msgstr ""
msgstr "打开构建日志,查看错误详细信息:"
#: ../../tooling/autospec.rst:268
msgid ""
"The build log contains details for the specific failures. In this "
"instance, there are missing dependencies:"
msgstr ""
msgstr "构建日志包含特定故障的详细信息。在本例中,存在缺少的依存关系:"
#: ../../tooling/autospec.rst:281
msgid ""
"Search the spec files of upstream |CL| packages to see if the json-c "
"library is available. In this case, it does exist and we'll add the "
"json-c 'dev' package into the buildreq_add:"
msgstr ""
msgstr "搜索上游 |CL| 软件包的规格文件,查看 json-c 库是否可用。在本例中,此库不存在,我们需要将 json-c 'dev’ 软件包添加到 buildreq_add:"
#: ../../tooling/autospec.rst:292
msgid ""
"This search step works only if the user cloned all of the upstream "
"package repos. In this example, upstream package repos were cloned in a "
"previous step."
msgstr ""
msgstr "仅当用户已克隆所有上游软件包存储库后,此搜索步骤才有效。在本例中,已在上一步骤中克隆上游软件包存储库。"
#: ../../tooling/autospec.rst:296
msgid ""
"Search the spec files of upstream |CL| packages to see if the libuuid "
"library is available. In this case, it exists in the util-linux package, "
"so we'll add util-linux-dev package into the buildreq_add:"
msgstr ""
msgstr "搜索上游 |CL| 软件包的规格文件,查看 libuuid 库是否可用。在本例中,此库存在于 util-linux 软件包中,因此需要将 util-linux-dev 软件包添加到 buildreq_add:"
#: ../../tooling/autospec.rst:305
msgid ""
"Run autospec again and find the successfully-generated RPMs in the "
":file:`rpms` directory:"
msgstr ""
msgstr "再次运行 autospec 并在 :file:`rpms` 目录中查找成功生成的 RPM:"
#: ../../tooling/autospec.rst:314
msgid ""
"If you need a dependency that does not exist in the |CL| repo, you must "
"first build it manually (see `Example 2: Build a new RPM`_), then add the"
" repo so that autospec knows the package exists. For example:"
msgstr ""
msgstr "如需 |CL| 存储库中不存在的某一依存关系,则须首先对其进行手动构建(请参阅 `Example 2: Build a new RPM`_),然后添加此存储库,以便 autospec 了解存在此软件包。例如:"
#: ../../tooling/autospec.rst:324
msgid ""
"You only need to add the dependency to the :file:`buildreq_add` control "
"file if autospec is not able to automatically find the correct dependency"
" on its own."
msgstr ""
msgstr "如果 autospec 无法单独自动查找正确的依存关系,则需将此依存关系添加到 :file:`buildreq_add` 控制文件。"
#: ../../tooling/autospec.rst:329
msgid "Test packaged software"
msgstr ""
msgstr "测试封装后的软件"
#: ../../tooling/autospec.rst:331
msgid ""
"After software has been packaged with autospec, the resulting RPMs can be"
" tested for functionality before being integrated and deployed into a "
"|CL| image with the :ref:`Mixer tool <mixer>`."
msgstr ""
msgstr "使用 autospec 封装软件后,可对生成的 RPM 进行功能测试,然后再用 :ref:`Mixer tool <mixer>` 将其集成和部署到 |CL| 映像。"
#: ../../tooling/autospec.rst:335
msgid ""
"The |CL| development tooling offers two ways to quickly test autospec "
"generated RPMs."
msgstr ""
msgstr "|CL| 开发工具提供两种快速测试 autospec 所生成 RPM 的方法。"
#: ../../tooling/autospec.rst:339
msgid ""
"The methods outlined below should only be used for temporary testing on "
"development systems."
msgstr ""
msgstr "下列方法只应用于开发系统的临时测试。"
#: ../../tooling/autospec.rst:344
msgid "Test in a |CL| virtual machine"
msgstr ""
msgstr "在 |CL| 虚拟机上测试"
#: ../../tooling/autospec.rst:346
msgid ""
"The |CL| development tooling includes a method to install RPMs into a "
"|CL| virtual machine running on the KVM hypervisor. Using a :abbr:`VM "
"(Virtual Machine)` allows testing in a completely isolated environment."
msgstr ""
msgstr "|CL| 开发工具包括将 RPM 安装到 |CL| 虚拟机(在 KVM 管理程序上运行)的方法。使用 :abbr:`VM (Virtual Machine)`,可在完全隔离的环境下进行测试。"
#: ../../tooling/autospec.rst:350
msgid "To test an autospec-created package inside a VM:"
msgstr ""
msgstr "要测试在虚拟机内 autospec 创建的软件包:"
#: ../../tooling/autospec.rst:352
msgid ""
"Download the |CL| KVM image into the :file:`~/clearlinux` directory as "
":file:`clear.img`. The location and name :file:`clear.img.xz` is "
"important for the tooling to work:"
msgstr ""
msgstr "将 |CL| KVM 映像下载到 :file:`~/clearlinux` 目录,即 :file:`clear.img`。其位置和名称 :file:`clear.img.xz` 对于工具运行都十分重要:"
#: ../../tooling/autospec.rst:361
msgid "Extract the downloaded |CL| KVM image:"
msgstr ""
msgstr "解压缩已下载的 |CL| KVM 映像:"
#: ../../tooling/autospec.rst:367
msgid ""
"Copy the QEMU start script and virtual firmware needed for KVM into the "
":file:`~/clearlinux` directory:"
msgstr ""
msgstr "将 KVM 所需的 QEMU 启动脚本和虚拟固件复制到 :file:`~/clearlinux` 目录:"
#: ../../tooling/autospec.rst:375
msgid ""
"Run :command:`make install` from the package's autospec directory. The "
":command:`make install` command mounts the downloaded |CL| KVM image and "
"installs the autospec-created RPM into it:"
msgstr ""
msgstr "在此软件包的 autospec 目录中运行 :command:`make install`。:command:`make install` 命令可挂载已下载的 |CL| KVM 映像并将 autospec 创建的 RPM 安装到其中:"
#: ../../tooling/autospec.rst:384
msgid ""
"The code that makes this possible can be viewed by searching for the "
"*install:* target in the `Makefile.common`_ file on GitHub."
msgstr ""
msgstr "在 GitHub 上的 `Makefile.common`_ 文件中搜索 *install:* 目标,可以查看实现此操作的代码。"
#: ../../tooling/autospec.rst:387
msgid "Return to the :file:`~/clearlinux` directory and start the |CL| VM:"
msgstr ""
msgstr "返回到 :file:`~/clearlinux` 目录并启动 |CL| 虚拟机:"
#: ../../tooling/autospec.rst:394
msgid ""
"A new |CL| VM will launch in the console. Log into the VM as *root* and "
"set a new pasword for the VM."
msgstr ""
"set a new password for the VM."
msgstr "新的 |CL| 虚拟机随即在控制台上启动。以 *root* 用户身份登录到虚拟机,为此虚拟机设置新密码。"
#: ../../tooling/autospec.rst:397
msgid ""
"Check that the software is installed in the |CL| VM as expected and "
"perform any relevant tests."
msgstr ""
msgstr "确保该软件已正常安装到 |CL| 虚拟机上,然后完成所有相关测试。"
#: ../../tooling/autospec.rst:400
msgid ""
"After testing has been completed, the |CL| VM can be powered off and "
"deleted:"
msgstr ""
msgstr "测试完成后,可关闭并删除 |CL| 虚拟机:"
#: ../../tooling/autospec.rst:410
msgid "Test directly on a development machine"
msgstr ""
msgstr "直接在开发计算机上进行测试"
#: ../../tooling/autospec.rst:412
msgid ""
@@ -468,32 +467,32 @@ msgid ""
"Extracting an RPM directly onto a system offers quicker testing; however"
" conflicts may occur and responsibility to remove the software after "
"testing is up to the developer."
msgstr ""
msgstr "|CL| 开发工具还包括将 autospec 创建的 RPM 从本地解压缩到 |CL| 开发系统进行测试的方法。将 RPM 直接解压缩到系统中,可以加速测试过程,但可能发生冲突。同时,测试后删除软件的责任也取决于开发人员。"
#: ../../tooling/autospec.rst:418
msgid ""
"To test an autospec created package directly on the |CL| development "
"system:"
msgstr ""
msgstr "要直接在 |CL| 开发系统上测试 autospec 创建的软件包,必须执行以下步骤:"
#: ../../tooling/autospec.rst:420
msgid ""
"Run :command:`make install-local` from the package's autospec directory. "
"The :command:`make install-local` command extracts the RPM directly onto "
"the filesystem of the running |CL| system:"
msgstr ""
msgstr "在此软件包的 autospec 目录中运行 :command:`make install-local`。:command:`make install-local` 命令会将 RPM 直接解压缩到正在运行的 |CL| 系统的文件系统中:"
#: ../../tooling/autospec.rst:429
msgid ""
"The code that makes this possible can be viewed by searching for the "
"*install-local:* target in the `Makefile.common`_ file on GitHub."
msgstr ""
msgstr "在 GitHub 上的 `Makefile.common`_ 文件中搜索 *install-local:* 目标,可以查看实现此操作的代码。"
#: ../../tooling/autospec.rst:432
msgid ""
"Check that the software is installed as expected and perform any relevant"
" tests."
msgstr ""
msgstr "确保该软件已正常安装,然后完成所有相关测试。"
#: ../../tooling/autospec.rst:435
msgid ""
@@ -501,28 +500,28 @@ msgid ""
" be identified and deleted. The :command:`swupd repair --picky` command "
"can help restore the state of the :file:`/usr` directory (see :ref:`swupd"
" <swupd-about>`) however any other files must be cleaned up manually."
msgstr ""
msgstr "测试完成后,必须发现并删除该软件和所有相关文件。:command:`swupd repair --picky` 命令有助于还原 :file:`/usr` 目录的状态(请参阅 :ref:`swupd <swupd-about>`),但所有其他文件均须手动清理。"
#: ../../tooling/autospec.rst:443
msgid "References"
msgstr ""
msgstr "参考"
#: ../../tooling/autospec.rst:445
msgid ""
"Reference the `autospec README`_ for details regarding `autospec` "
"commands and options."
msgstr ""
msgstr "请参阅 `autospec README`_,了解有关 `autospec` 命令和选项的详细信息。"
#: ../../tooling/autospec.rst:448
msgid "Setup environment to build source"
msgstr ""
msgstr "设置环境以构建源代码"
#: ../../tooling/autospec.rst:452
msgid ""
"Setup of the workspace and tooling used for building source in |CL| is "
"mostly automated for you with a setup script. It uses tools from the "
":command:`os-clr-on-clr` bundle."
msgstr ""
msgstr "在 |CL| 中设置用于构建源代码的工作区和工具主要是通过设置脚本自动执行的。它使用 :command:`os-clr-on-clr` bundle 文件中的工具。"
#: ../../tooling/autospec.rst:456
msgid ""
@@ -530,49 +529,49 @@ msgid ""
"with the subfolders :file:`Makefile`, :file:`packages`, and "
":file:`projects`. The :file:`projects` folder contains the main tools "
"used for making packages in |CL| :file:`autospec` and :file:`common`."
msgstr ""
msgstr "该设置脚本会在 :file:`clearlinux` 文件夹中创建工作区,同时还会创建子文件夹 :file:`Makefile`、:file:`packages` 和 :file:`projects`。:file:`projects` 文件夹包含用于在 |CL| :file:`autospec` 和 :file:`common` 中创建软件包的主要工具。"
#: ../../tooling/autospec.rst:461
msgid "Follow these steps to setup the workspace and tooling for building source:"
msgstr ""
msgstr "按照以下步骤设置工作区和工具以构建源代码:"
#: ../../tooling/autospec.rst:463
msgid "Install the :command:`os-clr-on-clr` bundle:"
msgstr ""
msgstr "安装 :command:`os-clr-on-clr` bundle 文件:"
#: ../../tooling/autospec.rst:469
msgid "Download the :file:`user-setup.sh` script:"
msgstr ""
msgstr "下载 :file:`user-setup.sh` 脚本:"
#: ../../tooling/autospec.rst:475
msgid "Make :file:`user-setup.sh` executable:"
msgstr ""
msgstr "将 :file:`user-setup.sh` 转换为可执行文件:"
#: ../../tooling/autospec.rst:481
msgid "Run the script as an unprivileged user:"
msgstr ""
msgstr "以非特权用户身份运行脚本:"
#: ../../tooling/autospec.rst:487
msgid ""
"After the script completes, log out and log in again to complete the "
"setup process."
msgstr ""
msgstr "脚本完成后,注销并再次登录,完成设置流程。"
#: ../../tooling/autospec.rst:490
msgid "Set your Git user email and username for the repos on your system:"
msgstr ""
msgstr "为系统上的存储库设置 Git 用户电子邮件和用户名:"
#: ../../tooling/autospec.rst:497
msgid "This global setting is used by |CL| tools that make use of Git."
msgstr ""
msgstr "此全局设置由采用 Git 的 |CL| 工具使用。"
#: ../../tooling/autospec.rst:502
msgid "Related topics"
msgstr ""
msgstr "相关主题"
#: ../../tooling/autospec.rst:504
msgid ":ref:`Mixer tool <mixer>`"
msgstr ""
msgstr ":ref:`Mixer tool <mixer>`"
#~ msgid ""
#~ "The code that makes this possible "
@@ -588,3 +587,4 @@ msgstr ""
#~ "`Makefile.common file on GitHub`_."
#~ msgstr ""
+24 -24
View File
@@ -4,23 +4,22 @@
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"PO-Revision-Date: 2019-07-29 17:41-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/debug.rst:4
msgid "Debug system"
msgstr ""
msgstr "调试系统"
#: ../../tooling/debug.rst:6
msgid ""
@@ -29,18 +28,18 @@ msgid ""
"necessary debug information on-the-fly over a network during a debugging "
"session. On the server side, the system curates and compresses debug "
"information into small pieces for efficient downloading."
msgstr ""
msgstr "|CL-ATTR| 引入了一种使用 *clr-debug-info* 进行系统软件调试的新方法。在客户端,|CL| 调试系统会在调试会话期间通过网络即时获取所有必要的调试信息。在服务器端,系统将调试信息整理并压缩为较小的数据块,方便高效下载。"
#: ../../tooling/debug.rst:12
msgid ""
"For developers, this avoids the interruption during debugging that "
"usually happens when debug information is missing. This can be especially"
" useful on systems where storage is limited."
msgstr ""
msgstr "对于开发人员,此举可避免调试期间通常在缺少调试信息的情况下所出现的中断问题。对于存储空间有限的系统,此功能尤其实用。"
#: ../../tooling/debug.rst:22
msgid "Background"
msgstr ""
msgstr "后台"
#: ../../tooling/debug.rst:24
msgid ""
@@ -49,7 +48,7 @@ msgid ""
"program, such as binaries and libraries. Extra developer data, such as "
"the actual source code and symbol information, are separated and excluded"
" for efficiency."
msgstr ""
msgstr "为在操作系统中进行一般使用而编译和封装的软件通常仅包含用于执行程序的组件,例如二进制文件和库。为提高效率,其他开发数据则会被分置并排除,例如实际的源代码和符号信息。"
#: ../../tooling/debug.rst:30
msgid ""
@@ -57,54 +56,54 @@ msgid ""
"code lines and variables. Most of the time, this auxiliary information is"
" not needed; however without it, debugging a program results in limited "
"visibility."
msgstr ""
msgstr "调试信息有助将二进制代码与人类可读的源代码行和变量进行关联。多数情况下,这些辅助信息并不需要。但如果缺少此类信息,调试程序时便无法提供足够的可见性。"
#: ../../tooling/debug.rst:37
msgid "Usage"
msgstr ""
msgstr "用途"
#: ../../tooling/debug.rst:39
msgid ""
"The clr-debug-info system is integrated into |CL| and seamlessly engages "
"once installed."
msgstr ""
msgstr "clr-debug-info 系统已集成到 |CL| 并在安装后立即无缝结合。"
#: ../../tooling/debug.rst:42
msgid "Install the *dev-utils* bundle."
msgstr ""
msgstr "安装 *dev-utils* bundle 文件。"
#: ../../tooling/debug.rst:50
msgid ""
"The *telemetrics* and *performance-tools* bundles also include clr-debug-"
"info."
msgstr ""
msgstr "*telemetrics* 和 *performance-tools* bundle 文件也包含 clr-debug-info。"
#: ../../tooling/debug.rst:54
msgid ""
"Start a debugging session against a program using a debugger, such as "
"GDB. For example, to debug *gnome-control-center* execute the following "
"command:"
msgstr ""
msgstr "使用调试程序(如 GDB)针对程序启动调试会话。例如,要调试 *gnome-control-center*,请执行以下命令:"
#: ../../tooling/debug.rst:62
msgid ""
"As you step through the program and debug information is needed, the "
"clr_debug_daemon obtains it in the background."
msgstr ""
msgstr "单步执行程序且需调试信息时,clr_debug_daemon 便会在后台获取所需信息。"
#: ../../tooling/debug.rst:67
msgid "Implementation"
msgstr ""
msgstr "实现"
#: ../../tooling/debug.rst:69
msgid ""
"The implementation of the |CL| debug system is open source and available "
"on GitHub at: https://github.com/clearlinux/clr-debug-info/"
msgstr ""
msgstr "|CL| 调试系统的实现为开源程序且可在 GitHub 上的以下位置找到:https://github.com/clearlinux/clr-debug-info/"
#: ../../tooling/debug.rst:76
msgid "Figure 1: The communication flow of the |CL| debug system"
msgstr ""
msgstr "图 1:|CL| 调试系统的通信流程"
#: ../../tooling/debug.rst:78
msgid ""
@@ -112,7 +111,7 @@ msgid ""
" filesystem mounted at :file:`/usr/lib/debug` and :file:`/usr/src/debug`."
" The FUSE filesystem starts automatically. You can verify its status by "
"executing :command:`systemctl status clr_debug_fuse.service`."
msgstr ""
msgstr "|CL| 调试系统可实现在 :file:`/usr/lib/debug` 和 :file:`/usr/src/debug` 挂载的 :abbr:`FUSE (filesystem in userspace)` 文件系统。FUSE 文件系统会自动启动。可以执行 :command:`systemctl status clr_debug_fuse.service` 来验证状态。"
#: ../../tooling/debug.rst:83
msgid ""
@@ -121,14 +120,15 @@ msgid ""
"debugging programs that need it. It is socket activated whenever a "
"request to the local FUSE filesystem occurs. You can verify its status "
"with :command:`systemctl status clr_debug_daemon.service`."
msgstr ""
msgstr "*clr_debug_daemon* 负责从服务器获取相应的软件包调试内容,并提供给需要它的所有调试程序。只要对本地 FUSE 文件系统发出请求,便会通过套接字将其激活。可以使用 :command:`systemctl status clr_debug_daemon.service` 来验证状态。"
#: ../../tooling/debug.rst:90
msgid ""
"|CL| hosts debuginfo content packaged for consumption by |CL| debug "
"clients at https://download.clearlinux.org/debuginfo/"
msgstr ""
msgstr "|CL| 存储有专供 |CL| 调试客户端(位于 https://download.clearlinux.org/debuginfo/)使用而封装的调试信息内容"
#~ msgid "Debug System"
#~ msgstr ""
+35 -35
View File
@@ -4,42 +4,41 @@
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"PO-Revision-Date: 2019-07-29 17:41-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/ister.rst:4
msgid "ister.py image builder"
msgstr ""
msgstr "ister.py image builder"
#: ../../tooling/ister.rst:6
msgid ""
"The `ister.py`_ tool is a template-based installer used by |CL-ATTR| to "
"produce images for each release. The same ister tool is available for use"
" in |CL| to create custom images based on an upstream image."
msgstr ""
msgstr "`ister.py`_ 工具是 |CL-ATTR| 使用的一款基于模板的安装程序,可以生成每个版本的映像。|CL| 中也可以使用该款 ister 工具,可以根据上游映像定制创建映像。"
#: ../../tooling/ister.rst:15
msgid "Description"
msgstr ""
msgstr "描述"
#: ../../tooling/ister.rst:17
msgid ""
"|CL| is a rolling release and produces an average of 10 releases per week"
" using the ister tool. With each release we produce multiple :ref:`image "
" using the ister tool. With each release, we produce multiple :ref:`image "
"types for different environments <image-types>` and use cases such as "
"installers, Hyper-V, KVM, or VMWare."
msgstr ""
msgstr "|CL| 是一个滚动发行版本,使用该款 ister 工具每周平均生成 10 个版本。针对每个版本,我们均会生成多个 :ref:`image types for different environments <image-types>` 和用例,如安装程序、Hyper-V、KVM 或 VMWare。"
#: ../../tooling/ister.rst:22
msgid ""
@@ -48,7 +47,7 @@ msgid ""
"type, partitions, version, and bundles that will be preinstalled by "
"default with the image. For each image type we produce, the corresponding"
" JSON configuration file for the image also is published."
msgstr ""
msgstr "每个映像均有一个 JSON 配置文件。ister 使用配置文件生成映像。这些 JSON 配置文件描述了默认情况下预安装映像的映像类型、分区、版本和 bundle 文件。针对所生成的每种映像类型,同时还会发布映像的相应 JSON 配置文件。"
#: ../../tooling/ister.rst:28
msgid ""
@@ -57,69 +56,69 @@ msgid ""
"for the image, which ister uses to generate the image. Refer to the "
":ref:`mixer<mixer>` guide for instructions on using ister to build an "
"image for a custom mix."
msgstr ""
msgstr ":ref:`mixer<mixer>` 工具也用 ister 为定制组合构建映像。与上游映像一样,系统会为该映像定义 ister 用于生成映像的 JSON 配置文件。请参阅 :ref:`mixer<mixer>` 指南,查看使用 ister 为定制组合构建映像的说明。"
#: ../../tooling/ister.rst:34
msgid "Examples"
msgstr ""
msgstr "示例"
#: ../../tooling/ister.rst:37
msgid "Recreate an upstream image"
msgstr ""
msgstr "重新创建上游映像"
#: ../../tooling/ister.rst:39
msgid ""
"The published configuration files for upstream images may be used to "
"recreate an image. Here are some examples:"
msgstr ""
msgstr "上游映像的已发布配置文件可用于重新创建映像。部分示例如下:"
#: ../../tooling/ister.rst:42
msgid ""
"Use an older version of |CL| and the image is no longer available (only "
"after March 2017)."
msgstr ""
msgstr "不再提供旧版 |CL| 和映像(仅 2017 年 3 月后)。"
#: ../../tooling/ister.rst:44
msgid "Customize the partitions of an image."
msgstr ""
msgstr "定制映像的分区。"
#: ../../tooling/ister.rst:45
msgid "Customize the bundles preinstalled in an image."
msgstr ""
msgstr "定制映像中预安装的 bundle 文件。"
#: ../../tooling/ister.rst:46
msgid "Run your own post installation script."
msgstr ""
msgstr "运行自己的安装后脚本。"
#: ../../tooling/ister.rst:49
msgid ""
"Follow these steps to recreate an upstream image based on the image's "
"JSON configuration file:"
msgstr ""
msgstr "按照以下步骤,根据映像的 JSON 配置文件重新创建上游映像:"
#: ../../tooling/ister.rst:52
msgid ""
"Install the :command:`os-installer` bundle. Refer to :ref:`swupd-guide` "
"for more information on installing bundles."
msgstr ""
msgstr "安装 :command:`os-installer` bundle 文件。请参阅 :ref:`swupd-guide`,了解有关安装 bundle 文件的更多信息。"
#: ../../tooling/ister.rst:55
msgid "Download the `ister.py`_ tool and grant it sudo privileges."
msgstr ""
msgstr "下载 `ister.py`_ 工具并为其授予 sudo 权限。"
#: ../../tooling/ister.rst:57
msgid ""
"Download the JSON configuration file for the desired image (located in "
":file:`config/image/`):"
msgstr ""
msgstr "下载所需映像的 JSON 配置文件(位于 :file:`config/image/`):"
#: ../../tooling/ister.rst:60
msgid "`Current release`_"
msgstr ""
msgstr "`Current release`_"
#: ../../tooling/ister.rst:61
msgid "`Previous releases`_ (only after March 2017)"
msgstr ""
msgstr "`Previous releases`_ (仅 2017 年 3 月后)"
#: ../../tooling/ister.rst:63
msgid ""
@@ -127,44 +126,44 @@ msgid ""
"version you want, and find the JSON configuration file under "
":file:`/clear/config/image`. For example: "
"``https://cdn.download.clearlinux.org/releases/15700/clear/config/image/``"
msgstr ""
msgstr "针对先前版本,请导航到 `Previous releases`_,选择所需版本,然后在 :file:`/clear/config/image` 下找到 JSON 配置文件。例如:``https://cdn.download.clearlinux.org/releases/15700/clear/config/image/``"
#: ../../tooling/ister.rst:68
msgid "Download the “PostNonChroot” script (if applicable)."
msgstr ""
msgstr "下载“PostNonChroot”脚本(如果适用)。"
#: ../../tooling/ister.rst:70
msgid ""
"The JSON configuration file for the image may have an accompanying "
"“PostNonChroot” script that is executed at the end of the image creation "
"process. If it does, download the script and make it executable."
msgstr ""
msgstr "此映像的 JSON 配置文件可能附带“PostNonChroot”脚本,在映像创建过程结束时执行。如果是,则下载此脚本,将其转换为可执行文件。"
#: ../../tooling/ister.rst:74
msgid "Edit the JSON configuration file as needed."
msgstr ""
msgstr "按需编辑 JSON 配置文件。"
#: ../../tooling/ister.rst:76
msgid ""
"If your configuration file has an accompanying \"PostNonChroot\" script, "
"change the default path of the script to match your path."
msgstr ""
msgstr "如果此配置文件附带 \"PostNonChroot\" 脚本,则将此脚本的默认路径更改为您的路径。"
#: ../../tooling/ister.rst:79
msgid "Generate the new image with the following command:"
msgstr ""
msgstr "用以下命令生成新映像:"
#: ../../tooling/ister.rst:86
msgid "Related topics"
msgstr ""
msgstr "相关主题"
#: ../../tooling/ister.rst:88
msgid ":ref:`mixer`"
msgstr ""
msgstr ":ref:`mixer`"
#: ../../tooling/ister.rst:89
msgid ":ref:`bulk-provision`"
msgstr ""
msgstr ":ref:`bulk-provision`"
#~ msgid ""
#~ "The `ister.py tool`_ is a template-"
@@ -190,3 +189,4 @@ msgstr ""
#~ msgid "`Configuration files for the current release`_"
#~ msgstr ""
File diff suppressed because it is too large Load Diff
+87 -87
View File
@@ -4,54 +4,53 @@
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"PO-Revision-Date: 2019-07-29 17:41-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/swupd-guide.rst:4
msgid "swupd"
msgstr ""
msgstr "swupd"
#: ../../tooling/swupd-guide.rst:6
msgid ""
":command:`swupd` links a |CL-ATTR| installation with upstream updates and"
" software."
msgstr ""
msgstr ":command:`swupd` 将 |CL-ATTR| 安装与上游更新和软件进行链接。"
#: ../../tooling/swupd-guide.rst:14
msgid "Description"
msgstr ""
msgstr "描述"
#: ../../tooling/swupd-guide.rst:16
msgid ":command:`swupd` has two main functions:"
msgstr ""
msgstr ":command:`swupd` 有两个主要功能:"
#: ../../tooling/swupd-guide.rst:18
msgid ""
"Manage software and replace APT or YUM, by installing bundles rather than"
" packages."
msgstr ""
msgstr "通过安装 bundle 文件而非软件包来管理软件并替换 APT 或 YUM。"
#: ../../tooling/swupd-guide.rst:20
msgid "Check for system updates and install them."
msgstr ""
msgstr "检查是否存在系统更新并进行安装。"
#: ../../tooling/swupd-guide.rst:22
msgid ""
":command:`swupd` manages overlapping dependencies behind the scenes, "
"ensuring that all software is compatible across the system. It can be "
"used to verify the OS, clean cached files, and fix issues."
msgstr ""
msgstr ":command:`swupd` 可管理后台的重叠依存关系,从而确保所有软件在整个系统中兼容。它可以验证操作系统、清理缓存文件和修复问题。"
#: ../../tooling/swupd-guide.rst:26
msgid ""
@@ -60,17 +59,17 @@ msgid ""
"by |CL|. A bundle comes with all of its dependencies rather than "
"downloading a cascade of package dependencies when installing a piece of "
"software."
msgstr ""
msgstr ":ref:`Bundles <bundles>` 包含提供软件功能所需的一切。它们是 |CL| 管理的最小粒度组件。bundle 文件附带所有依存关系,而非在安装软件时下载一系列软件包依存关系。"
#: ../../tooling/swupd-guide.rst:33
msgid "Versioning"
msgstr ""
msgstr "版本管理"
#: ../../tooling/swupd-guide.rst:35
msgid ""
"Using package managers to monitor software version compatibility or "
"compare multiple systems on many Linux distributions can be cumbersome."
msgstr ""
msgstr "使用软件包管理器监控软件版本兼容性或比较大量 Linux 发行版上的多个系统可能十分麻烦。"
#: ../../tooling/swupd-guide.rst:38
msgid ""
@@ -80,7 +79,7 @@ msgid ""
"removals. This rolling release versioning model is similar to "
":command:`git` internal version tracking, where any of the individual "
"file commits are tracked and move the pointer forward when changed."
msgstr ""
msgstr "借助 |CL| :command:`swupd`,则可在个别文件级别进行版本管理。也就是说,|CL| 会生成全新的操作系统版本,且附带对系统所做的所有软件更改,其中包括软件降级或删除。此滚动发布版本管理模型类似于 :command:`git` 内部版本跟踪,会跟踪所有单个文件提交并在更改时将指针前移。"
#: ../../tooling/swupd-guide.rst:45
msgid ""
@@ -92,11 +91,11 @@ msgid ""
"combinations of software have been tested. Every release of the same "
"number is guaranteed to contain the same versions of software, so there's"
" no ambiguity between two systems running the same version of |CL|."
msgstr ""
msgstr "表示操作系统 **当前** 版本的数字,描述操作系统上所有软件的版本。每个内部版本均由一组特定的 bundle 文件组成,而这些 bundle 文件则由特定版本的软件包组成。如果系统管理员日常需要确定哪些系统缺少最新安全修复程序,或哪些软件组合已经过测试,这对他们来说十分重要。对于同一数字的每个版本,均可以保证包含相同版本的软件,因此在运行同一版本的 |CL| 的两个系统之间不会产生混淆。"
#: ../../tooling/swupd-guide.rst:55
msgid "Updating"
msgstr ""
msgstr "更新中"
#: ../../tooling/swupd-guide.rst:57
msgid ""
@@ -107,7 +106,7 @@ msgid ""
"*manifests*, which list and describe file contents, symlinks, and "
"directories. Additionally, the actual content is provided to clients in "
"the form of archive files."
msgstr ""
msgstr "|CL| 默认强制定期更新操作系统,并自动对照版本服务器检查是否存在更新。内容服务器提供针对所有版本的文件和元数据内容,并可与版本服务器相同。内容 URL 服务器以 *清单* 形式提供元数据,列出并描述文件内容、符号链接和目录。此外,实际内容还会以存档文件的形式提供给客户端。"
#: ../../tooling/swupd-guide.rst:65
msgid ""
@@ -116,35 +115,35 @@ msgid ""
"rather than entire packages. For example, it is quite common for an OS "
"security patch to be as small as 15 KB. Using binary deltas, |CL| is able"
" to apply only what is needed."
msgstr ""
msgstr "|CL| 的软件更新也十分高效。与基于软件包的发行版不同,:command:`swupd` 只会更新已更改的文件,而非整个软件包。例如,操作系统安全补丁大小经常只有 15 KB。通过使用二进制增量,|CL| 可只应用所需的内容。"
#: ../../tooling/swupd-guide.rst:71
msgid ""
"For details on how to generate update content for |CL|, see the "
":ref:`mixer <mixer>` tool."
msgstr ""
msgstr "有关如何为 |CL| 生成更新内容的详细信息,请参阅 :ref:`mixer <mixer>` 工具。"
#: ../../tooling/swupd-guide.rst:75
msgid "How it works"
msgstr ""
msgstr "工作原理"
#: ../../tooling/swupd-guide.rst:78
msgid "Prerequisites"
msgstr ""
msgstr "必备条件"
#: ../../tooling/swupd-guide.rst:80
msgid "The device is on a well-connected network."
msgstr ""
msgstr "设备网络连接良好。"
#: ../../tooling/swupd-guide.rst:81
msgid ""
"The device is able to connect to an update server. The default server is:"
" http://update.clearlinux.org"
msgstr ""
msgstr "设备可连接到更新服务器。默认服务器地址为:http://update.clearlinux.org"
#: ../../tooling/swupd-guide.rst:85
msgid "Updates"
msgstr ""
msgstr "更新"
#: ../../tooling/swupd-guide.rst:87
msgid ""
@@ -152,11 +151,11 @@ msgid ""
"demand. :command:`swupd` makes sure that regular updates are simple and "
"secure. It can also check the validity of currently installed files and "
"software, and can correct any problems."
msgstr ""
msgstr "|CL| 更新默认自动进行,但也可设为按需进行。:command:`swupd` 可确保定期更新既简单又安全。它还可检查当前已安装文件和软件的有效性,并可更正所有问题。"
#: ../../tooling/swupd-guide.rst:93
msgid "Manifests"
msgstr ""
msgstr "清单"
#: ../../tooling/swupd-guide.rst:95
msgid ""
@@ -164,24 +163,24 @@ msgid ""
"is the files that end up in the OS. The metadata contains relevant "
"information to properly provision the data to the OS file system, as well"
" as update the system and add or remove additional content to the OS."
msgstr ""
msgstr "|CL| 软件更新内容由数据和元数据组成。数据是指操作系统中的文件。元数据包含将数据正确配置到操作系统文件系统、更新系统以及向操作系统添加或删除其他内容所需的相关信息。"
#: ../../tooling/swupd-guide.rst:100
msgid ""
"The manifests are mostly long lists of hashes that describe content. Each"
" bundle gets its own manifest file. There is a master manifest file that "
"describes all manifests to tie it all together."
msgstr ""
msgstr "清单多为用于描述内容的长哈希列表。每个 bundle 文件均有自己的清单文件。主清单文件描述了所有清单,可以将其绑定在一起。"
#: ../../tooling/swupd-guide.rst:105
msgid "Fullfiles, packs, and delta packs"
msgstr ""
msgstr "完整文件、数据包和增量包"
#: ../../tooling/swupd-guide.rst:107
msgid ""
"To speed up updates and optimize content delivery, update data "
"provisioned to a system is obtained by one of the following methods:"
msgstr ""
msgstr "要加速更新并优化内容交付,可通过以下方法获取配置到系统的更新数据:"
#: ../../tooling/swupd-guide.rst:110
msgid ""
@@ -189,86 +188,86 @@ msgid ""
"allows any |CL| to obtain the exact copy of the content for each version "
"directly. This is used if the OS verification needs to replace a single "
"file, for instance."
msgstr ""
msgstr "在每个版本中,始终会为每个文件生成 *完整文件*。此操作可让所有 |CL| 直接获取每个版本的精确内容副本。例如,如果操作系统验证需替换单个文件,则可使用此操作。"
#: ../../tooling/swupd-guide.rst:115
msgid ""
"*Packs* are available for some releases. They combine many files to speed"
" up the creation of installation media and large updates."
msgstr ""
msgstr "*数据包* 可用于某些版本。它们将大量文件进行组合,从而加速安装介质制作过程,加快大型更新过程。"
#: ../../tooling/swupd-guide.rst:118
msgid ""
"*Delta packs* are an optimized version of packs that only contain updates"
" (binary diffs). They cannot be used without having the original file "
"content."
msgstr ""
msgstr "*增量包* 是只包含更新(二进制差异)的优化版本的数据包。如果没有原始文件内容,则无法使用。"
#: ../../tooling/swupd-guide.rst:122
msgid "Bundle search"
msgstr ""
msgstr "bundle 文件搜索"
#: ../../tooling/swupd-guide.rst:124
msgid ""
":command:`swupd` searches download manifest data for bundles that match "
"the term. Enter only one term, or hyphenated term, per search. Use the "
"command :command:`man swupd` to learn more."
msgstr ""
msgstr ":command:`swupd` 可搜索下载清单数据,查找与此字词匹配的 bundle 文件。每次搜索只输入一个字词或带连字符的字词。使用命令 :command:`man swupd`,了解更多信息。"
#: ../../tooling/swupd-guide.rst:128
msgid ""
"Only the base bundle is returned. Bundles can contain other bundles via "
"includes. For more details, see `Bundle Definition Files`_ and its "
"subdirectory bundles."
msgstr ""
msgstr "系统只返回基本 bundle 文件。bundle 文件可通过 include 包含其他 bundle 文件。有关更多详细信息,请参阅 `Bundle Definition Files`_ 及其子目录 bundle 文件。"
#: ../../tooling/swupd-guide.rst:132
msgid ""
"Bundles that are already installed are marked **(installed)** in search "
"results."
msgstr ""
msgstr "已安装的 bundle 文件在搜索结果中标记为 **(已安装)**。"
#: ../../tooling/swupd-guide.rst:135
msgid "Optionally, you can review our `bundles`_ on GitHub\\*."
msgstr ""
msgstr "您可以选择查看 GitHub\\* 上的 `bundles`_。"
#: ../../tooling/swupd-guide.rst:138
msgid "Examples"
msgstr ""
msgstr "示例"
#: ../../tooling/swupd-guide.rst:141
msgid "Example 1: Disable and enable automatic updates"
msgstr ""
msgstr "例 1:禁用和启用自动更新"
#: ../../tooling/swupd-guide.rst:143
msgid ""
"|CL| updates are automatic by default, but can be set to occur only on "
"demand."
msgstr ""
msgstr "|CL| 更新默认自动进行,但也可设为按需进行。"
#: ../../tooling/swupd-guide.rst:146
msgid "Verify your current auto-update setting."
msgstr ""
msgstr "验证当前的自动更新设置。"
#: ../../tooling/swupd-guide.rst:156
msgid "Disable automatic updates."
msgstr ""
msgstr "禁用自动更新。"
#: ../../tooling/swupd-guide.rst:170
msgid "Check manually for updates."
msgstr ""
msgstr "手动检查是否存在更新。"
#: ../../tooling/swupd-guide.rst:176
msgid "Install an update after identifying one that you need."
msgstr ""
msgstr "确定所需的更新后对其进行安装。"
#: ../../tooling/swupd-guide.rst:182
msgid "Re-enable automatic installs."
msgstr ""
msgstr "再次启用自动安装。"
#: ../../tooling/swupd-guide.rst:191
msgid "Example 2: Find and install Kata Containers\\*"
msgstr ""
msgstr "例 2:查找并安装 Kata 容器\\*"
#: ../../tooling/swupd-guide.rst:193
msgid ""
@@ -276,171 +275,171 @@ msgid ""
"container implementations, each Kata Container has its own kernel "
"instance and runs on its own :abbr:`VM (Virtual Machine)` for improved "
"security."
msgstr ""
msgstr "Kata 容器是一种常见的容器实现。与其他容器实现不同,每个 Kata 容器均有自己的内核实例,在自己的 :abbr:`VM (Virtual Machine)` 上运行,增强了安全性。"
#: ../../tooling/swupd-guide.rst:198
msgid ""
"|CL| makes it very easy to install, since you only need to add one bundle"
" to use `Kata Containers`_: `containers-virt`_, despite a number of "
"dependencies. Also, check out our tutorial: :ref:`kata`."
msgstr ""
msgstr "虽然存在大量依存关系,但由于您只需添加一个 bundle 文件便可使用 `Kata Containers`_ `containers-virt`_,因此 |CL| 大大简化了安装过程。此外,请查阅教程::ref:`kata`。"
#: ../../tooling/swupd-guide.rst:202
msgid "Find the correct bundle."
msgstr ""
msgstr "找到正确的 bundle 文件。"
#: ../../tooling/swupd-guide.rst:204
msgid ""
"To return all possible matches for the search string, enter "
":command:`swupd search`, followed by 'kata':"
msgstr ""
msgstr "要返回搜索字符串的所有潜在匹配项,请输入 :command:`swupd search`,后跟“kata”:"
#: ../../tooling/swupd-guide.rst:211
msgid "The output should be similar to:"
msgstr ""
msgstr "输出如下所示:"
#: ../../tooling/swupd-guide.rst:229
msgid ""
"If your search does not produce results with a specific term, shorten the"
" search term. For example, use *kube* instead of *kubernetes*."
msgstr ""
msgstr "如果搜索结果中没有带特定字词,则请缩短搜索字词。例如,使用 *kube* 而非 *kubernetes*。"
#: ../../tooling/swupd-guide.rst:232
msgid "Add the bundle."
msgstr ""
msgstr "添加 bundle 文件。"
#: ../../tooling/swupd-guide.rst:240
msgid "To add multiple bundles, add a space followed by the bundle name."
msgstr ""
msgstr "要添加多个 bundle 文件,请添加一个空格,后跟 bundle 文件名称。"
#: ../../tooling/swupd-guide.rst:242
msgid "The output of a successful installation should be similar to:"
msgstr ""
msgstr "成功安装的输出如下所示:"
#: ../../tooling/swupd-guide.rst:261
msgid "Example 3: Verify and correct system file mismatch"
msgstr ""
msgstr "例 3:验证并更正系统文件不匹配错误"
#: ../../tooling/swupd-guide.rst:263
msgid ""
":command:`swupd` can determine whether system directories and files have "
"been added to, overwritten, removed, or modified (e.g., permissions)."
msgstr ""
msgstr ":command:`swupd` 可确定是否已添加、覆盖、删除或修改系统目录和文件(例如权限)。"
#: ../../tooling/swupd-guide.rst:270
msgid ""
"All directories that are watched by :command:`swupd` are verified "
"according to the manifest data. Hash mismatches are flagged as follows:"
msgstr ""
msgstr ":command:`swupd` 所监控的所有目录均会根据清单数据进行验证。哈希不匹配项将按如下方式进行标记:"
#: ../../tooling/swupd-guide.rst:287
msgid ""
"In this case, Python\\* packages that were installed on top of the "
"default install were flagged as mismatched. :command:`swupd` can be "
"directed to ignore or fix issues based on command line options."
msgstr ""
msgstr "在此情况下,安装在默认安装之上的 Python\\* 软件包将被标记为不匹配。:command:`swupd` 可根据命令行选项指令来忽略或修复问题。"
#: ../../tooling/swupd-guide.rst:291
msgid ""
":command:`swupd` can correct any issues it detects. Additional directives"
" can be added including a white list of directories to be ignored."
msgstr ""
msgstr ":command:`swupd` 可更正检测到的所有问题。还可以添加其他指令,其中包括要忽略的目录的白名单。"
#: ../../tooling/swupd-guide.rst:294
msgid ""
"The following command repairs issues, removes unknown items, and ignores "
"files or directories matching :file:`/usr/lib/python`:"
msgstr ""
msgstr "以下命令可修复问题,删除未知项目,忽略匹配 :file:`/usr/lib/python` 的文件或目录:"
#: ../../tooling/swupd-guide.rst:302
msgid "Quick reference"
msgstr ""
msgstr "快速参考"
#: ../../tooling/swupd-guide.rst:305
msgid "swupd info"
msgstr ""
msgstr "swupd info"
#: ../../tooling/swupd-guide.rst:305
msgid "Returns the currently installed version and update servers."
msgstr ""
msgstr "返回当前安装的版本和更新服务器。"
#: ../../tooling/swupd-guide.rst:309
msgid "swupd update <version number>"
msgstr ""
msgstr "swupd update <version number>"
#: ../../tooling/swupd-guide.rst:308
msgid ""
"Updates to a specific version or updates to latest version if no "
"arguments are used."
msgstr ""
msgstr "如果未使用参数,则更新到特定版本或最新版本。"
#: ../../tooling/swupd-guide.rst:312
msgid "swupd bundle-list [--all]"
msgstr ""
msgstr "swupd bundle-list [--all]"
#: ../../tooling/swupd-guide.rst:312
msgid "Lists installed bundles."
msgstr ""
msgstr "列出已安装的 bundle 文件。"
#: ../../tooling/swupd-guide.rst:315
msgid "swupd bundle-add [-b] <search term>"
msgstr ""
msgstr "swupd bundle-add [-b] <search term>"
#: ../../tooling/swupd-guide.rst:315
msgid "Finds a bundle that contains your search term."
msgstr ""
msgstr "查找包含搜索字词的 bundle 文件。"
#: ../../tooling/swupd-guide.rst:318
msgid "swupd bundle-add <bundle name>"
msgstr ""
msgstr "swupd bundle-add <bundle name>"
#: ../../tooling/swupd-guide.rst:318
msgid "Adds a bundle."
msgstr ""
msgstr "添加 bundle 文件。"
#: ../../tooling/swupd-guide.rst:321
msgid "swupd bundle-remove <bundle name>"
msgstr ""
msgstr "swupd bundle-remove <bundle name>"
#: ../../tooling/swupd-guide.rst:321
msgid "Removes a bundle."
msgstr ""
msgstr "删除 bundle 文件。"
#: ../../tooling/swupd-guide.rst:324
msgid "swupd --help"
msgstr ""
msgstr "swupd --help"
#: ../../tooling/swupd-guide.rst:324
msgid "Lists additional :command:`swupd` commands."
msgstr ""
msgstr "列出其他 :command:`swupd` 命令。"
#: ../../tooling/swupd-guide.rst:327
msgid "man swupd"
msgstr ""
msgstr "man swupd"
#: ../../tooling/swupd-guide.rst:327
msgid "Opens the :command:`swupd` man page."
msgstr ""
msgstr "打开 :command:`swupd` 手册页。"
#: ../../tooling/swupd-guide.rst:329
msgid "Refer to `swupd source documentation`_ on GitHub for more details."
msgstr ""
msgstr "请参阅 GitHub 上的 `swupd source documentation`_,了解更多详细信息。"
#: ../../tooling/swupd-guide.rst:332
msgid "Related topics"
msgstr ""
msgstr "相关主题"
#: ../../tooling/swupd-guide.rst:334
msgid ":ref:`autospec`"
msgstr ""
msgstr ":ref:`autospec`"
#: ../../tooling/swupd-guide.rst:335
msgid ":ref:`mixer`"
msgstr ""
msgstr ":ref:`mixer`"
#: ../../tooling/swupd-guide.rst:336
msgid ":ref:`bundles`"
msgstr ""
msgstr ":ref:`bundles`"
#~ msgid ""
#~ "|CL| makes it very easy to "
@@ -457,3 +456,4 @@ msgstr ""
#~ "details."
#~ msgstr ""
+23 -14
View File
@@ -7,20 +7,24 @@ This tutorial describes how to install, configure, and run the
`Kubernetes container orchestration system`_ on |CL-ATTR| using CRI+O and
kata-runtime.
Kubernetes\* is an open source system for automating deployment, scaling, and
.. contents::
:local:
:depth: 1
Description
***********
Kubernetes is an open source system for automating deployment, scaling, and
management of containerized applications. It groups containers that make up
an application into logical units for easy management and discovery.
Kata Containers\* kata-runtime adheres to
:abbr:`OCI (Open Container Initiative*)` guidelines and work seamlessly with
Kubernetes. `Kata Containers`_ provide strong isolation for untrusted
:abbr:`OCI (Open Container Initiative*)` guidelines and works seamlessly with
Kubernetes. `Kata Containers`_ provides strong isolation for untrusted
workloads or multi-tenant scenarios. Kata Containers can be
allocated on a per-pod basis so you can mix and match both on the same host
allocated on a per-pod basis, so you can mix and match both on the same host
to suit your needs.
.. contents:: :local:
:depth: 1
Prerequisites
*************
@@ -267,9 +271,10 @@ Proxy configuration (optional)
******************************
If you use a proxy server, you must set your proxy environment variables and
create an appropriate proxy configuration file for both CRI-O services. Consult your IT department if you are behind a corporate proxy for
the appropriate values. Ensure that your local IP is **explicitly included**
in the environment variable *NO_PROXY*. (Setting *localhost* is not enough.)
create an appropriate proxy configuration file for both CRI-O services. Consult
your IT department if you are behind a corporate proxy for the appropriate
values. Ensure that your local IP is **explicitly included** in the environment
variable *NO_PROXY*. (Setting *localhost* is not enough.)
If you have already set your proxy environment variables, run the following
commands as a shell script to configure all of these services in one step:
@@ -304,7 +309,8 @@ Troubleshooting
For example: 100.200.50.20 myhost
Use the commands :command:`hostname` and :command:`hostname -I` to retrieve them.
Use the commands :command:`hostname` and :command:`hostname -I`
to retrieve them.
* Images cannot be pulled.
@@ -343,8 +349,8 @@ Troubleshooting
sudo touch profile
#. With a preferred editor, open `profile`, and enter your proxy settings.
Example shown below.
#. With your preferred editor, open `profile`, and enter your proxy settings.
An example is shown below.
.. code-block:: bash
@@ -359,7 +365,8 @@ Troubleshooting
#. Save and exit the `profile`.
#. Run:
#. Update your system's environment settings by executing the following
command:
.. code-block:: bash
@@ -383,6 +390,8 @@ Troubleshooting
/* Kubernetes with CRI-O + kata-runtime */
sudo -E kubeadm init --cri-socket=/run/crio/crio.sock
.. _Kubernetes container orchestration system: https://kubernetes.io/
.. _Kata Containers: https://katacontainers.io/