Руководство по garage - Большая энциклопедия инструкций и руководств

Let’s start your Garage journey!
In this chapter, we explain how to deploy Garage as a single-node server
and how to interact with it.

What is Garage?

Before jumping in, you might be interested in reading the following pages:

Goals and use cases
List of features

Scope of this tutorial

Our goal is to introduce you to Garage’s workflows.
Following this guide is recommended before moving on to
configuring a multi-node cluster.

Note that this kind of deployment should not be used in production,
as it provides no redundancy for your data!

Get a binary

Download the latest Garage binary from the release pages on our repository:

https://garagehq.deuxfleurs.fr/download/

Place this binary somewhere in your $PATH so that you can invoke the garage
command directly (for instance you can copy the binary in /usr/local/bin
or in ~/.local/bin).

If a binary of the last version is not available for your architecture,
or if you want a build customized for your system,
you can build Garage from source.

Configuring and starting Garage

Generating a first configuration file

This first configuration file should allow you to get started easily with the simplest
possible Garage deployment.

We will create it with the following command line
to generate unique and private secrets for security reasons:

cat > garage.toml <<EOF
metadata_dir = "/tmp/meta"
data_dir = "/tmp/data"
db_engine = "lmdb"

replication_mode = "none"

rpc_bind_addr = "[::]:3901"
rpc_public_addr = "127.0.0.1:3901"
rpc_secret = "$(openssl rand -hex 32)"

[s3_api]
s3_region = "garage"
api_bind_addr = "[::]:3900"
root_domain = ".s3.garage.localhost"

[s3_web]
bind_addr = "[::]:3902"
root_domain = ".web.garage.localhost"
index = "index.html"

[k2v_api]
api_bind_addr = "[::]:3904"

[admin]
api_bind_addr = "0.0.0.0:3903"
admin_token = "$(openssl rand -base64 32)"
EOF

Now that your configuration file has been created, you can put
it in the right place. By default, garage looks at /etc/garage.toml.

You can also store it somewhere else, but you will have to specify -c path/to/garage.toml
at each invocation of the garage binary (for example: garage -c ./garage.toml server, garage -c ./garage.toml status).

As you can see, the rpc_secret is a 32 bytes hexadecimal string.
You can regenerate it with openssl rand -hex 32.
If you target a cluster deployment with multiple nodes, make sure that
you use the same value for all nodes.

As you can see in the metadata_dir and data_dir parameters, we are saving Garage’s data
in /tmp which gets erased when your system reboots. This means that data stored on this
Garage server will not be persistent. Change these to locations on your local disk if you want
your data to be persisted properly.

Launching the Garage server

Use the following command to launch the Garage server with our configuration file:

garage server

You can tune Garage’s verbosity as follows (from less verbose to more verbose):

RUST_LOG=garage=info garage server
RUST_LOG=garage=debug garage server
RUST_LOG=garage=trace garage server

Log level info is the default value and is recommended for most use cases.
Log level debug can help you check why your S3 API calls are not working.

Checking that Garage runs correctly

The garage utility is also used as a CLI tool to configure your Garage deployment.
It uses values from the TOML configuration file to find the Garage daemon running on the
local node, therefore if your configuration file is not at /etc/garage.toml you will
again have to specify -c path/to/garage.toml.

If the garage CLI is able to correctly detect the parameters of your local Garage node,
the following command should be enough to show the status of your cluster:

garage status

This should show something like this:

==== HEALTHY NODES ====
ID                 Hostname  Address         Tag                   Zone  Capacity
563e1ac825ee3323…  linuxbox  127.0.0.1:3901  NO ROLE ASSIGNED

Creating a cluster layout

Creating a cluster layout for a Garage deployment means informing Garage
of the disk space available on each node of the cluster
as well as the zone (e.g. datacenter) each machine is located in.

For our test deployment, we are using only one node. The way in which we configure
it does not matter, you can simply write:

garage layout assign -z dc1 -c 1 <node_id>

where <node_id> corresponds to the identifier of the node shown by garage status (first column).
You can enter simply a prefix of that identifier.
For instance here you could write just garage layout assign -z dc1 -c 1 563e.

The layout then has to be applied to the cluster, using:

garage layout apply

Creating buckets and keys

In this section, we will suppose that we want to create a bucket named nextcloud-bucket
that will be accessed through a key named nextcloud-app-key.

Don’t forget that help command and --help subcommands can help you anywhere,
the CLI tool is self-documented! Two examples:

garage help
garage bucket allow --help

Create a bucket

Let’s take an example where we want to deploy NextCloud using Garage as the
main data storage.

First, create a bucket with the following command:

garage bucket create nextcloud-bucket

Check that everything went well:

