-
Notifications
You must be signed in to change notification settings - Fork 16
/
install.sh
506 lines (426 loc) · 17.7 KB
/
install.sh
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
#!/usr/bin/env bash
set -e
# Copyright (c) 2021 vesoft inc. All rights reserved.
#
# This source code is licensed under Apache 2.0 License,
# Usage: install.sh
# Check Platform & Distribution
function logger_info {
echo
echo " ℹ️ " $1
}
function logger_warn {
echo
echo " ⚠️ " $1 1>&2
}
function logger_error {
echo
echo -e " ❌ " $1 1>&2
echo " Exiting, Stack Trace: ${executing_function-${FUNCNAME[*]}}"
cd $CURRENT_PATH
print_footer_error
exit 1
}
function logger_ok {
echo " ✔️ " $1
}
function excute_step {
executing_function=$1
$1 && logger_ok "$1 Finished" || logger_error "Failed in Step: $(echo ${executing_function//_/ })"
}
function print_banner {
echo '┌──────────────────────────────────────────────────────────────────────────────────────────┐'
echo '│ 🌌 Nebula-Graph Playground is on the way... │'
echo '├──────────────────────────────────────────────────────────────────────────────────────────┤'
echo '│.__ __. _______ .______ __ __ __ ___ __ __ .______ │'
echo '│| \ | | | ____|| _ \ | | | | | | / \ | | | | | _ \ │'
echo '│| \| | | |__ | |_) | | | | | | | / ^ \ ______| | | | | |_) | │'
echo '│| . ` | | __| | _ < | | | | | | / /_\ \ |______| | | | | ___/ │'
echo '│| |\ | | |____ | |_) | | `-- | | ----./ _____ \ | `-- | | | │'
echo '│|__| \__| |_______||______/ \______/ |_______/__/ \__\ \______/ | _| │'
echo '└──────────────────────────────────────────────────────────────────────────────────────────┘'
}
function get_platform {
case $(uname -ms) in
"Darwin x86_64") platform="x86_64-darwin" ;;
"Darwin arm64") platform="aarch64-darwin" ;;
"Linux x86_64") platform="x86_64-linux" ;;
"Linux aarch64") platform="aarch64-linux" ;;
*) platform="unknown-platform" ;;
esac
echo $platform
}
function is_linux {
if [[ $(uname -s) == Linux ]]; then
true
else
false
fi
}
function is_mac {
if [[ $(uname -s) == Darwin ]]; then
true
else
false
fi
}
function verify_sudo_permission {
logger_info "Verifying user's sudo Permission..."
sudo true
}
function get_distribution {
echo "$(source /etc/os-release && echo "$ID")"
}
# Detect Network Env
function nc_get_google_com {
echo 2> /dev/null -n "GET / HTTP/1.0\r\n" | nc -v google.com 80 2>&1 | grep -q "http] succeeded" && echo "OK" || echo "NOK"
}
function cat_get_google_com {
cat 2>/dev/null < /dev/null > /dev/tcp/google.com/80 && echo "OK" || echo "NOK"
}
function is_CN_NETWORK {
case $PLATFORM in
"x86_64-darwin"|"aarch64-darwin") internet_result=$(nc_get_google_com) ;;
"x86_64-linux"|"aarch64-linux") internet_result=$(cat_get_google_com) ;;
esac
if [ $internet_result == "OK" ]; then
false
else
true
fi
}
# Install Dependencies(docker, Package Manager) with Network Env Awareness
function utility_exists {
which $1 1>/dev/null 2>/dev/null && true || false
}
function install_package_ubuntu {
sudo apt-get update -y
sudo apt-get install -y $1
}
function install_package_centos {
sudo yum -y update
sudo yum -y install $1
}
function install_homebrew {
if is_CN_NETWORK; then
# https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/
BREW_TYPE="homebrew"
HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/${BREW_TYPE}-core.git"
HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/${BREW_TYPE}-bottles"
fi
logger_info "Installing Homebrew"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
}
function install_package_mac {
if ! utility_exists "brew"; then
install_homebrew
fi
brew install $1
}
function install_package {
case $PLATFORM in
*arwin*) install_package_mac $1;;
*inux*) install_package_$(get_distribution) $1;;
esac
}
function install_docker {
# For both Linux and Darwin cases, CN network was considerred
logger_info "Starting Instlation of Docker"
case $PLATFORM in
*inux*) sudo sh -c "$(wget https://get.docker.com -O -)" ;;
*arwin*) install_package "docker" ;;
esac
}
function install_docker_compose {
# Only Linux is needed, for macOS, Docker Desktop comes with compose out of box
COMPOSE_VERSION="v2.6.0"
logger_info "Starting Instlation of Docker-Compose"
sudo curl -L "https://github.com/docker/compose/releases/download/${COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /sbin/docker-compose
}
function waiting_for_docker_engine_up {
logger_info "Waiting for Docker Engine to be up..."
local max_attempts=${MAX_ATTEMPTS-6}
local timer=${INIT_TIMER-4}
local attempt=1
while [[ $attempt < $max_attempts ]]
do
status=$(sudo docker ps 1>/dev/null 2>/dev/null && echo OK||echo NOK)
if [[ "$status" == "OK" ]]; then
logger_ok "docker engine is up."
break
fi
logger_info "Docker Engine Check Attempt: ${attempt-0} Failed, Retrying in $timer Seconds..."
sleep $timer
attempt=$(( attempt + 1 ))
timer=$(( timer * 2 ))
done
if [[ "$status" != "OK" ]]; then
logger_error "Failed to start Docker Engine, we are sorry about this :("
fi
}
function start_docker {
case $PLATFORM in
*inux*) sudo systemctl start docker ;;
*arwin*) open -a Docker ;;
esac
waiting_for_docker_engine_up
}
function restart_docker {
case $PLATFORM in
*inux*) sudo systemctl daemon-reload && sudo systemctl restart docker ;;
*arwin*) osascript -e 'quit app "Docker"' && open -a Docker ;;
esac
waiting_for_docker_engine_up
}
function configure_docker_cn_mirror {
# FIXME: let's override it as it's assumed docker was installed by this script, while it's good to actually edit the json file
case $PLATFORM in
*inux*) DOCKER_CONF_PATH="/etc/docker" ;;
*arwin*) DOCKER_CONF_PATH="$HOME/.docker" ;;
esac
sudo mkdir -p ${DOCKER_CONF_PATH}
sudo bash -c "cat > ${DOCKER_CONF_PATH}/daemon.json" << EOF
{
"registry-mirrors": [
"https://hub-mirror.c.163.com"
]
}
EOF
}
function ensure_docker_permission {
logger_info "Ensuring Linux Docker Permission"
if is_linux; then
sudo groupadd docker --force || \
logger_error "failed during: groupadd docker"
sudo usermod -aG docker $USER || \
logger_error "failed during: sudo usermod -aG docker $USER"
newgrp docker <<EOF || \
logger_error "failed during: newgrp docker"
EOF
fi
docker ps 1>/dev/null 2>/dev/null || \
logger_error "Ensuring docker Permission Failed, please try: \n \
option 0: linux: execute this command and retry:\n $ newgrp docker\n \
option 1: linux: relogin current shell session and retry install.sh \n \
option 2: macOS: start Docker Desktop yourself and retry."
}
function ensure_dependencies {
if ! utility_exists "git"; then
install_package "git"
fi
if ! utility_exists "wget"; then
install_package "wget"
fi
if ! utility_exists "docker"; then
install_docker
if is_CN_NETWORK; then
configure_docker_cn_mirror
restart_docker
fi
else
start_docker
fi
ensure_docker_permission
if ! utility_exists "docker-compose"; then
install_docker_compose
fi
# TBD for other dependencies
}
# Check Ports States
function check_ports_availability {
logger_info "Checking Ports Availability"
# TBD
}
# Deploy NebulaGraph
function waiting_for_nebula_graph_up {
logger_info "Waiting for all nebula-graph containers to be healthy..."
expected_containers_count_str="9"
healthy_containers_count_str=""
local max_attempts=${MAX_ATTEMPTS-6}
local timer=${INIT_TIMER-4}
local attempt=1
while [[ $attempt < $max_attempts ]]
do
healthy_containers_count_str=$(docker ps --filter health=healthy |grep -v "CONTAINER ID"|wc -l|sed -e 's/^[[:space:]]*//')
if [[ "$healthy_containers_count_str" == "$expected_containers_count_str" ]]; then
logger_ok "all nebula-graph containers are healthy."
break
fi
logger_info "Nebula-Graph Containers Healthcheck Attempt: ${attempt-0} Failed, Retrying in $timer Seconds..."
sleep $timer
attempt=$(( attempt + 1 ))
timer=$(( timer * 2 ))
done
if [[ "$healthy_containers_count_str" != "$expected_containers_count_str" ]]; then
logger_warn "Failed to waiting for all containers to be healthy, check docker ps for details."
fi
}
function remove_port_mappings {
# replace "9669:9669" with 9669 from docker-compose.yaml
# sed -i '' 's/9669:9669/9669/g' docker-compose.yaml
# replace "sleep 3 " with "sleep 120 " from docker-compose.yaml
sed -i '' 's/sleep 3 /sleep 120 /g' docker-compose.yaml
}
function install_nebula_graph {
# TBD, considerring create gitee mirror for git repo? if is_CN_NETWORK is true.
# https://github.com/vesoft-inc/nebula-docker-compose
docker network create nebula-net || true
cd $WOKRING_PATH
if [ ! -d "$WOKRING_PATH/nebula-docker-compose" ]; then
git clone --branch $NEBULA_VERSION https://github.com/vesoft-inc/nebula-docker-compose.git
grep "external" nebula-docker-compose/docker-compose.yaml > /dev/null 2>&1 || \
echo " external: true" >> nebula-docker-compose/docker-compose.yaml
else
logger_warn "$WOKRING_PATH/nebula-docker-compose already exists, existing repo will be reused"
fi
cd nebula-docker-compose && git checkout $NEBULA_VERSION 1>/dev/null 2>/dev/null
# if $PLATFORM equals to aarch64-darwin , we need to remove the port mappings in docker-compose.yaml
if [[ "$PLATFORM" == "aarch64-darwin" ]]; then
remove_port_mappings
fi
docker-compose pull
docker-compose up -d
}
# Deploy NebulaGraph Studio
function install_nebula_graph_studio {
cd $WOKRING_PATH
if [ -d "$WOKRING_PATH/nebula-graph-studio-$STUDIO_VERSION" ]; then
rm -fr $WOKRING_PATH/nebula-graph-studio-$STUDIO_VERSION
fi
if [ $STUDIO_VERSION = "3.1.0" ]; then
VERSION_FOLDER=""
STUDIO_VERSION="v3.1.0"
else
VERSION_FOLDER="$STUDIO_VERSION/"
fi
wget https://oss-cdn.nebula-graph.com.cn/nebula-graph-studio/${VERSION_FOLDER}nebula-graph-studio-$STUDIO_VERSION.tar.gz 1>/dev/null 2>/dev/null
mkdir nebula-graph-studio-$STUDIO_VERSION && tar -zxvf nebula-graph-studio-$STUDIO_VERSION.tar.gz -C nebula-graph-studio-$STUDIO_VERSION 1>/dev/null 2>/dev/null
grep "external" nebula-graph-studio-$STUDIO_VERSION/docker-compose.yml > /dev/null 2>&1 || \
echo -e "\n external: true" >> nebula-graph-studio-$STUDIO_VERSION/docker-compose.yml
if is_mac; then
sed -i "" 's/nebula-web/nebula-net/g' nebula-graph-studio-$STUDIO_VERSION/docker-compose.yml > /dev/null 2>&1
else
sed -i 's/nebula-web/nebula-net/g' nebula-graph-studio-$STUDIO_VERSION/docker-compose.yml > /dev/null 2>&1
fi
cd nebula-graph-studio-$STUDIO_VERSION
export DOCKER_DEFAULT_PLATFORM=linux/amd64
# FIXME, before we have ARM Linux images released, let's hardcode it inti x86_64
docker-compose pull
docker-compose up -d
}
# Deploy Nebula Console
function install_nebula_graph_console {
logger_info "Pulling nebula-console docker image"
docker pull vesoft/nebula-console:${CONSOLE_VERSION} 1>/dev/null 2>/dev/null
sudo bash -c "cat > $WOKRING_PATH/console.sh" << EOF
#!/usr/bin/env bash
# Copyright (c) 2021 vesoft inc. All rights reserved.
#
# This source code is licensed under Apache 2.0 License,
# Usage: console.sh
export DOCKER_DEFAULT_PLATFORM=linux/amd64;
docker run --rm -ti --network nebula-net --volume $WOKRING_PATH:/root vesoft/nebula-console:${CONSOLE_VERSION} -addr graphd -port 9669 -u root -p nebula "\$@"
EOF
sudo chmod +x $WOKRING_PATH/console.sh
logger_info "Created console.sh 😁:"
}
# Create Uninstall Script
function create_uninstall_script {
sudo bash -c "WOKRING_PATH=$WOKRING_PATH;cat > $WOKRING_PATH/uninstall.sh" << EOF
#!/usr/bin/env bash
# Copyright (c) 2021 vesoft inc. All rights reserved.
#
# This source code is licensed under Apache 2.0 License,
# Usage: uninstall.sh
echo " ℹ️ Cleaning Up Files under $WOKRING_PATH..."
cd $WOKRING_PATH/nebula-graph-studio-$STUDIO_VERSION 2>/dev/null && sudo docker-compose down 2>/dev/null
cd $WOKRING_PATH/nebula-docker-compose 2>/dev/null && sudo docker-compose down 2>/dev/null
sudo rm -fr $WOKRING_PATH/nebula-graph-studio-$STUDIO_VERSION $WOKRING_PATH/nebula-docker-compose 2>/dev/null
echo "┌────────────────────────────────────────┐"
echo "│ 🌌 Nebula-Up Uninstallation Finished │"
echo "└────────────────────────────────────────┘"
EOF
sudo chmod +x $WOKRING_PATH/uninstall.sh
}
function print_footer {
echo "┌────────────────────────────────────────┐"
echo "│ 🌌 Nebula-Graph Playground is Up now! │"
echo "├────────────────────────────────────────┤"
echo "│ │"
echo "│ 🎉 Congrats! Your Nebula is Up now! │"
echo "│ $ cd ~/.nebula-up │"
echo "│ │"
echo "│ 🌏 You can access it from browser: │"
echo "│ http://127.0.0.1:7001 │"
echo "│ http://<other_interface>:7001 │"
echo "│ │"
echo "│ 🔥 Or access via Nebula Console: │"
echo "│ $ ~/.nebula-up/console.sh │"
echo "│ │"
echo "│ To remove the playground: │"
echo "│ $ ~/.nebula-up/uninstall.sh │"
echo "│ │"
echo "│ 🚀 Have Fun! │"
echo "│ │"
echo "└────────────────────────────────────────┘"
}
function print_footer_error {
echo "┌────────────────────────────────────────┐"
echo "│ 🌌 Nebula-Up run into issues 😢 │"
echo "├────────────────────────────────────────┤"
echo "│ │"
echo "│ 🎉 To cleanup: │"
echo "│ $ ~/.nebula-up/uninstall.sh │"
echo "│ │"
echo "└────────────────────────────────────────┘"
}
function main {
print_banner
case $NEBULA_VERSION in
v3.0.0 | 3.0.0 )
NEBULA_VERSION="v3.0.0"
STUDIO_VERSION="3.2.5"
CONSOLE_VERSION="v3.0.0"
;;
v2.6 | 2.6 | 2.6.3 | v2.6.3 | 2.6.* | v2.6.* )
NEBULA_VERSION="v2.6"
STUDIO_VERSION="3.1.0"
CONSOLE_VERSION="v2.6.0"
;;
* | v3.6 | 3.6 | 3.6.0 | v3 )
logger_info "VERSION not provided"
NEBULA_VERSION="release-3.6"
STUDIO_VERSION="3.7.0"
CONSOLE_VERSION="v3.5.0"
;;
esac
logger_info "Installing NebulaGraph $NEBULA_VERSION"
CURRENT_PATH="$pwd"
WOKRING_PATH="$HOME/.nebula-up"
mkdir -p $WOKRING_PATH && cd $WOKRING_PATH
PLATFORM=$(get_platform)
CN_NETWORK=false
if is_CN_NETWORK; then
CN_NETWORK=true
fi
excute_step verify_sudo_permission
logger_info "Preparing Nebula-Up Uninstall Script..."
excute_step create_uninstall_script
logger_info "Ensuring Depedencies..."
excute_step ensure_dependencies
logger_info "Boostraping NebulaGraph Cluster with Docker Compose..."
excute_step install_nebula_graph
logger_info "Boostraping NebulaGraph Studio with Docker Compose..."
excute_step install_nebula_graph_studio
logger_info "Preparing NebulaGraph Console Script..."
excute_step install_nebula_graph_console
excute_step waiting_for_nebula_graph_up
print_footer
}
NEBULA_VERSION=$1
main