ножевой супермаркет

[править на GitHub]

Подкоманда knife supermarket используется для взаимодействия с кулинарными книгами, расположенными на общедоступном супермаркете, а также на частных сайтах супермаркетов Chef. Для любых действий в сообществе, которые записывают данные в супермаркет Chef, требуется учетная запись пользователя; однако следующие аргументы не требуют учетной записи пользователя: download, search, install, и list.

Примечание

Пожалуйста, рассмотрите возможность управления кулинарными книгами сообщества с помощью версии Berkshelf, которая поставляется с Chef Workstation. Дополнительную информацию о Chef Workstation см. в разделе О Chef Workstation.

Примечание

Просмотрите список общих опций, доступных для этой (и всех) подкоманд и плагинов knife.

скачать

Используйте аргумент download для загрузки кулинарной книги из супермаркета Chef. Кулинарная книга будет загружена в формате архива tar.gz и помещена в текущую рабочую директорию. Если кулинарная книга (или версия кулинарной книги) устарела, и опция --force не используется, knife предупредит пользователя об устаревании кулинарной книги и затем предоставит имя самой последней не устаревшей версии этой кулинарной книги.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket download COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

COOKBOOK_VERSION: Версия кулинарной книги, подлежащей загрузке. Если кулинарная книга имеет только одну версию, этот параметр указывать не нужно. Если кулинарная книга имеет более одной версии и этот параметр не указан, загружается самая последняя версия кулинарной книги.
-f FILE, --file FILE: Файл, в который записывается загрузка кулинарной книги.
--force: Перезаписать существующий каталог.
-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Загрузка кулинарной книги

Для загрузки кулинарной книги mysql, введите:

knife supermarket download mysql

установить

Используйте аргумент install для установки кулинарной книги, загруженной из супермаркета Chef в локальный репозиторий git. Это действие использует систему управления версиями git в сочетании с сайтом супермаркета Chef для установки кулинарных книг, внесённых сообществом, в локальный репозиторий chef-repo. Использование этого аргумента выполняет следующие действия:

Создается новая ветвь «чистая копия» в git для отслеживания upstream.
Все существующие версии кулинарной книги удаляются из ветви.
Кулинарная книга загружается из супермаркета Chef в формате tar.gz.
Загруженная кулинарная книга распаковывается, и её содержимое коммитится в git, и создается тег.
Ветка «чистая копия» объединяется с ветвью master.

Этот процесс позволяет изменять кулинарную книгу upstream в ветви master, позволяя git поддерживать изменения как отдельный патч. При появлении обновленной версии upstream эти изменения могут быть объединены, сохраняя при этом любые локальные изменения.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket install COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

-b, --use-current-branch: Убедиться, что используется текущая ветвь.
-B BRANCH, --branch BRANCH: Название ветви по умолчанию. По умолчанию используется ветвь master.
COOKBOOK_VERSION: Версия кулинарной книги, подлежащей установке. Если версия не указана, устанавливается самая последняя версия кулинарной книги.
-D, --skip-dependencies: Убедиться, что все кулинарные книги, от которых установленная кулинарная книга зависит, не установлены.
-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.
-o PATH:PATH, --cookbook-path PATH:PATH: Каталог, в котором создаются кулинарные книги. Это может быть путь, разделённый двоеточием.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Установка кулинарной книги

Для установки кулинарной книги mysql, введите:

knife supermarket install mysql

список