garage bucket list
garage bucket info nextcloud-bucket

Create an API key

The nextcloud-bucket bucket now exists on the Garage server,
however it cannot be accessed until we add an API key with the proper access rights.

Note that API keys are independent of buckets:
one key can access multiple buckets, multiple keys can access one bucket.

Create an API key using the following command:

garage key new --name nextcloud-app-key

The output should look as follows:

Key name: nextcloud-app-key
Key ID: GK3515373e4c851ebaad366558
Secret key: 7d37d093435a41f2aab8f13c19ba067d9776c90215f56614adad6ece597dbb34
Authorized buckets:

Check that everything works as intended:

garage key list
garage key info nextcloud-app-key

Allow a key to access a bucket

Now that we have a bucket and a key, we need to give permissions to the key on the bucket:

garage bucket allow \
  --read \
  --write \
  --owner \
  nextcloud-bucket \
  --key nextcloud-app-key

You can check at any time the allowed keys on your bucket with:

garage bucket info nextcloud-bucket

Uploading and downlading from Garage

To download and upload files on garage, we can use a third-party tool named awscli.

Install and configure `awscli`

If you have python on your system, you can install it with:

python -m pip install --user awscli

Now that awscli is installed, you must configure it to talk to your Garage instance,
with your key. There are multiple ways to do that, the simplest one is to create a file
named ~/.awsrc with this content:

export AWS_ACCESS_KEY_ID=xxxx      # put your Key ID here
export AWS_SECRET_ACCESS_KEY=xxxx  # put your Secret key here
export AWS_DEFAULT_REGION='garage'
export AWS_ENDPOINT='http://localhost:3900'

function aws { command aws --endpoint-url $AWS_ENDPOINT $@ ; }
aws --version

Now, each time you want to use awscli on this target, run:

source ~/.awsrc

You can create multiple files with different names if you
have multiple Garage clusters or different keys.
Switching from one cluster to another is as simple as
sourcing the right file.

Example usage of `awscli`

# list buckets
aws s3 ls

# list objects of a bucket
aws s3 ls s3://nextcloud-bucket

# copy from your filesystem to garage
aws s3 cp /proc/cpuinfo s3://nextcloud-bucket/cpuinfo.txt

# copy from garage to your filesystem
aws s3 cp s3://nextcloud-bucket/cpuinfo.txt /tmp/cpuinfo.txt

Note that you can use awscli for more advanced operations like
creating a bucket, pre-signing a request or managing your website.
Read the full documentation to know more.

Some features are however not implemented like ACL or policy.
Check our s3 compatibility list.

Other tools for interacting with Garage

The following tools can also be used to send and recieve files from/to Garage:

minio-client
s3cmd
rclone
Cyberduck
WinSCP

An exhaustive list is maintained in the «Integrations» > «Browsing tools» section.

Источник

GarageBand можно найти во многих продуктах Apple. Это бесплатная, простая и функциональная программа для создания музыки с множеством готовых пресетов. Ее легко освоить, чтобы попробовать себя в музыке и научиться сочинять полноценные треки. Многие музыканты пишут к ней музыку для себя и друзей, есть примеры и коммерческих записей (Grimes, Rihanna, Usher). Эта статья научит создавать в GarageBand собственные треки за 10 простых шагов.

Прежде чем начать

Прежде, чем приступить к работе, повар точит нож, гитарист настраивает гитару, а хоум продюсер обновляет софт. Чтобы получить наилучший результат, стоит обновить:

Саму программу — открыть AppStore, кликнуть по вкладке апдейтов и выбрать GarageBand.
Звуковые библиотеки. Это поможет сделать программу стабильнее, добавит новые звуки и откроет больше возможностей для музыканта. Обновить библиотеки можно по одной за раз, кликая по стрелке «вниз» напротив инструмента. Либо можно обновить все сразу с помощью меню (GarageBand — «Звуковые библиотеки» — «Скачать все доступные звуки»).

Шаг 1. Создание проекта

При первом запуске появляется окно с выбором действий. Кроме работы с проектами, программа предлагает школу уроков игры на гитаре и фортепиано, а в магазине можно скачать курсы для других инструментов.

Для начала работы понадобится создать новый пустой проект. Нажав параметр «Подробнее», можно выбрать:

Темп песни. Это основа всего. Исторически сложилось так, что множество хитов записано в 120 ударов в минуту. Это один из самых популярных темпов, поэтому он установлен по умолчанию. Но всегда можно настучать свой, кликая по кнопке «Tap Tempo».
Тональность. В филармонии перед началом концерта на сцену выходит женщина и объявляет: «Шостакович, симфония 11, соль минор». Последняя фраза и обозначает тональность произведения: тоника (т.е. основной тон, в котором построена песня) и лад (мажор или минор).
Размер. 2\4 будет похож на марш, 3\4 — на вальс, 4\4 — самый привычный уху, он установлен по умолчанию.
Устройства ввода и вывода звука. Как правило, внешняя или встроенная звуковая карта.

