doc: add docs about install 1password cli

docs/developer-setup.md

@@ -4,7 +4,27 @@ This page describes the common process for managing dependencies using `asdf` th
 ## Setup
-### Step 1: Setup Development Libraries
+### Step 1: Install 1password-cli v2
+
+In order to protect sensitive values, many GitLab projects rely on 1password for storing secrets. This may be either directly, or through internal tooling such as [`pmv`](https://gitlab.com/gitlab-com/gl-infra/pmv).
+
+Install 1password CLI using the instructions at: <https://developer.1password.com/docs/cli/get-started#install>. Unfortunately version management or package management tools cannot be used due to the security requirements of the 1password client.
+
+For macos, you can use:
+
+```shell
+brew install --cask 1password/tap/1password-cli
+```
+
+Once 1password-cli is installed you can verify the installation using:
+
+```shell
+op --version
+```
+
+Note that v2 of the 1password-cli is required.
+
+### Step 2: Setup Development Libraries
 The Infrastructure group uses some Python-based tools, including the [`gcloud` CLI](https://cloud.google.com/sdk/gcloud) and the [AWS CLI](https://aws.amazon.com/cli/), [`pre-commit`](https://pre-commit.com/) and [Ansible](https://www.ansible.com/).
@@ -21,7 +41,7 @@ xcode-select --install
 brew install openssl readline sqlite3 xz zlib
 ```
-### Step 1.5: Apple Silicon users only: install Rosetta
+### Step 2.5: Apple Silicon users only: install Rosetta
 > To determine if you are using an Apple with Silicon or an Intel-based processor, select the **Apple** menu icon in the top-left of the desktop and click **About This Mac**. On Mac computers with Apple silicon, About This Mac shows an item labeled **Chip**, followed by the name of the chip (ex. **Chip** Apple M1 Pro). On Mac computers with an Intel processor, About This Mac shows an item labeled **Processor**, followed by the name of an Intel processor.
@@ -41,7 +61,7 @@ If it is not running, it is likely that it is not installed, so continue with th
 softwareupdate --install-rosetta --agree-to-license
 ```
-### Step 2: Install `asdf`
+### Step 3: Install `asdf`
 Installation instructions for `asdf` can be found at <https://asdf-vm.com/guide/getting-started.html#_1-install-dependencies>.
@@ -53,7 +73,7 @@ brew install asdf
 Linux users should follow the instructions for their package manager in [the ASDF documentation](https://asdf-vm.com/guide/getting-started).
-#### Step 2.5: Hook `asdf` into your shell
+#### Step 3.5: Hook `asdf` into your shell
 Once you've installed `asdf`, add the following line to your shell. Remember to restart your terminal for the change to take affect.