2019-06-21 20:21:08 +08:00
#!/usr/bin/env bash
# Copyright (c) .NET Foundation and contributors. All rights reserved.
# Licensed under the MIT license. See LICENSE file in the project root for full license information.
#
# Stop script on NZEC
set -e
# Stop script if unbound variable found (use ${var:-} if intentional)
set -u
# By default cmd1 | cmd2 returns exit code of cmd2 regardless of cmd1 success
# This is causing it to fail
set -o pipefail
# Use in the the functions: eval $invocation
invocation = 'say_verbose "Calling: ${yellow:-}${FUNCNAME[0]} ${green:-}$*${normal:-}"'
# standard output may be used as a return value in the functions
# we need a way to write text on the screen in the functions so that
# it won't interfere with the return value.
# Exposing stream 3 as a pipe to standard output of the script itself
exec 3>& 1
# Setup some colors to use. These need to work in fairly limited shells, like the Ubuntu Docker container where there are only 8 colors.
# See if stdout is a terminal
if [ -t 1 ] && command -v tput > /dev/null; then
# see if it supports colors
2021-06-08 17:27:57 +08:00
ncolors = $( tput colors || echo 0)
2019-06-21 20:21:08 +08:00
if [ -n " $ncolors " ] && [ $ncolors -ge 8 ] ; then
bold = " $( tput bold || echo ) "
normal = " $( tput sgr0 || echo ) "
black = " $( tput setaf 0 || echo ) "
red = " $( tput setaf 1 || echo ) "
green = " $( tput setaf 2 || echo ) "
yellow = " $( tput setaf 3 || echo ) "
blue = " $( tput setaf 4 || echo ) "
magenta = " $( tput setaf 5 || echo ) "
cyan = " $( tput setaf 6 || echo ) "
white = " $( tput setaf 7 || echo ) "
fi
fi
say_warning( ) {
2021-02-02 16:40:17 +08:00
printf "%b\n" " ${ yellow :- } dotnet_install: Warning: $1 ${ normal :- } " >& 3
2019-06-21 20:21:08 +08:00
}
say_err( ) {
printf "%b\n" " ${ red :- } dotnet_install: Error: $1 ${ normal :- } " >& 2
}
say( ) {
# using stream 3 (defined in the beginning) to not interfere with stdout of functions
# which may be used as return value
printf "%b\n" " ${ cyan :- } dotnet-install: ${ normal :- } $1 " >& 3
}
say_verbose( ) {
if [ " $verbose " = true ] ; then
say " $1 "
fi
}
# This platform list is finite - if the SDK/Runtime has supported Linux distribution-specific assets,
# then and only then should the Linux distribution appear in this list.
# Adding a Linux distribution to this list does not imply distribution-specific support.
get_legacy_os_name_from_platform( ) {
eval $invocation
platform = " $1 "
case " $platform " in
"centos.7" )
echo "centos"
return 0
; ;
"debian.8" )
echo "debian"
return 0
; ;
"debian.9" )
echo "debian.9"
return 0
; ;
"fedora.23" )
echo "fedora.23"
return 0
; ;
"fedora.24" )
echo "fedora.24"
return 0
; ;
"fedora.27" )
echo "fedora.27"
return 0
; ;
"fedora.28" )
echo "fedora.28"
return 0
; ;
"opensuse.13.2" )
echo "opensuse.13.2"
return 0
; ;
"opensuse.42.1" )
echo "opensuse.42.1"
return 0
; ;
"opensuse.42.3" )
echo "opensuse.42.3"
return 0
; ;
"rhel.7" *)
echo "rhel"
return 0
; ;
"ubuntu.14.04" )
echo "ubuntu"
return 0
; ;
"ubuntu.16.04" )
echo "ubuntu.16.04"
return 0
; ;
"ubuntu.16.10" )
echo "ubuntu.16.10"
return 0
; ;
"ubuntu.18.04" )
echo "ubuntu.18.04"
return 0
; ;
"alpine.3.4.3" )
echo "alpine"
return 0
; ;
esac
return 1
}
get_linux_platform_name( ) {
eval $invocation
if [ -n " $runtime_id " ] ; then
echo " ${ runtime_id %-* } "
return 0
else
if [ -e /etc/os-release ] ; then
. /etc/os-release
2019-12-13 22:34:07 +08:00
echo " $ID ${ VERSION_ID : +. ${ VERSION_ID } } "
2019-06-21 20:21:08 +08:00
return 0
elif [ -e /etc/redhat-release ] ; then
local redhatRelease = $( </etc/redhat-release)
2019-10-11 07:41:56 +08:00
if [ [ $redhatRelease = = "CentOS release 6." * || $redhatRelease = = "Red Hat Enterprise Linux " *" release 6." * ] ] ; then
2019-06-21 20:21:08 +08:00
echo "rhel.6"
return 0
fi
fi
fi
say_verbose " Linux specific platform name and version could not be detected: UName = $uname "
return 1
}
2019-12-13 22:34:07 +08:00
is_musl_based_distro( ) {
( ldd --version 2>& 1 || true ) | grep -q musl
}
2019-06-21 20:21:08 +08:00
get_current_os_name( ) {
eval $invocation
local uname = $( uname)
if [ " $uname " = "Darwin" ] ; then
echo "osx"
return 0
elif [ " $uname " = "FreeBSD" ] ; then
echo "freebsd"
2020-05-16 05:21:50 +08:00
return 0
2019-06-21 20:21:08 +08:00
elif [ " $uname " = "Linux" ] ; then
local linux_platform_name
linux_platform_name = " $( get_linux_platform_name) " || { echo "linux" && return 0 ; }
2019-12-13 22:34:07 +08:00
if [ " $linux_platform_name " = "rhel.6" ] ; then
2019-06-21 20:21:08 +08:00
echo $linux_platform_name
return 0
2019-12-13 22:34:07 +08:00
elif is_musl_based_distro; then
2019-06-21 20:21:08 +08:00
echo "linux-musl"
return 0
2021-02-02 16:40:17 +08:00
elif [ " $linux_platform_name " = "linux-musl" ] ; then
echo "linux-musl"
return 0
2019-06-21 20:21:08 +08:00
else
echo "linux"
return 0
fi
fi
say_err " OS name could not be detected: UName = $uname "
return 1
}
get_legacy_os_name( ) {
eval $invocation
local uname = $( uname)
if [ " $uname " = "Darwin" ] ; then
echo "osx"
return 0
elif [ -n " $runtime_id " ] ; then
echo $( get_legacy_os_name_from_platform " ${ runtime_id %-* } " || echo " ${ runtime_id %-* } " )
return 0
else
if [ -e /etc/os-release ] ; then
. /etc/os-release
2019-12-13 22:34:07 +08:00
os = $( get_legacy_os_name_from_platform " $ID ${ VERSION_ID : +. ${ VERSION_ID } } " || echo "" )
2019-06-21 20:21:08 +08:00
if [ -n " $os " ] ; then
echo " $os "
return 0
fi
fi
fi
say_verbose " Distribution specific OS name and version could not be detected: UName = $uname "
return 1
}
machine_has( ) {
eval $invocation
hash " $1 " > /dev/null 2>& 1
return $?
}
check_min_reqs( ) {
local hasMinimum = false
if machine_has "curl" ; then
hasMinimum = true
elif machine_has "wget" ; then
hasMinimum = true
fi
if [ " $hasMinimum " = "false" ] ; then
say_err "curl (recommended) or wget are required to download dotnet. Install missing prerequisite to proceed."
return 1
fi
return 0
}
# args:
# input - $1
to_lowercase( ) {
#eval $invocation
echo " $1 " | tr '[:upper:]' '[:lower:]'
return 0
}
# args:
# input - $1
remove_trailing_slash( ) {
#eval $invocation
local input = " ${ 1 :- } "
echo " ${ input %/ } "
return 0
}
# args:
# input - $1
remove_beginning_slash( ) {
#eval $invocation
local input = " ${ 1 :- } "
echo " ${ input #/ } "
return 0
}
# args:
# root_path - $1
# child_path - $2 - this parameter can be empty
combine_paths( ) {
eval $invocation
# TODO: Consider making it work with any number of paths. For now:
if [ ! -z " ${ 3 :- } " ] ; then
say_err "combine_paths: Function takes two parameters."
return 1
fi
local root_path = " $( remove_trailing_slash " $1 " ) "
local child_path = " $( remove_beginning_slash " ${ 2 :- } " ) "
say_verbose " combine_paths: root_path= $root_path "
say_verbose " combine_paths: child_path= $child_path "
echo " $root_path / $child_path "
return 0
}
get_machine_architecture( ) {
eval $invocation
if command -v uname > /dev/null; then
CPUName = $( uname -m)
case $CPUName in
2021-02-02 16:40:17 +08:00
armv*l)
2019-06-21 20:21:08 +08:00
echo "arm"
return 0
; ;
2021-02-05 16:21:42 +08:00
aarch64| arm64)
2019-06-21 20:21:08 +08:00
echo "arm64"
return 0
; ;
esac
fi
# Always default to 'x64'
echo "x64"
return 0
}
# args:
# architecture - $1
get_normalized_architecture_from_architecture( ) {
eval $invocation
local architecture = " $( to_lowercase " $1 " ) "
case " $architecture " in
\< auto\> )
echo " $( get_normalized_architecture_from_architecture " $( get_machine_architecture) " ) "
return 0
; ;
amd64| x64)
echo "x64"
return 0
; ;
arm)
echo "arm"
return 0
; ;
arm64)
echo "arm64"
return 0
; ;
esac
2021-02-02 16:40:17 +08:00
say_err " Architecture \` $architecture \` not supported. If you think this is a bug, report it at https://github.com/dotnet/install-scripts/issues "
2019-06-21 20:21:08 +08:00
return 1
}
2021-02-02 16:40:17 +08:00
# args:
# user_defined_os - $1
get_normalized_os( ) {
eval $invocation
local osname = " $( to_lowercase " $1 " ) "
if [ ! -z " $osname " ] ; then
case " $osname " in
osx | freebsd | rhel.6 | linux-musl | linux)
echo " $osname "
return 0
; ;
*)
say_err " ' $user_defined_os ' is not a supported value for --os option, supported values are: osx, linux, linux-musl, freebsd, rhel.6. If you think this is a bug, report it at https://github.com/dotnet/install-scripts/issues. "
return 1
; ;
esac
else
osname = " $( get_current_os_name) " || return 1
fi
echo " $osname "
return 0
}
2021-06-08 17:27:57 +08:00
# args:
# quality - $1
get_normalized_quality( ) {
eval $invocation
local quality = " $( to_lowercase " $1 " ) "
if [ ! -z " $quality " ] ; then
case " $quality " in
daily | signed | validated | preview)
echo " $quality "
return 0
; ;
ga)
#ga quality is available without specifying quality, so normalizing it to empty
return 0
; ;
*)
say_err " ' $quality ' is not a supported value for --quality option. Supported values are: daily, signed, validated, preview, ga. If you think this is a bug, report it at https://github.com/dotnet/install-scripts/issues. "
return 1
; ;
esac
fi
return 0
}
# args:
# channel - $1
get_normalized_channel( ) {
eval $invocation
local channel = " $( to_lowercase " $1 " ) "
if [ [ $channel = = release/* ] ] ; then
say_warning 'Using branch name with -Channel option is no longer supported with newer releases. Use -Quality option with a channel in X.Y format instead.' ;
fi
if [ ! -z " $channel " ] ; then
case " $channel " in
lts)
echo "LTS"
return 0
; ;
*)
echo " $channel "
return 0
; ;
esac
fi
return 0
}
# args:
# runtime - $1
get_normalized_product( ) {
eval $invocation
local runtime = " $( to_lowercase " $1 " ) "
if [ [ " $runtime " = = "dotnet" ] ] ; then
product = "dotnet-runtime"
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
product = "aspnetcore-runtime"
elif [ -z " $runtime " ] ; then
product = "dotnet-sdk"
fi
echo " $product "
return 0
}
2019-06-21 20:21:08 +08:00
# The version text returned from the feeds is a 1-line or 2-line string:
# For the SDK and the dotnet runtime (2 lines):
# Line 1: # commit_hash
# Line 2: # 4-part version
# For the aspnetcore runtime (1 line):
# Line 1: # 4-part version
# args:
# version_text - stdin
get_version_from_version_info( ) {
eval $invocation
cat | tail -n 1 | sed 's/\r$//'
return 0
}
# args:
# install_root - $1
# relative_path_to_package - $2
# specific_version - $3
is_dotnet_package_installed( ) {
eval $invocation
local install_root = " $1 "
local relative_path_to_package = " $2 "
local specific_version = " ${ 3 //[ $'\t\r\n' ] } "
local dotnet_package_path = " $( combine_paths " $( combine_paths " $install_root " " $relative_path_to_package " ) " " $specific_version " ) "
say_verbose " is_dotnet_package_installed: dotnet_package_path= $dotnet_package_path "
if [ -d " $dotnet_package_path " ] ; then
return 0
else
return 1
fi
}
# args:
# azure_feed - $1
# channel - $2
# normalized_architecture - $3
get_latest_version_info( ) {
eval $invocation
local azure_feed = " $1 "
local channel = " $2 "
local normalized_architecture = " $3 "
local version_file_url = null
if [ [ " $runtime " = = "dotnet" ] ] ; then
version_file_url = " $uncached_feed /Runtime/ $channel /latest.version "
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
version_file_url = " $uncached_feed /aspnetcore/Runtime/ $channel /latest.version "
elif [ -z " $runtime " ] ; then
2021-02-02 16:40:17 +08:00
version_file_url = " $uncached_feed /Sdk/ $channel /latest.version "
2019-06-21 20:21:08 +08:00
else
say_err "Invalid value for \$runtime"
return 1
fi
say_verbose " get_latest_version_info: latest url: $version_file_url "
download " $version_file_url "
return $?
}
2019-11-09 00:02:16 +08:00
# args:
# json_file - $1
parse_jsonfile_for_version( ) {
eval $invocation
local json_file = " $1 "
if [ ! -f " $json_file " ] ; then
say_err " Unable to find \` $json_file \` "
return 1
fi
sdk_section = $( cat $json_file | awk '/"sdk"/,/}/' )
if [ -z " $sdk_section " ] ; then
say_err " Unable to parse the SDK node in \` $json_file \` "
return 1
fi
sdk_list = $( echo $sdk_section | awk -F"[{}]" '{print $2}' )
sdk_list = ${ sdk_list //[ \" ]/ }
sdk_list = ${ sdk_list //,/ $'\n' }
local version_info = ""
while read -r line; do
IFS = :
while read -r key value; do
if [ [ " $key " = = "version" ] ] ; then
version_info = $value
fi
done <<< " $line "
done <<< " $sdk_list "
if [ -z " $version_info " ] ; then
say_err " Unable to find the SDK:version node in \` $json_file \` "
return 1
fi
2019-12-13 22:34:07 +08:00
unset IFS;
2019-11-09 00:02:16 +08:00
echo " $version_info "
return 0
}
2019-06-21 20:21:08 +08:00
# args:
# azure_feed - $1
# channel - $2
# normalized_architecture - $3
# version - $4
2019-11-09 00:02:16 +08:00
# json_file - $5
2019-06-21 20:21:08 +08:00
get_specific_version_from_version( ) {
eval $invocation
local azure_feed = " $1 "
local channel = " $2 "
local normalized_architecture = " $3 "
local version = " $( to_lowercase " $4 " ) "
2019-11-09 00:02:16 +08:00
local json_file = " $5 "
if [ -z " $json_file " ] ; then
2021-02-11 15:32:14 +08:00
if [ [ " $version " = = "latest" ] ] ; then
2021-02-02 16:40:17 +08:00
local version_info
version_info = " $( get_latest_version_info " $azure_feed " " $channel " " $normalized_architecture " false ) " || return 1
say_verbose " get_specific_version_from_version: version_info= $version_info "
echo " $version_info " | get_version_from_version_info
return 0
else
echo " $version "
return 0
fi
2019-11-09 00:02:16 +08:00
else
local version_info
version_info = " $( parse_jsonfile_for_version " $json_file " ) " || return 1
echo " $version_info "
return 0
fi
2019-06-21 20:21:08 +08:00
}
# args:
# azure_feed - $1
# channel - $2
# normalized_architecture - $3
# specific_version - $4
2021-02-02 16:40:17 +08:00
# normalized_os - $5
2019-06-21 20:21:08 +08:00
construct_download_link( ) {
eval $invocation
local azure_feed = " $1 "
local channel = " $2 "
local normalized_architecture = " $3 "
local specific_version = " ${ 4 //[ $'\t\r\n' ] } "
2021-02-02 16:40:17 +08:00
local specific_product_version = " $( get_specific_product_version " $1 " " $4 " ) "
local osname = " $5 "
2021-02-11 15:32:14 +08:00
2021-02-02 16:40:17 +08:00
local download_link = null
if [ [ " $runtime " = = "dotnet" ] ] ; then
download_link = " $azure_feed /Runtime/ $specific_version /dotnet-runtime- $specific_product_version - $osname - $normalized_architecture .tar.gz "
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
download_link = " $azure_feed /aspnetcore/Runtime/ $specific_version /aspnetcore-runtime- $specific_product_version - $osname - $normalized_architecture .tar.gz "
elif [ -z " $runtime " ] ; then
download_link = " $azure_feed /Sdk/ $specific_version /dotnet-sdk- $specific_product_version - $osname - $normalized_architecture .tar.gz "
else
return 1
fi
2019-06-21 20:21:08 +08:00
2021-02-02 16:40:17 +08:00
echo " $download_link "
return 0
}
# args:
# azure_feed - $1
# specific_version - $2
2021-06-08 17:27:57 +08:00
# download link - $3 (optional)
2021-02-02 16:40:17 +08:00
get_specific_product_version( ) {
2021-02-11 15:32:14 +08:00
# If we find a 'productVersion.txt' at the root of any folder, we'll use its contents
2021-02-02 16:40:17 +08:00
# to resolve the version of what's in the folder, superseding the specified version.
2021-06-08 17:27:57 +08:00
# if 'productVersion.txt' is missing but download link is already available, product version will be taken from download link
2021-02-02 16:40:17 +08:00
eval $invocation
local azure_feed = " $1 "
local specific_version = " ${ 2 //[ $'\t\r\n' ] } "
2021-06-08 17:27:57 +08:00
local package_download_link = ""
if [ $# -gt 2 ] ; then
local package_download_link = " $3 "
2019-06-21 20:21:08 +08:00
fi
2021-06-08 17:27:57 +08:00
local specific_product_version = null
2019-06-21 20:21:08 +08:00
2021-06-08 17:27:57 +08:00
# Try to get the version number, using the productVersion.txt file located next to the installer file.
local download_links = ( $( get_specific_product_version_url " $azure_feed " " $specific_version " true " $package_download_link " )
$( get_specific_product_version_url " $azure_feed " " $specific_version " false " $package_download_link " ) )
for download_link in " ${ download_links [@] } "
do
say_verbose " Checking for the existence of $download_link "
if machine_has "curl"
2021-02-02 16:40:17 +08:00
then
2021-06-08 17:27:57 +08:00
specific_product_version = $( curl -s --fail " ${ download_link } ${ feed_credential } " )
if [ $? = 0 ] ; then
echo " ${ specific_product_version //[ $'\t\r\n' ] } "
return 0
fi
elif machine_has "wget"
2021-02-02 16:40:17 +08:00
then
2021-06-08 17:27:57 +08:00
specific_product_version = $( wget -qO- " ${ download_link } ${ feed_credential } " )
if [ $? = 0 ] ; then
echo " ${ specific_product_version //[ $'\t\r\n' ] } "
return 0
fi
fi
done
# Getting the version number with productVersion.txt has failed. Try parsing the download link for a version number.
say_verbose "Failed to get the version using productVersion.txt file. Download link will be parsed instead."
specific_product_version = " $( get_product_specific_version_from_download_link " $package_download_link " " $specific_version " ) "
echo " ${ specific_product_version //[ $'\t\r\n' ] } "
return 0
}
# args:
# azure_feed - $1
# specific_version - $2
# is_flattened - $3
# download link - $4 (optional)
get_specific_product_version_url( ) {
eval $invocation
local azure_feed = " $1 "
local specific_version = " $2 "
local is_flattened = " $3 "
local package_download_link = ""
if [ $# -gt 3 ] ; then
local package_download_link = " $4 "
fi
local pvFileName = "productVersion.txt"
if [ " $is_flattened " = true ] ; then
if [ -z " $runtime " ] ; then
pvFileName = "sdk-productVersion.txt"
elif [ [ " $runtime " = = "dotnet" ] ] ; then
pvFileName = "runtime-productVersion.txt"
else
pvFileName = " $runtime -productVersion.txt "
2021-02-02 16:40:17 +08:00
fi
fi
2021-06-08 17:27:57 +08:00
local download_link = null
if [ -z " $package_download_link " ] ; then
if [ [ " $runtime " = = "dotnet" ] ] ; then
download_link = " $azure_feed /Runtime/ $specific_version / ${ pvFileName } "
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
download_link = " $azure_feed /aspnetcore/Runtime/ $specific_version / ${ pvFileName } "
elif [ -z " $runtime " ] ; then
download_link = " $azure_feed /Sdk/ $specific_version / ${ pvFileName } "
else
return 1
fi
else
download_link = " ${ package_download_link %/* } / ${ pvFileName } "
fi
say_verbose " Constructed productVersion link: $download_link "
echo " $download_link "
return 0
}
# args:
# download link - $1
# specific version - $2
get_product_specific_version_from_download_link( )
{
eval $invocation
local download_link = " $1 "
local specific_version = " $2 "
local specific_product_version = ""
if [ -z " $download_link " ] ; then
echo " $specific_version "
return 0
fi
#get filename
filename = " ${ download_link ##*/ } "
#product specific version follows the product name
#for filename 'dotnet-sdk-3.1.404-linux-x64.tar.gz': the product version is 3.1.404
IFS = '-'
read -ra filename_elems <<< " $filename "
count = ${# filename_elems [@] }
if [ [ " $count " -gt 2 ] ] ; then
specific_product_version = " ${ filename_elems [2] } "
else
specific_product_version = $specific_version
fi
unset IFS;
2021-02-02 16:40:17 +08:00
echo " $specific_product_version "
2019-06-21 20:21:08 +08:00
return 0
}
# args:
# azure_feed - $1
# channel - $2
# normalized_architecture - $3
# specific_version - $4
construct_legacy_download_link( ) {
eval $invocation
local azure_feed = " $1 "
local channel = " $2 "
local normalized_architecture = " $3 "
local specific_version = " ${ 4 //[ $'\t\r\n' ] } "
local distro_specific_osname
distro_specific_osname = " $( get_legacy_os_name) " || return 1
local legacy_download_link = null
if [ [ " $runtime " = = "dotnet" ] ] ; then
legacy_download_link = " $azure_feed /Runtime/ $specific_version /dotnet- $distro_specific_osname - $normalized_architecture . $specific_version .tar.gz "
elif [ -z " $runtime " ] ; then
legacy_download_link = " $azure_feed /Sdk/ $specific_version /dotnet-dev- $distro_specific_osname - $normalized_architecture . $specific_version .tar.gz "
else
return 1
fi
echo " $legacy_download_link "
return 0
}
get_user_install_path( ) {
eval $invocation
if [ ! -z " ${ DOTNET_INSTALL_DIR :- } " ] ; then
echo " $DOTNET_INSTALL_DIR "
else
echo " $HOME /.dotnet "
fi
return 0
}
# args:
# install_dir - $1
resolve_installation_path( ) {
eval $invocation
local install_dir = $1
if [ " $install_dir " = "<auto>" ] ; then
local user_install_path = " $( get_user_install_path) "
say_verbose " resolve_installation_path: user_install_path= $user_install_path "
echo " $user_install_path "
return 0
fi
echo " $install_dir "
return 0
}
# args:
# relative_or_absolute_path - $1
get_absolute_path( ) {
eval $invocation
local relative_or_absolute_path = $1
echo " $( cd " $( dirname " $1 " ) " && pwd -P) / $( basename " $1 " ) "
return 0
}
# args:
# input_files - stdin
# root_path - $1
# out_path - $2
# override - $3
copy_files_or_dirs_from_list( ) {
eval $invocation
local root_path = " $( remove_trailing_slash " $1 " ) "
local out_path = " $( remove_trailing_slash " $2 " ) "
local override = " $3 "
local osname = " $( get_current_os_name) "
local override_switch = $(
if [ " $override " = false ] ; then
2019-12-13 22:34:07 +08:00
if [ " $osname " = "linux-musl" ] ; then
2019-06-21 20:21:08 +08:00
printf -- "-u" ;
else
printf -- "-n" ;
fi
fi )
cat | uniq | while read -r file_path; do
local path = " $( remove_beginning_slash " ${ file_path # $root_path } " ) "
local target = " $out_path / $path "
if [ " $override " = true ] || ( ! ( [ -d " $target " ] || [ -e " $target " ] ) ) ; then
mkdir -p " $out_path / $( dirname " $path " ) "
2019-10-11 07:41:56 +08:00
if [ -d " $target " ] ; then
rm -rf " $target "
fi
2019-06-21 20:21:08 +08:00
cp -R $override_switch " $root_path / $path " " $target "
fi
done
}
# args:
# zip_path - $1
# out_path - $2
extract_dotnet_package( ) {
eval $invocation
local zip_path = " $1 "
local out_path = " $2 "
local temp_out_path = " $( mktemp -d " $temporary_file_template " ) "
local failed = false
tar -xzf " $zip_path " -C " $temp_out_path " > /dev/null || failed = true
local folders_with_version_regex = '^.*/[0-9]+\.[0-9]+[^/]+/'
find " $temp_out_path " -type f | grep -Eo " $folders_with_version_regex " | sort | copy_files_or_dirs_from_list " $temp_out_path " " $out_path " false
find " $temp_out_path " -type f | grep -Ev " $folders_with_version_regex " | copy_files_or_dirs_from_list " $temp_out_path " " $out_path " " $override_non_versioned_files "
rm -rf " $temp_out_path "
2021-02-02 16:40:17 +08:00
rm -f " $zip_path " && say_verbose " Temporary zip file $zip_path was removed "
2019-06-21 20:21:08 +08:00
if [ " $failed " = true ] ; then
say_err "Extraction failed"
return 1
fi
2021-02-02 16:40:17 +08:00
return 0
}
2021-06-08 17:27:57 +08:00
# args:
# remote_path - $1
# disable_feed_credential - $2
get_http_header( )
{
eval $invocation
local remote_path = " $1 "
local disable_feed_credential = " $2 "
local failed = false
local response
if machine_has "curl" ; then
get_http_header_curl $remote_path $disable_feed_credential || failed = true
elif machine_has "wget" ; then
get_http_header_wget $remote_path $disable_feed_credential || failed = true
else
failed = true
fi
if [ " $failed " = true ] ; then
say_verbose " Failed to get HTTP header: ' $remote_path '. "
return 1
fi
return 0
}
# args:
# remote_path - $1
# disable_feed_credential - $2
2021-02-02 16:40:17 +08:00
get_http_header_curl( ) {
eval $invocation
local remote_path = " $1 "
2021-06-08 17:27:57 +08:00
local disable_feed_credential = " $2 "
remote_path_with_credential = " $remote_path "
if [ " $disable_feed_credential " = false ] ; then
remote_path_with_credential += " $feed_credential "
fi
2021-02-02 16:40:17 +08:00
curl_options = "-I -sSL --retry 5 --retry-delay 2 --connect-timeout 15 "
curl $curl_options " $remote_path_with_credential " || return 1
return 0
}
2021-06-08 17:27:57 +08:00
# args:
# remote_path - $1
# disable_feed_credential - $2
2021-02-02 16:40:17 +08:00
get_http_header_wget( ) {
eval $invocation
local remote_path = " $1 "
2021-06-08 17:27:57 +08:00
local disable_feed_credential = " $2 "
remote_path_with_credential = " $remote_path "
if [ " $disable_feed_credential " = false ] ; then
remote_path_with_credential += " $feed_credential "
fi
2021-02-02 16:40:17 +08:00
wget_options = "-q -S --spider --tries 5 --waitretry 2 --connect-timeout 15 "
wget $wget_options " $remote_path_with_credential " 2>& 1 || return 1
return 0
2019-06-21 20:21:08 +08:00
}
# args:
# remote_path - $1
# [out_path] - $2 - stdout if not provided
download( ) {
eval $invocation
local remote_path = " $1 "
local out_path = " ${ 2 :- } "
if [ [ " $remote_path " != "http" * ] ] ; then
cp " $remote_path " " $out_path "
return $?
fi
local failed = false
2021-02-05 16:21:42 +08:00
local attempts = 0
while [ $attempts -lt 3 ] ; do
attempts = $(( attempts+1))
failed = false
if machine_has "curl" ; then
downloadcurl " $remote_path " " $out_path " || failed = true
elif machine_has "wget" ; then
downloadwget " $remote_path " " $out_path " || failed = true
else
2021-02-11 15:32:14 +08:00
say_err "Missing dependency: neither curl nor wget was found."
exit 1
2021-02-05 16:21:42 +08:00
fi
if [ " $failed " = false ] || [ $attempts -ge 3 ] || { [ ! -z $http_code ] && [ $http_code = "404" ] ; } ; then
break
fi
say " Download attempt # $attempts has failed: $http_code $download_error_msg "
say " Attempt # $(( attempts+1)) will start in $(( attempts*10)) seconds. "
2021-06-08 17:27:57 +08:00
sleep $(( attempts*10))
2021-02-05 16:21:42 +08:00
done
2019-06-21 20:21:08 +08:00
if [ " $failed " = true ] ; then
say_verbose " Download failed: $remote_path "
return 1
fi
return 0
}
2021-02-02 16:40:17 +08:00
# Updates global variables $http_code and $download_error_msg
2019-06-21 20:21:08 +08:00
downloadcurl( ) {
eval $invocation
2021-02-05 16:21:42 +08:00
unset http_code
unset download_error_msg
2019-06-21 20:21:08 +08:00
local remote_path = " $1 "
local out_path = " ${ 2 :- } "
# Append feed_credential as late as possible before calling curl to avoid logging feed_credential
2021-06-08 17:27:57 +08:00
# Avoid passing URI with credentials to functions: note, most of them echoing parameters of invocation in verbose output.
2021-02-02 16:40:17 +08:00
local remote_path_with_credential = " ${ remote_path } ${ feed_credential } "
2020-05-16 05:21:50 +08:00
local curl_options = "--retry 20 --retry-delay 2 --connect-timeout 15 -sSL -f --create-dirs "
2019-06-21 20:21:08 +08:00
local failed = false
if [ -z " $out_path " ] ; then
2021-02-02 16:40:17 +08:00
curl $curl_options " $remote_path_with_credential " || failed = true
2019-06-21 20:21:08 +08:00
else
2021-02-02 16:40:17 +08:00
curl $curl_options -o " $out_path " " $remote_path_with_credential " || failed = true
2019-06-21 20:21:08 +08:00
fi
if [ " $failed " = true ] ; then
2021-06-08 17:27:57 +08:00
local disable_feed_credential = false
local response = $( get_http_header_curl $remote_path $disable_feed_credential )
2021-02-02 16:40:17 +08:00
http_code = $( echo " $response " | awk '/^HTTP/{print $2}' | tail -1 )
download_error_msg = " Unable to download $remote_path . "
if [ [ $http_code != 2* ] ] ; then
download_error_msg += " Returned HTTP status code: $http_code . "
fi
say_verbose " $download_error_msg "
2019-06-21 20:21:08 +08:00
return 1
fi
return 0
}
2021-02-02 16:40:17 +08:00
# Updates global variables $http_code and $download_error_msg
2019-06-21 20:21:08 +08:00
downloadwget( ) {
eval $invocation
2021-02-05 16:21:42 +08:00
unset http_code
unset download_error_msg
2019-06-21 20:21:08 +08:00
local remote_path = " $1 "
local out_path = " ${ 2 :- } "
# Append feed_credential as late as possible before calling wget to avoid logging feed_credential
2021-02-02 16:40:17 +08:00
local remote_path_with_credential = " ${ remote_path } ${ feed_credential } "
2020-05-16 05:21:50 +08:00
local wget_options = "--tries 20 --waitretry 2 --connect-timeout 15 "
2019-06-21 20:21:08 +08:00
local failed = false
if [ -z " $out_path " ] ; then
2021-02-02 16:40:17 +08:00
wget -q $wget_options -O - " $remote_path_with_credential " || failed = true
2019-06-21 20:21:08 +08:00
else
2021-02-02 16:40:17 +08:00
wget $wget_options -O " $out_path " " $remote_path_with_credential " || failed = true
2019-06-21 20:21:08 +08:00
fi
if [ " $failed " = true ] ; then
2021-06-08 17:27:57 +08:00
local disable_feed_credential = false
local response = $( get_http_header_wget $remote_path $disable_feed_credential )
2021-02-02 16:40:17 +08:00
http_code = $( echo " $response " | awk '/^ HTTP/{print $2}' | tail -1 )
download_error_msg = " Unable to download $remote_path . "
if [ [ $http_code != 2* ] ] ; then
download_error_msg += " Returned HTTP status code: $http_code . "
fi
say_verbose " $download_error_msg "
2019-06-21 20:21:08 +08:00
return 1
fi
return 0
}
2021-06-08 17:27:57 +08:00
get_download_link_from_aka_ms( ) {
eval $invocation
#quality is not supported for LTS or current channel
if [ [ ! -z " $normalized_quality " && ( " $normalized_channel " = = "LTS" || " $normalized_channel " = = "current" ) ] ] ; then
normalized_quality = ""
say_warning "Specifying quality for current or LTS channel is not supported, the quality will be ignored."
fi
say_verbose " Retrieving primary payload URL from aka.ms for channel: ' $normalized_channel ', quality: ' $normalized_quality ', product: ' $normalized_product ', os: ' $normalized_os ', architecture: ' $normalized_architecture '. "
#construct aka.ms link
aka_ms_link = "https://aka.ms/dotnet"
if [ " $internal " = true ] ; then
aka_ms_link = " $aka_ms_link /internal "
fi
aka_ms_link = " $aka_ms_link / $normalized_channel "
if [ [ ! -z " $normalized_quality " ] ] ; then
aka_ms_link = " $aka_ms_link / $normalized_quality "
fi
aka_ms_link = " $aka_ms_link / $normalized_product - $normalized_os - $normalized_architecture .tar.gz "
say_verbose " Constructed aka.ms link: ' $aka_ms_link '. "
#get HTTP response
#do not pass credentials as a part of the $aka_ms_link and do not apply credentials in the get_http_header function
#otherwise the redirect link would have credentials as well
#it would result in applying credentials twice to the resulting link and thus breaking it, and in echoing credentials to the output as a part of redirect link
disable_feed_credential = true
response = " $( get_http_header $aka_ms_link $disable_feed_credential ) "
say_verbose " Received response: $response "
# Get results of all the redirects.
http_codes = $( echo " $response " | awk '$1 ~ /^HTTP/ {print $2}' )
# They all need to be 301, otherwise some links are broken (except for the last, which is not a redirect but 200 or 404).
broken_redirects = $( echo " $http_codes " | sed '$d' | grep -v '301' )
# All HTTP codes are 301 (Moved Permanently), the redirect link exists.
if [ [ -z " $broken_redirects " ] ] ; then
aka_ms_download_link = $( echo " $response " | awk '$1 ~ /^Location/{print $2}' | tail -1 | tr -d '\r' )
if [ [ -z " $aka_ms_download_link " ] ] ; then
say_verbose " The aka.ms link ' $aka_ms_link ' is not valid: failed to get redirect location. "
return 1
fi
say_verbose " The redirect location retrieved: ' $aka_ms_download_link '. "
return 0
else
say_verbose " The aka.ms link ' $aka_ms_link ' is not valid: received HTTP code: $( echo " $broken_redirects " | paste -sd "," -) . "
return 1
fi
}
2019-06-21 20:21:08 +08:00
calculate_vars( ) {
eval $invocation
valid_legacy_download_link = true
2021-06-08 17:27:57 +08:00
#normalize input variables
2019-06-21 20:21:08 +08:00
normalized_architecture = " $( get_normalized_architecture_from_architecture " $architecture " ) "
2021-06-08 17:27:57 +08:00
say_verbose " Normalized architecture: ' $normalized_architecture '. "
2021-02-02 16:40:17 +08:00
normalized_os = " $( get_normalized_os " $user_defined_os " ) "
2021-06-08 17:27:57 +08:00
say_verbose " Normalized OS: ' $normalized_os '. "
normalized_quality = " $( get_normalized_quality " $quality " ) "
say_verbose " Normalized quality: ' $normalized_quality '. "
normalized_channel = " $( get_normalized_channel " $channel " ) "
say_verbose " Normalized channel: ' $normalized_channel '. "
normalized_product = " $( get_normalized_product " $runtime " ) "
say_verbose " Normalized product: ' $normalized_product '. "
#try to get download location from aka.ms link
#not applicable when exact version is specified via command or json file
normalized_version = " $( to_lowercase " $version " ) "
if [ [ -z " $json_file " && " $normalized_version " = = "latest" ] ] ; then
valid_aka_ms_link = true;
get_download_link_from_aka_ms || valid_aka_ms_link = false
if [ " $valid_aka_ms_link " = = false ] ; then
# if quality is specified - exit with error - there is no fallback approach
if [ ! -z " $normalized_quality " ] ; then
say_err " Failed to locate the latest version in the channel ' $normalized_channel ' with ' $normalized_quality ' quality for ' $normalized_product ', os: ' $normalized_os ', architecture: ' $normalized_architecture '. "
say_err "Refer to: https://aka.ms/dotnet-os-lifecycle for information on .NET Core support."
return 1
fi
say_verbose "Falling back to latest.version file approach."
else
say_verbose " Retrieved primary payload URL from aka.ms link: ' $aka_ms_download_link '. "
download_link = $aka_ms_download_link
say_verbose "Downloading using legacy url will not be attempted."
valid_legacy_download_link = false
#get version from the path
IFS = '/'
read -ra pathElems <<< " $download_link "
count = ${# pathElems [@] }
specific_version = " ${ pathElems [count-2] } "
unset IFS;
say_verbose " Version: ' $specific_version '. "
#Retrieve product specific version
specific_product_version = " $( get_specific_product_version " $azure_feed " " $specific_version " " $download_link " ) "
say_verbose " Product specific version: ' $specific_product_version '. "
install_root = " $( resolve_installation_path " $install_dir " ) "
say_verbose " InstallRoot: ' $install_root '. "
return
fi
fi
2021-02-02 16:40:17 +08:00
2019-11-09 00:02:16 +08:00
specific_version = " $( get_specific_version_from_version " $azure_feed " " $channel " " $normalized_architecture " " $version " " $json_file " ) "
2021-02-02 16:40:17 +08:00
specific_product_version = " $( get_specific_product_version " $azure_feed " " $specific_version " ) "
2019-06-21 20:21:08 +08:00
say_verbose " specific_version= $specific_version "
if [ -z " $specific_version " ] ; then
say_err "Could not resolve version information."
return 1
fi
2021-02-02 16:40:17 +08:00
download_link = " $( construct_download_link " $azure_feed " " $channel " " $normalized_architecture " " $specific_version " " $normalized_os " ) "
2019-06-21 20:21:08 +08:00
say_verbose " Constructed primary named payload URL: $download_link "
legacy_download_link = " $( construct_legacy_download_link " $azure_feed " " $channel " " $normalized_architecture " " $specific_version " ) " || valid_legacy_download_link = false
if [ " $valid_legacy_download_link " = true ] ; then
say_verbose " Constructed legacy named payload URL: $legacy_download_link "
else
say_verbose "Cound not construct a legacy_download_link; omitting..."
fi
install_root = " $( resolve_installation_path " $install_dir " ) "
say_verbose " InstallRoot: $install_root "
}
install_dotnet( ) {
eval $invocation
local download_failed = false
local asset_name = ''
local asset_relative_path = ''
if [ [ " $runtime " = = "dotnet" ] ] ; then
asset_relative_path = "shared/Microsoft.NETCore.App"
asset_name = ".NET Core Runtime"
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
asset_relative_path = "shared/Microsoft.AspNetCore.App"
asset_name = "ASP.NET Core Runtime"
elif [ -z " $runtime " ] ; then
asset_relative_path = "sdk"
asset_name = ".NET Core SDK"
else
say_err "Invalid value for \$runtime"
return 1
fi
# Check if the SDK version is already installed.
if is_dotnet_package_installed " $install_root " " $asset_relative_path " " $specific_version " ; then
say " $asset_name version $specific_version is already installed. "
return 0
fi
mkdir -p " $install_root "
zip_path = " $( mktemp " $temporary_file_template " ) "
say_verbose " Zip path: $zip_path "
# Failures are normal in the non-legacy case for ultimately legacy downloads.
# Do not output to stderr, since output to stderr is considered an error.
2021-02-02 16:40:17 +08:00
say " Downloading primary link $download_link "
# The download function will set variables $http_code and $download_error_msg in case of failure.
2019-06-21 20:21:08 +08:00
download " $download_link " " $zip_path " 2>& 1 || download_failed = true
# if the download fails, download the legacy_download_link
if [ " $download_failed " = true ] ; then
2021-02-11 15:32:14 +08:00
primary_path_http_code = " $http_code " ; primary_path_download_error_msg = " $download_error_msg "
2021-02-02 16:40:17 +08:00
case $primary_path_http_code in
404)
say " The resource at $download_link is not available. "
; ;
*)
say " $primary_path_download_error_msg "
; ;
esac
rm -f " $zip_path " 2>& 1 && say_verbose " Temporary zip file $zip_path was removed "
2019-06-21 20:21:08 +08:00
if [ " $valid_legacy_download_link " = true ] ; then
download_failed = false
download_link = " $legacy_download_link "
zip_path = " $( mktemp " $temporary_file_template " ) "
say_verbose " Legacy zip path: $zip_path "
2021-02-02 16:40:17 +08:00
say " Downloading legacy link $download_link "
# The download function will set variables $http_code and $download_error_msg in case of failure.
2019-06-21 20:21:08 +08:00
download " $download_link " " $zip_path " 2>& 1 || download_failed = true
if [ " $download_failed " = true ] ; then
2021-02-11 15:32:14 +08:00
legacy_path_http_code = " $http_code " ; legacy_path_download_error_msg = " $download_error_msg "
2021-02-02 16:40:17 +08:00
case $legacy_path_http_code in
404)
say " The resource at $download_link is not available. "
; ;
*)
say " $legacy_path_download_error_msg "
; ;
esac
rm -f " $zip_path " 2>& 1 && say_verbose " Temporary zip file $zip_path was removed "
2019-06-21 20:21:08 +08:00
fi
fi
fi
if [ " $download_failed " = true ] ; then
2021-02-02 16:40:17 +08:00
if [ [ " $primary_path_http_code " = "404" && ( " $valid_legacy_download_link " = false || " $legacy_path_http_code " = "404" ) ] ] ; then
say_err " Could not find \` $asset_name \` with version = $specific_version "
say_err "Refer to: https://aka.ms/dotnet-os-lifecycle for information on .NET Core support"
else
say_err " Could not download: \` $asset_name \` with version = $specific_version "
# 404-NotFound is an expected response if it goes from only one of the links, do not show that error.
# If primary path is available (not 404-NotFound) then show the primary error else show the legacy error.
if [ " $primary_path_http_code " != "404" ] ; then
say_err " $primary_path_download_error_msg "
return 1
fi
if [ [ " $valid_legacy_download_link " = true && " $legacy_path_http_code " != "404" ] ] ; then
say_err " $legacy_path_download_error_msg "
return 1
fi
fi
2019-06-21 20:21:08 +08:00
return 1
fi
say " Extracting zip from $download_link "
2021-02-02 16:40:17 +08:00
extract_dotnet_package " $zip_path " " $install_root " || return 1
2019-06-21 20:21:08 +08:00
2019-12-13 22:34:07 +08:00
# Check if the SDK version is installed; if not, fail the installation.
# if the version contains "RTM" or "servicing"; check if a 'release-type' SDK version is installed.
if [ [ $specific_version = = *"rtm" * || $specific_version = = *"servicing" * ] ] ; then
IFS = '-'
read -ra verArr <<< " $specific_version "
release_version = " ${ verArr [0] } "
unset IFS;
say_verbose " Checking installation: version = $release_version "
if is_dotnet_package_installed " $install_root " " $asset_relative_path " " $release_version " ; then
return 0
fi
2019-06-21 20:21:08 +08:00
fi
2019-12-13 22:34:07 +08:00
# Check if the standard SDK version is installed.
2021-02-02 16:40:17 +08:00
say_verbose " Checking installation: version = $specific_product_version "
if is_dotnet_package_installed " $install_root " " $asset_relative_path " " $specific_product_version " ; then
2019-12-13 22:34:07 +08:00
return 0
fi
2021-02-02 16:40:17 +08:00
# Version verification failed. More likely something is wrong either with the downloaded content or with the verification algorithm.
say_err " Failed to verify the version of installed \` $asset_name \`.\nInstallation source: $download_link .\nInstallation location: $install_root .\nReport the bug at https://github.com/dotnet/install-scripts/issues. "
say_err " \` $asset_name \` with version = $specific_product_version failed to install with an unknown error. "
2019-12-13 22:34:07 +08:00
return 1
2019-06-21 20:21:08 +08:00
}
args = ( " $@ " )
local_version_file_relative_path = "/.version"
bin_folder_relative_path = ""
temporary_file_template = " ${ TMPDIR :- /tmp } /dotnet.XXXXXXXXX "
channel = "LTS"
version = "Latest"
2019-11-09 00:02:16 +08:00
json_file = ""
2019-06-21 20:21:08 +08:00
install_dir = "<auto>"
architecture = "<auto>"
dry_run = false
no_path = false
no_cdn = false
azure_feed = "https://dotnetcli.azureedge.net/dotnet"
uncached_feed = "https://dotnetcli.blob.core.windows.net/dotnet"
feed_credential = ""
verbose = false
runtime = ""
runtime_id = ""
2021-06-08 17:27:57 +08:00
quality = ""
internal = false
2019-06-21 20:21:08 +08:00
override_non_versioned_files = true
non_dynamic_parameters = ""
2021-02-02 16:40:17 +08:00
user_defined_os = ""
2019-06-21 20:21:08 +08:00
while [ $# -ne 0 ]
do
name = " $1 "
case " $name " in
-c| --channel| -[ Cc] hannel)
shift
channel = " $1 "
; ;
-v| --version| -[ Vv] ersion)
shift
version = " $1 "
; ;
2021-06-08 17:27:57 +08:00
-q| --quality| -[ Qq] uality)
shift
quality = " $1 "
; ;
--internal| -[ Ii] nternal)
internal = true
non_dynamic_parameters += " $name "
; ;
2019-06-21 20:21:08 +08:00
-i| --install-dir| -[ Ii] nstall[ Dd] ir)
shift
install_dir = " $1 "
; ;
--arch| --architecture| -[ Aa] rch| -[ Aa] rchitecture)
shift
architecture = " $1 "
; ;
2021-02-02 16:40:17 +08:00
--os| -[ Oo] [ SS] )
shift
user_defined_os = " $1 "
; ;
2019-06-21 20:21:08 +08:00
--shared-runtime| -[ Ss] hared[ Rr] untime)
say_warning "The --shared-runtime flag is obsolete and may be removed in a future version of this script. The recommended usage is to specify '--runtime dotnet'."
if [ -z " $runtime " ] ; then
runtime = "dotnet"
fi
; ;
--runtime| -[ Rr] untime)
shift
runtime = " $1 "
if [ [ " $runtime " != "dotnet" ] ] && [ [ " $runtime " != "aspnetcore" ] ] ; then
say_err " Unsupported value for --runtime: ' $1 '. Valid values are 'dotnet' and 'aspnetcore'. "
2019-10-11 07:41:56 +08:00
if [ [ " $runtime " = = "windowsdesktop" ] ] ; then
say_err "WindowsDesktop archives are manufactured for Windows platforms only."
fi
2019-06-21 20:21:08 +08:00
exit 1
fi
; ;
--dry-run| -[ Dd] ry[ Rr] un)
dry_run = true
; ;
--no-path| -[ Nn] o[ Pp] ath)
no_path = true
non_dynamic_parameters += " $name "
; ;
--verbose| -[ Vv] erbose)
verbose = true
non_dynamic_parameters += " $name "
; ;
--no-cdn| -[ Nn] o[ Cc] dn)
no_cdn = true
non_dynamic_parameters += " $name "
; ;
--azure-feed| -[ Aa] zure[ Ff] eed)
shift
azure_feed = " $1 "
non_dynamic_parameters += " $name " \" " $1 " \" ""
; ;
--uncached-feed| -[ Uu] ncached[ Ff] eed)
shift
uncached_feed = " $1 "
non_dynamic_parameters += " $name " \" " $1 " \" ""
; ;
--feed-credential| -[ Ff] eed[ Cc] redential)
shift
feed_credential = " $1 "
2021-06-08 17:27:57 +08:00
#feed_credential should start with "?", for it to be added to the end of the link.
#adding "?" at the beginning of the feed_credential if needed.
[ [ -z " $( echo $feed_credential ) " ] ] || [ [ $feed_credential = = \? * ] ] || feed_credential = " ? $feed_credential "
2019-06-21 20:21:08 +08:00
; ;
--runtime-id| -[ Rr] untime[ Ii] d)
shift
runtime_id = " $1 "
non_dynamic_parameters += " $name " \" " $1 " \" ""
2021-02-02 16:40:17 +08:00
say_warning "Use of --runtime-id is obsolete and should be limited to the versions below 2.1. To override architecture, use --architecture option instead. To override OS, use --os option instead."
2019-06-21 20:21:08 +08:00
; ;
2019-11-09 00:02:16 +08:00
--jsonfile| -[ Jj] [ Ss] on[ Ff] ile)
shift
json_file = " $1 "
; ;
2019-06-21 20:21:08 +08:00
--skip-non-versioned-files| -[ Ss] kip[ Nn] on[ Vv] ersioned[ Ff] iles)
override_non_versioned_files = false
non_dynamic_parameters += " $name "
; ;
-?| --?| -h| --help| -[ Hh] elp)
script_name = " $( basename " $0 " ) "
echo ".NET Tools Installer"
echo " Usage: $script_name [-c|--channel <CHANNEL>] [-v|--version <VERSION>] [-p|--prefix <DESTINATION>] "
echo " $script_name -h|-?|--help "
echo ""
echo " $script_name is a simple command line interface for obtaining dotnet cli. "
echo ""
echo "Options:"
echo " -c,--channel <CHANNEL> Download from the channel specified, Defaults to \` $channel \`. "
echo " -Channel"
echo " Possible values:"
echo " - Current - most current release"
echo " - LTS - most current supported release"
echo " - 2-part version in a format A.B - represents a specific release"
echo " examples: 2.0; 1.0"
2021-06-08 17:27:57 +08:00
echo " - 3-part version in a format A.B.Cxx - represents a specific SDK release"
echo " examples: 5.0.1xx, 5.0.2xx."
echo " Supported since 5.0 release"
echo " Note: The version parameter overrides the channel parameter when any version other than `latest` is used."
2019-06-21 20:21:08 +08:00
echo " -v,--version <VERSION> Use specific VERSION, Defaults to \` $version \`. "
echo " -Version"
echo " Possible values:"
echo " - latest - most latest build on specific channel"
echo " - 3-part version in a format A.B.C - represents specific version of build"
echo " examples: 2.0.0-preview2-006120; 1.1.0"
2021-06-08 17:27:57 +08:00
echo " -q,--quality <quality> Download the latest build of specified quality in the channel."
echo " -Quality"
echo " The possible values are: daily, signed, validated, preview, GA."
echo " Works only in combination with channel. Not applicable for current and LTS channels and will be ignored if those channels are used."
echo " For SDK use channel in A.B.Cxx format. Using quality for SDK together with channel in A.B format is not supported."
echo " Supported since 5.0 release."
echo " Note: The version parameter overrides the channel parameter when any version other than `latest` is used, and therefore overrides the quality."
echo " --internal,-Internal Download internal builds. Requires providing credentials via --feed-credential parameter."
echo " --feed-credential <FEEDCREDENTIAL> Token to access Azure feed. Used as a query string to append to the Azure feed."
echo " -FeedCredential This parameter typically is not specified."
2019-06-21 20:21:08 +08:00
echo " -i,--install-dir <DIR> Install under specified location (see Install Location below)"
echo " -InstallDir"
echo " --architecture <ARCHITECTURE> Architecture of dotnet binaries to be installed, Defaults to \` $architecture \`. "
echo " --arch,-Architecture,-Arch"
echo " Possible values: x64, arm, and arm64"
2021-02-02 16:40:17 +08:00
echo " --os <system> Specifies operating system to be used when selecting the installer."
2021-02-11 15:32:14 +08:00
echo " Overrides the OS determination approach used by the script. Supported values: osx, linux, linux-musl, freebsd, rhel.6."
echo " In case any other value is provided, the platform will be determined by the script based on machine configuration."
2021-02-02 16:40:17 +08:00
echo " Not supported for legacy links. Use --runtime-id to specify platform for legacy links."
2021-02-11 15:32:14 +08:00
echo " Refer to: https://aka.ms/dotnet-os-lifecycle for more information."
2019-06-21 20:21:08 +08:00
echo " --runtime <RUNTIME> Installs a shared runtime only, without the SDK."
echo " -Runtime"
echo " Possible values:"
echo " - dotnet - the Microsoft.NETCore.App shared runtime"
echo " - aspnetcore - the Microsoft.AspNetCore.App shared runtime"
echo " --dry-run,-DryRun Do not perform installation. Display download link."
echo " --no-path, -NoPath Do not set PATH for the current process."
echo " --verbose,-Verbose Display diagnostics information."
echo " --azure-feed,-AzureFeed Azure feed location. Defaults to $azure_feed , This parameter typically is not changed by the user. "
echo " --uncached-feed,-UncachedFeed Uncached feed location. This parameter typically is not changed by the user."
2019-11-09 00:02:16 +08:00
echo " --skip-non-versioned-files Skips non-versioned files if they already exist, such as the dotnet executable."
echo " -SkipNonVersionedFiles"
echo " --no-cdn,-NoCdn Disable downloading from the Azure CDN, and use the uncached feed directly."
echo " --jsonfile <JSONFILE> Determines the SDK version from a user specified global.json file."
echo " Note: global.json must have a value for 'SDK:Version'"
2019-06-21 20:21:08 +08:00
echo " -?,--?,-h,--help,-Help Shows this help message"
echo ""
echo "Obsolete parameters:"
echo " --shared-runtime The recommended alternative is '--runtime dotnet'."
2019-11-09 00:02:16 +08:00
echo " This parameter is obsolete and may be removed in a future version of this script."
echo " Installs just the shared runtime bits, not the entire SDK."
2021-02-02 16:40:17 +08:00
echo " --runtime-id Installs the .NET Tools for the given platform (use linux-x64 for portable linux)."
echo " -RuntimeId" The parameter is obsolete and may be removed in a future version of this script. Should be used only for versions below 2.1.
2021-02-11 15:32:14 +08:00
echo " For primary links to override OS or/and architecture, use --os and --architecture option instead."
2019-06-21 20:21:08 +08:00
echo ""
echo "Install Location:"
echo " Location is chosen in following order:"
echo " - --install-dir option"
echo " - Environmental variable DOTNET_INSTALL_DIR"
echo " - $HOME /.dotnet "
exit 0
; ;
*)
say_err " Unknown argument \` $name \` "
exit 1
; ;
esac
shift
done
if [ " $no_cdn " = true ] ; then
azure_feed = " $uncached_feed "
fi
2021-02-02 16:40:17 +08:00
say "Note that the intended use of this script is for Continuous Integration (CI) scenarios, where:"
say "- The SDK needs to be installed without user interaction and without admin rights."
say "- The SDK installation doesn't need to persist across multiple CI runs."
say "To set up a development environment or to run apps, use installers rather than this script. Visit https://dotnet.microsoft.com/download to get the installer.\n"
2021-06-08 17:27:57 +08:00
if [ " $internal " = true ] && [ -z " $( echo $feed_credential ) " ] ; then
message = "Provide credentials via --feed-credential parameter."
if [ " $dry_run " = true ] ; then
say_warning " $message "
else
say_err " $message "
exit 1
fi
fi
2019-06-21 20:21:08 +08:00
check_min_reqs
calculate_vars
script_name = $( basename " $0 " )
if [ " $dry_run " = true ] ; then
say "Payload URLs:"
2021-06-08 17:27:57 +08:00
say " Primary named payload URL: ${ download_link } "
2019-06-21 20:21:08 +08:00
if [ " $valid_legacy_download_link " = true ] ; then
2021-06-08 17:27:57 +08:00
say " Legacy named payload URL: ${ legacy_download_link } "
2019-06-21 20:21:08 +08:00
fi
2021-02-11 15:32:14 +08:00
repeatable_command = " ./ $script_name --version " \" " $specific_version " \" " --install-dir " \" " $install_root " \" " --architecture " \" " $normalized_architecture " \" " --os " \" " $normalized_os " \" ""
2021-06-08 17:27:57 +08:00
if [ ! -z " $normalized_quality " ] ; then
repeatable_command += " --quality " \" " $normalized_quality " \" ""
fi
2019-06-21 20:21:08 +08:00
if [ [ " $runtime " = = "dotnet" ] ] ; then
repeatable_command += " --runtime " \" "dotnet" \" ""
elif [ [ " $runtime " = = "aspnetcore" ] ] ; then
repeatable_command += " --runtime " \" "aspnetcore" \" ""
fi
2021-06-08 17:27:57 +08:00
2019-06-21 20:21:08 +08:00
repeatable_command += " $non_dynamic_parameters "
2021-06-08 17:27:57 +08:00
if [ -n " $feed_credential " ] ; then
repeatable_command += " --feed-credential " \" "<feed_credential>" \" ""
fi
2019-06-21 20:21:08 +08:00
say " Repeatable invocation: $repeatable_command "
exit 0
fi
install_dotnet
bin_path = " $( get_absolute_path " $( combine_paths " $install_root " " $bin_folder_relative_path " ) " ) "
if [ " $no_path " = false ] ; then
say " Adding to current process PATH: \` $bin_path \`. Note: This change will be visible only when sourcing script. "
export PATH = " $bin_path " :" $PATH "
else
say " Binaries of dotnet can be found in $bin_path "
fi
2021-02-02 16:40:17 +08:00
say "Note that the script does not resolve dependencies during installation."
say "To check the list of dependencies, go to https://docs.microsoft.com/dotnet/core/install, select your operating system and check the \"Dependencies\" section."
2021-06-08 17:27:57 +08:00
say "Installation finished successfully."