Если количество вводных настроек смущает, можно просто создать новый проект и понять все на практике. Вместе с освоением программы и основ теории музыки станет понятно, что работа над треком начинается с выбора его темпа, тональности и размера.

Шаг 2. Интерфейс

При запуске нового проекта программа предлагает создать один из четырех треков:

Виртуальный инструмент — плагин, эмулирующий звучание пианино, скрипки, флейты, гитары и всего, что есть в библиотеке звуков.
Аудио с микрофона или линейного входа — чтобы записать голос или живой акустический инструмент.
Аудио с гитары или баса — чтобы записать электронные инструменты и обработать эмулятором усилителя (ампсимом).
Виртуальный барабанщик — простая в настройке драм-машина с пресетами из разных жанров музыки

Интерфейс программы интуитивно понятен: пробелом запускается и останавливается воспроизведение, за запись отвечает большая красная кнопка. Рядом с названием дорожки и иконкой инструмента при записи появляется визуальное отображение партии.

Шаг 3. Виртуальные инструменты

GarageBand предлагает огромное количество инструментов, которые можно использовать в своих проектах: синтезаторы, электро- и бас-гитары, оркестровые инструменты, барабаны и даже вокал.

Более того, программа умеет превращать обычную кнопочную клавиатуру в midi-клавиатуру, так что для управления всем многообразием инструментов не нужно даже специальных устройств. Виртуальная клавиатура вызывается нажатием «Command key + K». В случае с мобильными девайсами это будут черно-белые клавиши пианино или гриф гитары.

Разумеется, все ноты будут одинаковой громкости (выставляется параметром «Чувствительность»), с динамикой придется работать после записи. Поэтому, если процесс затянет, можно посмотреть в сторону двух-трехоктавных midi-клавиатур — они занимают мало места на столе и серьезно ускоряют процесс создания музыки, особенно если за спиной есть музыкальная школа.

Шаг 4. Трек микрофона

Это не только трек вокала, поскольку с помощью микрофона можно записать акустическую гитару, скрипку, контрабас, барабаны и любой другой акустический инструмент.

Чтобы слышать себя во время записи, на выбранной дорожке нужно зажать кнопку мониторинга сигнала. Чтобы вместе с вокалом или скрипкой не записался клик метронома, понадобятся наушники. Даже рядовые «затычки» помогут в этом деле, а если их будет не хватать, тогда стоит обратить внимание на закрытые охватывающие наушники для записи. Получить хороший результат поможет студийный микрофон или рекордер и подготовленное помещение.

Шаг 5. Гитарный трек

Этот шаг может и не пригодится тем, кто не играет на гитаре. А вот гитаристам и басистам будет интересно узнать, что в GarageBand встроен неплохой гитарный процессор с множеством готовых пресетов — от чистых и перегруженных до экспериментальных. В сети можно найти сравнения с реальными усилителями, чтобы оценить качество звучания, а здесь статья о том, что нужно для профессиональной записи гитары.

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

Также в GarageBand есть неплохие эмуляции культовых гитарных и басовых педалей, которые можно добавлять в свой педалборд одним кликом.

Наконец, в программе есть встроенный тюнер — важно настраивать гитару перед каждой сессией записи и периодически подстраиваться во время нее.

Шаг 6. Драм-машина

Разработчики GarageBand придумали самую простую в управлении, но при этом отлично звучащую драм-машину. Пользователю доступен список музыкальных жанров, в каждом из которых играет несколько виртуальных барабанщиков. Каждый обладает собственным стилем, подачей и манерой игры. Между ними легко переключаться, чтобы выявить, какой лучше всего подходит к треку.

В окне редактирования можно выбрать грувы из пресетов, отрегулировать динамику и экспрессию (как сильно виртуальный барабанщик будет бить по виртуальным барабанам). Также можно настроить громкость каждого элемента барабанной установки, увеличить количество сбивок (fills — перебивок по томам между квадратами) или добавить свинг. Таким образом можно за пару секунд подобрать подходящий грув под только что сочиненную музыкальную фразу.

Шаг 7. Редактирование midi

Партии виртуальных инструментов записываются в формате midi. Причем записывается не сам звук, а информация о нем — высота ноты, длительность, громкость и т. п. После чего полученную партию можно скормить любому виртуальному инструменту, что очень удобно при выборе звуков для песни.

Работать с midi-партией можно в редакторе, который обычно называют piano roll. Его можно вызвать двойным кликом на область партии, которую нужно отредактировать, либо нажать горячую клавишу E.