Используйте аргумент list для просмотра списка кулинарных книг, которые в настоящее время доступны в супермаркете Chef.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket list (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.
-w, --with-uri: Показать соответствующие URI.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Просмотр списка кулинарных книг

Для просмотра списка кулинарных книг на сервере супермаркета Chef, введите:

knife supermarket list

для возврата списка, аналогичного:

1password                            minecraft
301                                  mineos
7-zip                                minidlna
AWS_see_spots_run                    minitest
AmazonEC2Tag                         minitest-handler
Appfirst-Cookbook                    mirage
CVE-2014-3566-poodle                 mlocate
CVE-2015-0235                        mod_security
Obfsproxy                            mod_security2
R                                    modcloth-hubot
Rstats                               modcloth-nad
SysinternalsBginfo                   modman
VRTSralus                            modules
abiquo                               mogilefs
acadock                              mongodb
accel-ppp                            mongodb-10gen
accounts                             mongodb-agents
accumulator                          monit
...

поиск

Используйте аргумент search для поиска кулинарных книг, расположенных в супермаркете Chef. Запрос поиска используется для возврата списка этих кулинарных книг и использует тот же синтаксис, что и подкоманда knife search.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket search SEARCH_QUERY (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Поиск кулинарных книг

Для поиска кулинарной книги используйте команду, подобную:

knife supermarket search mysql

где mysql - поисковый термин. Это вернёт что-то подобное:

mysql:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql
  cookbook_description: Provides mysql_service, mysql_config, and mysql_client resources
  cookbook_maintainer:  chef
  cookbook_name:        mysql
mysql-apt-config:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-apt-config
  cookbook_description: Installs/Configures mysql-apt-config
  cookbook_maintainer:  tata
  cookbook_name:        mysql-apt-config
mysql-multi:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-multi
  cookbook_description: MySQL replication wrapper cookbook
  cookbook_maintainer:  rackops
  cookbook_name:        mysql-multi

Используйте аргумент share для добавления кулинарной книги в супермаркет Chef. Это действие потребует учетной записи пользователя и сертификата для супермаркета Chef. По умолчанию knife будет использовать имя пользователя и API-ключ, указанные в файле конфигурации, используемом во время загрузки; в противном случае эти значения необходимо указать в командной строке или в альтернативном файле конфигурации. Если кулинарная книга уже существует в супермаркете Chef, то только владелец или участник разработки этой кулинарной книги может вносить изменения.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket share COOKBOOK_NAME CATEGORY (options)

Параметры

Этот аргумент имеет следующие параметры:

CATEGORY: Категория кулинарной книги: "Databases", "Web Servers", "Process Management", "Monitoring & Trending", "Programming Languages", "Package Management", "Applications", "Networking", "Operating Systems & Virtualization", "Utilities", или "Other".
-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.
-o PATH:PATH, --cookbook-path PATH:PATH: Каталог, в котором создаются кулинарные книги. Это может быть путь, разделённый двоеточием.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Разделить кулинарную книгу

Для разделения кулинарной книги с именем my_apache2_cookbook и добавления её в категорию Web Servers в супермаркете Chef:

knife supermarket share "my_apache2_cookbook" "Web Servers"

показать

Используйте аргумент show для просмотра информации о кулинарной книге, расположенной в супермаркете Chef.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket show COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

COOKBOOK_VERSION: Версия кулинарной книги для показа. Если кулинарная книга имеет только одну версию, этот параметр указывать не нужно. Если кулинарная книга имеет более одной версии и этот параметр не указан, возвращается список версий кулинарной книги.
-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Показать данные кулинарной книги

Для показа подробностей кулинарной книги с именем mysql:

knife supermarket show mysql

что вернет что-то подобное:

average_rating:
category:      Other
created_at:    2009-10-28T19:16:54.000Z
deprecated:    false
description:   Provides mysql_service, mysql_config, and mysql_client resources
external_url:  https://github.com/chef-cookbooks/mysql
issues_url:    https://github.com/chef-cookbooks/mysql/issues
latest_version:  https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1
maintainer:    sous-chefs
metrics:
  collaborators: 2
  downloads:
    total:  128998032
  versions:
    0.10.0: 927561
    0.15.0: 927536
    0.20.0: 927321
    0.21.0: 927298
    0.21.1: 927311
    0.21.2: 927424
    0.21.3: 927441
    0.21.5: 927326
    0.22.0: 927297
    0.23.0: 927353
    0.23.1: 927862
    0.24.0: 927316

Показать данные версии кулинарной книги

Для показа подробностей версии кулинарной книги, выполните команду, аналогичную:

knife supermarket show mysql 8.5.1

где mysql - кулинарная книга и 8.5.1 - версия кулинарной книги. Это вернёт что-то подобное:

average_rating:
cookbook:        https://supermarket.chef.io/api/v1/cookbooks/mysql
file:            https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1/download
license:         Apache-2.0
published_at:    2017-08-23T19:01:28Z
quality_metrics:
  failed: false
  feedback: passed the No Binaries metric. Contains no obvious binaries.
  name:   No Binaries

  failed: false
  feedback: mysql passed the publish metric
  name:   Publish

  failed: false
  feedback: mysql supports at least one platform.
  name:   Supported Platforms

  failed: false
  feedback: passed the Collaborators Metric with 2 collaborators.
  name:   Collaborator Number

  failed: false
  feedback:
  Run with Foodcritic Version 14.0.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
  name:   Foodcritic

  failed: false
  feedback: passed the CONTRIBUTING.md file metric.
  name:   Contributing File

  failed: false
  feedback: passed the version tag metric.
  name:   Version Tag

  failed: false
  feedback: passed the TESTING.md file metric.
  name:   Testing File
supports:
  amazon:     >= 0.0.0
  centos:     >= 6.0
  debian:     >= 7.0
  fedora:     >= 0.0.0
  opensuseleap: >= 0.0.0
  oracle:     >= 6.0
  redhat:     >= 6.0
  scientific: >= 6.0
  suse:       >= 12.0
  ubuntu:     >= 12.04
tarball_file_size: 23763
version:         8.5.1

убрать_из_раздела

Используйте аргумент unshare для прекращения обмена кулинарной книгой, расположенной в супермаркете Chef. Только владелец кулинарной книги может выполнить это действие.

Примечание

Удаление кулинарной книги из раздела нарушит кулинарную книгу, которая установила зависимость от этой кулинарной книги или версии кулинарной книги.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket unshare COOKBOOK_NAME/versions/VERSION (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site: URL, на котором расположен супермаркет Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду ножа:

Отмена совместного доступа к кулинарной книге

Для отмены совместного доступа к кулинарной книге под названием my_apache2_cookbook, введите:

knife supermarket unshare "my_apache2_cookbook" "Web Servers"

Отмена совместного доступа к версии кулинарной книги

Для отмены совместного доступа к версии кулинарной книги 0.10.0 для кулинарной книги my_apache2_cookbook, введите:

knife supermarket unshare "my_apache2_cookbook/versions/0.10.0"

© Chef Software, Inc.
Licensed under the Creative Commons Attribution 3.0 Unported License.
The Chef™ Mark and Chef Logo are either registered trademarks/service marks or trademarks/servicemarks of Chef, in the United States and other countries and are used with Chef Inc's permission.
We are not affiliated with, endorsed or sponsored by Chef Inc.
https://docs.chef.io/knife_supermarket/

ножевой супермаркет

скачать

Синтаксис

Параметры

Примеры

установить

Синтаксис

Параметры

Примеры

список

Синтаксис

Параметры

Примеры

поиск

Синтаксис

Параметры

Примеры

разделить

Синтаксис

Параметры

Примеры

показать

Синтаксис

Параметры

Примеры

убрать_из_раздела

Синтаксис

Параметры

Примеры