sh 실행 시 문법 오류 해결법

배경

무중단 배포 스크립트를 아래와 같이 작성했다.

#!/bin/bash

IS_BLUE=$(docker compose ps | grep atcha-blue)
DEFAULT_CONF=" data/nginx/nginx.conf"
MAX_RETRIES=30

check_service() {
  local RETRIES=0
  local SERVICE_NAME=$1

  local container_ids=($(docker compose ps -q $SERVICE_NAME))
  ...

그리고 위 스크립트를 sh ./deploy.sh 로 실행하면 다음과 같은 에러가 나왔다.

Syntax error: "(" unexpected (expecting "}")

문법적 오류라고 나오는데 분명히 다른 환경에서는 문제없이 작동했었는데 내 우분투 환경에서는 위와 같은 에러가 발생했다.

 

---

 

해결

결론부터 말하자면 아래와 같이 bash로 실행하니까 해결되었다.

sudo bash ./deploy.sh

 

 

---

 

원인

/bin/sh 는 기본적으로 dash와 연결되어 있는데 dash는 Bash의 확장 기능을 지원하지 않는다. 따라서 스크립트를 Bash가 아닌 dash로 실행하면 배열 선언 같은 구문에서 오류가 발생한다고 한다.

 

그런데 나는 !/bin/bash를 했는데?

#!/bin/bash

...

내 스크립트를 다시 살펴보면 맨 첫 줄에 #!/bin/bash 를 작성해서 bash로 실행하도록 했었다.

하지만 bash로 실행되지 않고 sh로 실행되고 있었던 것이다.

그리고 혹시나 하는 마음에 bash의 실행위치를 확인해 봤다.

 

which bash  // bash 명령어 위치 확인

 

그 결과 /bin/bash 가 아니라 /usr/bin/bash 였다. bash의 명령어 위치가 달랐던 것이다.

대부분의 Ubuntu 시스템에서는 /bin/bash 가 Bash의 위치이지만, 다른 배포판이나 환경에서는 다를 수 있다고 한다.

 

 

---

 

더 나은 해결 방법은 없을까?

앞서 말했듯이 이를 간단하게 해결하기 위해서는 그냥 다음과 같이 bash로 스크립트를 실행하면 된다.

sudo bash {스크립트 파일}

하지만 이는 항상 스크립트를 bash로 실행해야 한다는 인지비용이 발생한다.

나는 이러한 인지 비용 없이 문제를 해결할 수 있는 방식에 대해 고민했다.

 

환경에 상관없이 Bash로 실행하는 방법

그러다가 시스템 환경에 상관없이 항상 bash로 실행하는 방식에 대해 알게 되었다.

바로 PATH 환경 변수에서 bash를 찾아서 실행하는 방식이다.

#!/usr/bin/env bash

스크립트 맨 위에 위와 같이 작성해 두면 환경에 상관없이 항상 bash로 실행할 수 있다.

따라서 인지비용도 들지 않는 최적의 해결책이라고 생각한다.

하지만 이래도 만약 `sh ./deploy.sh` 와 같이 실행하면 bash로 실행되지 않고 sh로 실행된다는 점에 주의하자.