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

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

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

скачать

Используйте аргумент download для загрузки кулинарной книги из Chef Supermarket. Кулинарная книга будет загружена в виде архива 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. Использование этого аргумента выполняет следующие действия:

1. Создается новая ветвь «pristine copy» в git для отслеживания исходного кода.
2. Все существующие версии кулинарной книги удаляются из ветви.
3. Кулинарная книга загружается из супермаркета Chef в формате tar.gz.
4. Загруженная кулинарная книга распаковывается, её содержимое коммитится в git, и создается тэг.
5. Ветвь «pristine copy» сливается с ветвью master.

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

Синтаксис

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

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 Supermarket, введите:

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 Supermarket. По умолчанию 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"