unzip による ZIP ファイルの確認と展開
unzip -l で ZIP の内容を確認し、unzip -t で圧縮データを検証します。既存ファイルを置き換えずに展開するには、unzip -n を使います。ダウンロードしたパッケージのディレクトリを処理する場合は、後続のアーカイブが成功しても、先の失敗を報告するバッチスクリプトも必要です。このチュートリアルでは、小さな練習用アーカイブと、パッケージごとに出力先ディレクトリを分けるスクリプトを用意します。
ツールの確認
Bash、Info-ZIP UnZip、および一般的なユーティリティである
cp、mkdir、mktemp、rm がある Linux を使います。練習用アーカイブの作成には Info-ZIP Zip も必要です。以下の例は Bash 5.3.15、UnZip 6.00、Zip 3.0 でテストしています。使用するディストリビューションで保守されているパッケージを使ってください。次のコマンドで実装を確認します。
bash --version && unzip -v && zip -v
以下で参照するマニュアルは Info-ZIP 用です。同じ unzip という名前でも、別のプログラムでは動作が異なる場合があります。unzip -v には、デフォルトのオプションを追加できる環境変数
UNZIP と UNZIPOPT も表示されます。以下の個別のコマンドは、これらの変数が未設定であることを前提としています。バッチスクリプトでは、自身のプロセス内でこれらを解除します。
配布元を確認済みのパッケージなど、信頼できる暗号化されていない ZIP ファイルを使ってください。-t はアーカイブに保存された CRC 値を検証しますが、配布元の認証や内容の安全性の確認は行いません。展開先ディレクトリは、ユーザーのアップロード用サンドボックスではありません。信頼できないアーカイブには、このワークフローとは別に、隔離されたワーカーとリソース制限が必要です。
展開前の ZIP の確認
次のコードを Bash に貼り付けると、現在のディレクトリの下に
unzip-demo が作成されます。同じ名前がすでに存在する場合、内容を変更せずにセットアップが停止します。丸括弧により、シェルは元のディレクトリにとどまります。
(
mkdir -- unzip-demo &&
cd -- unzip-demo &&
mkdir -- downloads &&
printf '{"mode":"development"}\n' > config.json &&
printf 'build complete\n' > build.log &&
zip -q ./downloads/package.zip config.json build.log
)
同じ開始ディレクトリから、エントリを一覧表示し、データを検証します。
unzip -l ./unzip-demo/downloads/package.zip &&
unzip -t ./unzip-demo/downloads/package.zip
一覧には config.json と build.log が含まれ、テストではエラーが報告されないはずです。Info-ZIP マニュアルによると、-l は一覧を読み取り、-t はメモリ内でエントリを展開して CRC を比較します。一覧表示の成功だけでは、データを展開できる証明にはなりません。
両方のエントリを別のディレクトリに展開します。
unzip -n ./unzip-demo/downloads/package.zip -d ./unzip-demo/extracted
これで unzip-demo/extracted/config.json と unzip-demo/extracted/build.log があるはずです。-n は、確認を求めずに既存ファイルをスキップします。そのため、再実行時にコマンドがゼロを返しても、ローカルで編集した
config.json は編集済みの状態のままです。-o は既存ファイルを置き換える場合にのみ使ってください。置き換えを許可することで、上書きの確認を省略します。
必要なファイルだけの展開
引用符で囲んだメンバーパターンを渡して、JSON ファイルを選択します。
unzip -n ./unzip-demo/downloads/package.zip '*.json' -d ./unzip-demo/config-only
これにより、config-only/config.json が作成されますが、build.log は展開されず、再実行時も既存ファイルが保持されます。引用符は、Bash が作業ディレクトリに対して *.json を展開するのを防ぎます。パターンは UnZip がアーカイブのメンバーに適用します。除外する場合は、-x '*.log' で一致するログのエントリを省略します。ファイルを作成せずに設定だけを確認するには、unzip -p ./unzip-demo/downloads/package.zip config.json を使います。
失敗を見逃さないディレクトリ処理
バッチ処理では、出力に対してより厳格な方針を使います。アーカイブごとの出力先がすでに存在する場合は、ファイルを統合せず、失敗として扱います。以下を開始ディレクトリに extract-zips.sh として保存し、後述のように bash で実行してください。シェルに source で読み込まないでください。
このスクリプトは、最上位にある隠しファイルではない通常ファイルのうち、小文字の .zip で終わるものを処理します。シンボリックリンクとディレクトリはスキップします。実行中は入力ファイルを変更せず、同じ出力ルートを使う実行は同時に一つだけにしてください。展開したファイルと、最大の ZIP の一時コピーを保存する空き容量が必要です。
#!/usr/bin/env bash
if (( $# != 2 )) || [[ -z $1 || -z $2 ]]; then
printf 'Usage: bash extract-zips.sh INPUT_DIR OUTPUT_DIR\n' >&2
exit 2
fi
unset UNZIP UNZIPOPT
input_dir=$1
output_dir=$2
[[ $input_dir = /* ]] || input_dir="$PWD/$input_dir"
[[ $output_dir = /* ]] || output_dir="$PWD/$output_dir"
cd -P -- "$input_dir" || exit 1
input_dir=$PWD
mkdir -p -- "$output_dir" || exit 1
cd -P -- "$output_dir" || exit 1
output_dir=$PWD
scratch=$(mktemp -d -- "$output_dir/.unzip.XXXXXXXX") || exit 1
trap 'rm -rf -- "$scratch"' EXIT
shopt -s nullglob
status=0
count=0
for archive in "$input_dir"/*.zip; do
[[ -f "$archive" && ! -L "$archive" ]] || continue
count=$((count + 1))
name=${archive##*/}
destination="$output_dir/${name%.zip}"
if [[ -e "$destination" || -L "$destination" ]]; then
printf 'Destination already exists: %s\n' "$destination" >&2
status=1
continue
fi
printf 'Checking: %s\n' "$archive"
# UnZip expands archive-name wildcards even inside a quoted shell argument.
if ! cp -f -- "$archive" "$scratch/input.zip" ||
! unzip -tq -P '' "$scratch/input.zip" </dev/null; then
printf 'Cannot copy or validate: %s\n' "$archive" >&2
status=1
continue
fi
if ! mkdir -- "$destination"; then
status=1
continue
fi
if unzip -qo -P '' "$scratch/input.zip" -d "$destination" </dev/null; then
printf 'Extracted: %s\n' "$destination"
else
printf 'Extraction failed; inspect partial output: %s\n' "$destination" >&2
status=1
fi
done
if (( count == 0 )); then
printf 'No regular .zip files found in: %s\n' "$input_dir" >&2
status=1
fi
exit "$status"
保存したスクリプトを練習用アーカイブに対して実行します。
bash ./extract-zips.sh ./unzip-demo/downloads ./unzip-demo/batch-output
初回の実行が成功すると、Extracted: の行が表示され、batch-output/package/config.json と batch-output/package/build.log が作成されます。再度実行すると 1 が返され、そのディレクトリは変更されません。新たに展開し直す場合は、新しい出力ルートを選んでください。
一時コピーにより、UnZip にリテラルの input.zip という名前を渡せます。これは release[1].zip のような名前で重要です。シェルの引用符だけでは、UnZip 自身によるアーカイブ名のワイルドカード照合を無効にできません。出力先は引き続き元の名前で決まります。パスは cd -P で一度だけ解決し、$PWD から取得します。そのため、ディレクトリ名の末尾の改行を失うことなく、検出と展開で同じ物理ディレクトリを使います。
各 ZIP は、出力先が作成される前に -t に合格する必要があります。その後、-o は新しく作成したディレクトリ内にのみ適用され、-P '' は空のパスワードを渡して、対話的なパスワード入力を防ぎます。パスワードで保護されたパッケージには別のワークフローが必要です。スクリプトは失敗後も処理を続けますが、status をゼロに戻すことはありません。Bash のサブシェルとプロセスの規則により、保存したスクリプトのディレクトリ変更やオプションは、呼び出し元のシェルに影響しません。
結果に応じた対応
バッチスクリプトが 0 を返すのは、対象となるアーカイブが少なくとも一つあり、すべてのアーカイブが警告もエラーもなく完了した場合だけです。出力先がすでに存在する場合、対象の入力がない場合、コピー、検証、展開のいずれかに失敗した場合は
1 を返します。2 は引数が正しくないことを示します。後続の成功によって、先の失敗が隠されることはありません。
失敗の調査時には、UnZip の診断メッセージを保持してください。ゼロ以外の UnZip ステータスは、データの破損、未対応の圧縮方式や暗号化方式、ファイルシステムの問題を示す場合があります。これらをすべて「破損」と呼ぶと、調べる場所を誤ってしまいます。
データ検証に失敗した場合、アーカイブごとの出力先は作成されません。展開中の失敗では、不完全なファイルが残る場合があります。新しい出力ルートで再試行する前に、それらを確認してください。それ以前に完了した出力と元の ZIP はそのまま残ります。スクリプトが削除するのは、自身専用の一時コピーだけです。
ビルドジョブでは、スクリプトがゼロ以外のステータスを返したら、後続処理を停止させてください。手動で再実行する場合は、新しい出力ルートを選ぶか、先に既存ファイルを確認します。その判断は、無人実行中の上書き確認に委ねるのではなく、ワークフローで行うべきものです。
