Updated instructions

Author: aram356

README.md

@@ -1,56 +1,131 @@
-# potsi
+# Trusted Server 
 
-# Installation
+:information_source: At this time, Trusted Server is designed to work with Fastly. Follow these steps to configure Fastly Compute and deploy it.
 
-## Pre-requisites
+## Fastly
+- Create account at Fastly if you don’t have one - manage.fastly.com
+- Log in to the Fastly control panel. 
+    - Go to Account > API tokens > Personal tokens. 
+    - Click Create token
+    - Name the Token
+    - Choose User Token
+    - Choose Global API Access
+    - Choose what makes sense for your Org in terms of Service Access
+    - Copy key to a secure location because you will not be able to see it again
+
+- Create new Compute Service 
+    - Click Compute and Create Service 
+    - Click “Create Empty Service” (below main options) 
+    - Add your domain of the website you’ll be testing or using and click update
+    - Click on “Origins” section and add your ad-server / ssp partner information as hostnames (note after you save this information you can select port numbers and TLS on/off) 
+    - IMPORTANT: when you enter the FQDN or IP ADDR information and click Add you need to enter a “Name” in the first field that will be referenced in your code so something like “my_ad_partner_1” 
+    - 
+
+:warning: Fastly gives you a test domain to play on but obviously you’re free to create a CNAME to your domain when you’re ready. Note that Fastly compute ONLY accepts client traffic from TLS 
+
+## Installation
+
+### Brew
+
+:warning: Follow the prompts before and afterwards (to configure system path, etc)
+
+#### Install Brew
 
-### asdf
 ```sh
-brew install asdf
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 ```
+### Fastly CLI
 
-### Fastly
+#### Install Fastly CLI 
 ```sh
 brew install fastly/tap/fastly
 ```
 
-## rust
+#### Verify Installation and Version 
+```sh
+fastly version
+```
+
+#### Create profile and follow interactive prompt for pasting your API Token created earlier:
+```sh	
+fastly profile create
+```
+
+### Rust
+
+#### Install Rust with asdf
 ```sh
+brew install asdf
 asdf plugin add rust
 asdf install rust 1.83.0
 asdf reshim
 ```
 
-## viceroy (for running tests)
+#### Fix path for Bash
+
+Edit ~/.bash_profile to add path for asdf shims: 
 ```sh
-cargo install viceroy
+export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"
+```
+
+#### Fix path for ZSH
+
+Edit ~/.zshrc to add path for asdf shims: 
+```sh
+export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"
 ```
 
-## Build
+#### Other shells
+See https://asdf-vm.com/guide/getting-started.html#_2-configure-asdf
+
+
+### Configure Build and
+
+#### Clone Project
+```sh
+git clone [email protected]:IABTechLab/trusted-server.git
+```
+
+### Configure
+#### Edit configuration files
+:information_source: Note that you’ll have to edit the following files for your setup:
+
+- fastly.toml (service ID, author, description) 
+- Potsi.toml (KV store ID names) 
+
+### Build
 
 ```sh
 cargo build
 ```
 
-## Run
+### Deploy to Fastly
 
-### Fastly
-- Review configuration for [local_server](fastly.toml#L16)
+```sh
+fastly compute publish
+```
 
-- Run it with
+## Devleopment
 
+#### Install viceroy for running tests
 ```sh
-fastly -i compute serve
+cargo install viceroy
 ```
 
-## Test
+#### Run Fastly server locally
+Review configuration for [local_server](fastly.toml#L16)
+```sh
+fastly -i compute serve
 ```
+
+#### Tests
+```sh
 cargo test
 ```
 
-Note: if test fails `viceroy` will not display line number of the failed test. Rerun it with `cargo test_details`.
+:warning: if test fails `viceroy` will not display line number of the failed test. Rerun it with `cargo test_details`.
 
-## Additional Rust Commands
+#### Additional Rust Commands
 - `cargo fmt`: Ensure uniform code formatting
 - `cargo clippy`: Ensure idiomatic code
 - `cargo check`: Ensure compilation succeeds on Linux, MacOS, Windows and WebAssembly