В редакторе партий можно вручную поправить длительность любых нот, удалить лишние, добавить недостающие или даже полностью нарисовать нужную партию. Также есть функция квантизации (quantize), которая позволяет поправить длительность нот автоматически. Ее можно найти во вкладке «Область» (Region), для корректной работы нужно указать желаемую длительность нот (параметр Time Quantize). Эта функция дает возможность за секунды приводить свои кривые наброски к достойному результату.

Шаг 8. Редактирование аудио

Аудиотреки отображаются в виде звуковой волны, из которой интуитивно понятно, где звук громкий, где тихий, а где ничего нет. Первое правило — даже самые громкие звуки не должны превращаться в пики, вылезающие за пределы аудиодорожки. Это называется клиппинг, он вызывает искажения (треск, скрежет). Чтобы от него избавиться, нужно прибрать уровень входного сигнала на аудиокарте. Именно поэтому для домашних продюсеров лучше всего подходят внешние настольные аудиокарты с удобной регулировкой входного гейна.

Чистый сигнал не должен выходить за границы поля

Второе правило — тишину до и после партии лучше удалять, поскольку даже в самом тихом сигнале содержится шум цепи усиления.

Если дорожка одна, то ничего страшного, а вот при нескольких десятках нужно избавляться от малейших шумов, чтобы сохранить ясность звучания. Благо, подрезать аудиотрек очень просто: достаточно кликнуть мышкой по краю и сократить дорожку с нужной стороны.

Шаг 9. Работа с лупами

Лупы — это зацикленные на несколько тактов фрагменты партий различных инструментов: от барабанов и баса до гитар и даже вокала. Множество музыкантов пользуются готовыми лупами, чтобы ускорить сочинение музыки. Кнопкой O вызывается библиотека лупов с удобным браузером для быстрого поиска по инструменту, жанру или описанию.

Если обновления библиотек не выполнялось, тогда многие из них придется загружать поштучно. Рядом с каждым лупом указана длительность в долях, прослушать их можно кликом мыши, а понравившийся фрагмент легко перетащить курсором на нужную аудиодорожку. Оперировать лупами удобнее всего с помощью midi-клавиатур и контроллеров, оснащенных пэдами: фрагменты можно привязать к пэдам и играть ими как нотами.

Шаг 10. Сведение и мастеринг

GarageBand предлагает огромное количество пресетов для быстрого сведения своих треков. Достаточно кликнуть на трек, чтобы вызвать список пресетов. Горячая клавиша B открывает тонкие настройки. Там можно вручную отрегулировать значения компрессора, эквалайзера, модуляции, дилея и других плагинов обработки. Также есть возможность подключать внешние плагины.

Прежде, чем экспортировать финальный трек, нужно поставить на мастер-шину («Дорожка» — «Показать мастер-дорожку») лимитер, который ограничивает пики аудиосигнала и предотвращает клиппинг.

Он выравнивает звуковую волну и компрессирует сигнал, в итоге тот становится тише. Поэтому нужно вручную приподнять его громкость в поле Gain, а также убавить сигнал на выходе (Output Level) на полдецибела, чтобы у лимитера был некоторый запас. Большую помощь в сведении и мастеринге окажут студийные мониторы или наушники. С ними намного проще услышать изменения в динамике сигнала и любые искажения.

Лимитер — необходимый минимум для мастеринга, но продвинутые пользователи могут воспользоваться компрессором, эквалайзером, анализатором сигнала и другими плагинами.

В меню «Поделиться» (Share) нужно выбрать «Экспорт песни на диск» (Export Song To Disk), чтобы отрендерить финальный результат. В появившемся окне выставляется имя композиции, формат и качество аудио. Для черновиков сгодится и mp3, но для стриминг-сервисов или записи на CD и распространения будущего хита по друзьям понадобится аудио в формате *.wav.

Заключение

Любой длинный путь начинается с маленького шага. Чтобы понять основы, не обязательно сразу пытаться делать хиты — достаточно набросать хоть что-нибудь, но довести дело до рендеринга, после чего попробовать сделать что-то более сложное. GarageBand предоставляет еще множество возможностей — автотюнинг вокала, выравнивание аудиопартий, нотный редактор, автоматизация и многое другое, что встречается в DAW профессионального уровня. Любопытно, что он даже позволяет обновить себя до Logic Pro.

Пространства для роста достаточно, чтобы освоить создание композиций от записи до мастеринга и получить результат, который и не снился домашним продюсерам еще каких-то 15 лет назад. В конце концов, можно попробовать себя в создании каверов на хиты в Айфоне, некоторые из них собирают десятки миллионов просмотров.

Источник