Развертывание ASDK из командной строки с помощью PowerShellDeploy ASDK from the command line using PowerShell

Пакет средств разработки Azure Stack (ASDK) — это среда тестирования и разработки, которую можно развернуть для оценки и демонстрации функций и служб Azure Stack.The Azure Stack Development Kit (ASDK) is a testing and development environment that you can deploy to evaluate and demonstrate Azure Stack features and services. Для ее установки и запуска необходимо подготовить аппаратное обеспечение среды и выполнить ряд сценариев.To get it up and running, you need to prepare the environment hardware and run some scripts. Выполнение сценариев занимает несколько часов.The scripts take several hours to run. После этого вы сможете войти на портал администратора и портал пользователя, чтобы приступить к работе с Azure Stack.After that, you can sign in to the admin and user portals to start using Azure Stack.

Предварительные требованияPrerequisites

Подготовьте главный компьютер ASDK.Prepare the ASDK host computer. Составьте план относительно структуры оборудования, программного обеспечения и сети.Plan your hardware, software, and network. Компьютер, на котором размещается ASDK, должен соответствовать требованиям к оборудованию, программному обеспечению и сети.The computer that hosts the ASDK must meet hardware, software, and network requirements. Выберите, что будете использовать: Azure Active Directory (Azure AD) или службы федерации Active Directory (AD FS).Choose between using Azure Active Directory (Azure AD) or Active Directory Federation Services (AD FS). Прежде чем начинать развертывание, убедитесь в том, что выполнены предварительные требования, чтобы процесс установки прошел без проблем.Be sure to follow these prerequisites before starting your deployment so that the installation process runs smoothly.

Перед развертыванием ASDK необходимо убедиться в том, что аппаратное обеспечение, операционная система, учетная запись и конфигурация сети главного компьютера, на котором устанавливает ASDK, соответствуют минимальным требованиям для установки ASDK.Before you deploy the ASDK, make sure your planned ASDK host computer's hardware, operating system, account, and network configurations meet the minimum requirements for installing the ASDK.

Ознакомьтесь с требованиями и рекомендациями к развертыванию ASDK .Review the ASDK deployment requirements and considerations.

Скачивание пакета развертывания и извлечение его содержимогоDownload and extract the deployment package

Убедившись, что главный компьютер ASDK соответствует базовым требованиям для установки ASDK, скачайте пакет развертывания ASDK и извлеките его содержимое.After ensuring that your ASDK host computer meets the basic requirements for installing the ASDK, the next step is to download and extract the ASDK deployment package. Пакет развертывания содержит файл Cloudbuilder.vhdx, который является виртуальным жестким диском с загружаемой операционной системой и файлами установки Azure Stack.The deployment package includes the Cloudbuilder.vhdx file, which is a virtual hard drive that includes a bootable operating system and the Azure Stack installation files.

Пакет развертывания можно скачать на узел ASDK или на другой компьютер.You can download the deployment package to the ASDK host or to another computer. Извлеченные файлы развертывания занимают до 60 ГБ дискового пространства, поэтому использование другого компьютера помогает снизить требования к оборудованию для узла ASDK.The extracted deployment files take up 60 GB of free disk space, so using another computer can help reduce the hardware requirements for the ASDK host.

Скачивание Пакета средств разработки Azure Stack (ASDK) и извлечение его содержимогоDownload and extract the Azure Stack Development Kit (ASDK)

Подготовка главного компьютера для ASDKPrepare the ASDK host computer

Перед установкой ASDK на главный компьютер необходимо подготовить среду и настроить загрузку системы с виртуального жесткого диска.Before you can install the ASDK on the host computer, the environment must be prepared and the system configured to boot from VHD. После этого узел ASDK загрузится с диска Cloudbuilder.vhdx (виртуальный жесткий диск, содержащий загружаемую операционную систему и файлы установки Azure Stack).After this step, the ASDK host will boot to the Cloudbuilder.vhdx (a virtual hard drive that includes a bootable operating system and the Azure Stack installation files).

Настройте главный компьютер с ASDK для загрузки с CloudBuilder.vhdx с помощью PowerShell.Use PowerShell to configure the ASDK host computer to boot from CloudBuilder.vhdx. Эти команды настроят главный компьютер с ASDK для загрузки со скачанного и извлеченного виртуального жесткого диска Azure Stack (CloudBuilder.vhdx).These commands configure your ASDK host computer to boot from the downloaded and extracted Azure Stack virtual harddisk (CloudBuilder.vhdx). После выполнения этих действий перезапустите главный компьютер ASDK.After completing these steps, restart the ASDK host computer.

Настройка главного компьютера с ASDK для загрузки с CloudBuilder.vhdx:To configure the ASDK host computer to boot from CloudBuilder.vhdx:

  1. Запустите командную строку от имени администратора.Launch a command prompt as admin.
  2. Выполните bcdedit /copy {current} /d "Azure Stack".Run bcdedit /copy {current} /d "Azure Stack".
  3. Скопируйте (клавишами CTRL+C) возвращенное значение CLSID, включая обязательные круглые скобки ({}).Copy (CTRL+C) the CLSID value returned, including the required curly brackets ({}). Это значение называется {CLSID}. Его нужно будет вставить (с помощью клавиш CTRL+V или щелчком правой кнопкой мыши) на оставшихся шагах.This value is referred to as {CLSID} and needs to be pasted in (CTRL+V or right-click) in the remaining steps.
  4. Выполните bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
  5. Выполните bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
  6. Выполните bcdedit /set {CLSID} detecthal on.Run bcdedit /set {CLSID} detecthal on.
  7. Выполните bcdedit /default {CLSID}.Run bcdedit /default {CLSID}.
  8. Чтобы проверить параметры загрузки, запустите bcdedit.To verify boot settings, run bcdedit.
  9. Убедитесь, что файл CloudBuilder.vhdx перемещен в корень диска C:\ (C:\CloudBuilder.vhdx), и перезапустите главный компьютер ASDK.Ensure that the CloudBuilder.vhdx file has been moved to the root of the C:\ drive (C:\CloudBuilder.vhdx) and restart the ASDK host computer. После перезапуска главный компьютер ASDK должен загрузиться с жесткого диска виртуальной машины CloudBuilder.vhdx, чтобы начать развертывание ASDK.When the ASDK host computer is restarted, it should boot from the CloudBuilder.vhdx virtual machine (VM) hard drive to begin ASDK deployment.

Важно!

Прежде чем перезапускать главный компьютер ASDK, убедитесь в наличии прямого физического или KVM-доступа к нему.Ensure that you have direct physical or KVM access to the ASDK host computer before restarting it. При первом запуске виртуальной машины она предлагает завершить установку Windows Server.When the VM first starts, it prompts you to complete Windows Server Setup. Укажите те же учетные данные администратора, что использовались для входа на главный компьютер ASDK.Provide the same admin credentials you used to log into the ASDK host computer.

Подготовка узла ASDK с помощью PowerShellPrepare the ASDK host using PowerShell

После успешной загрузки главного компьютера ASDK с помощью образа CloudBuilder.vhdx выполните вход с теми же учетными данными локального администратора, которые использовались для входа на главный компьютер ASDK.After the ASDK host computer successfully boots into the CloudBuilder.vhdx image, sign in with the same local admin credentials you used to log into the ASDK host computer. Эти же учетные данные вы указали при завершении установки Windows Server, когда главный компьютер загружался с виртуального жесткого диска.These are also the same credentials you provided as part of completing the Windows Server Setup when the host computer booted from VHD.

Примечание

Кроме того, при необходимости можно также настроить параметры телеметрии Azure Stack до установки ASDK.Optionally, you can also configure Azure Stack telemetry settings before installing the ASDK.

Откройте консоль PowerShell с повышенными привилегиями и выполните команды этого раздела, чтобы развернуть ASDK на узле ASDK.Open an elevated PowerShell console and run the commands in this section to deploy the ASDK on the ASDK host.

Важно!

Установка ASDK поддерживает только один сетевой адаптер (NIC) для работы в сети.ASDK installation supports exactly one network interface card (NIC) for networking. При наличии нескольких сетевых интерфейсов перед выполнением сценария развертывания включите только один из них, а все остальные отключите.If you have multiple NICs, make sure that only one is enabled (and all others are disabled) before running the deployment script.

Вы можете развернуть Azure Stack с помощью Azure AD или AD FS Windows Server в качестве поставщика удостоверений.You can deploy Azure Stack with Azure AD or Windows Server AD FS as the identity provider. Azure Stack, поставщики ресурсов и другие приложения одинаково работают с обеими службами.Azure Stack, resource providers, and other apps work the same way with both.

Совет

Если вы не указали никаких параметров настройки (см. ниже раздел о дополнительных параметрах и примерах InstallAzureStackPOC.ps1), появится запрос на ввод необходимых параметров.If you don't supply any setup parameters (see InstallAzureStackPOC.ps1 optional parameters and examples below), you're prompted for the required parameters.

Развертывание Azure Stack с помощью Azure ADDeploy Azure Stack using Azure AD

Чтобы развернуть Azure Stack с использованием Azure AD в качестве поставщика удостоверений , компьютер должен быть подключен к Интернету напрямую или через прозрачный прокси-сервер.To deploy Azure Stack using Azure AD as the identity provider, you must have internet connectivity either directly or through a transparent proxy.

Выполните следующие команды PowerShell, чтобы развернуть ASDK с использованием Azure AD.Run the following PowerShell commands to deploy the ASDK using Azure AD:

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator     
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password

Через несколько минут после установки ASDK вам будет предложено ввести учетные данные Azure AD.A few minutes into ASDK installation you'll be prompted for Azure AD credentials. Укажите учетные данные глобального администратора для клиента Azure AD.Provide the global admin credentials for your Azure AD tenant.

После развертывания разрешение глобального администратора Azure Active Directory не требуется.After deployment, Azure Active Directory global admin permission isn't required. Тем не менее для некоторых операций могут потребоваться учетные данные глобального администратора.However, some operations may require the global admin credential. К примерам таких операций можно отнести сценарий установки от поставщика ресурсов или новую функцию, для которой требуется получить разрешение.Examples of such operations include a resource provider installer script or a new feature requiring a permission to be granted. Можно временно восстановить разрешения глобального администратора или использовать отдельную глобальную учетную запись администратора, которая является владельцем подписки поставщика по умолчанию.You can either temporarily reinstate the account's global admin permissions or use a separate global admin account that's an owner of the default provider subscription.

Развертывание Azure Stack с помощью AD FSDeploy Azure Stack using AD FS

Чтобы развернуть ASDK с использованием AD FS в качестве поставщика удостоверений, выполните следующие команды PowerShell (просто нужно добавить параметр -UseADFS).To deploy the ASDK using AD FS as the identity provider, run the following PowerShell commands (you just need to add the -UseADFS parameter):

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS

При развертывании служб федерации Active Directory служба каталогов по умолчанию используется в качестве поставщика удостоверений.In AD FS deployments, the default stamp Directory Service is used as the identity provider. Учетная запись по умолчанию для входа — azurestackadmin@azurestack.local, а в качестве пароля будет использоваться пароль, указанный с помощью команд настройки PowerShell.The default account to sign in with is azurestackadmin@azurestack.local, and the password is set to what you provided as part of the PowerShell setup commands.

Процесс развертывания может занять несколько часов, в течение которых система автоматически перезагрузится один раз.The deployment process can take a few hours, during which time the system automatically reboots once. После завершения развертывания в консоли PowerShell отобразится следующее: Завершение: действие "развертывание".When the deployment succeeds, the PowerShell console displays: COMPLETE: Action 'Deployment'. Если развертывание завершилось сбоем, выполните сценарий снова, используя параметр -rerun.If the deployment fails, try running the script again using the -rerun parameter. Вы также можете повторно развернуть ASDK с нуля.Or, you can redeploy ASDK from scratch.

Важно!

Если вы хотите отслеживать ход развертывания после перезагрузки компьютера ASDK, войдите в систему как AzureStack\AzureStackAdmin.If you want to monitor the deployment progress after the ASDK host reboots, you must sign in as AzureStack\AzureStackAdmin. Если вы входите в систему как локальный администратор после перезапуска главного компьютера (и присоединения к домену azurestack.local), вы не увидите ход выполнения развертывания.If you sign in as a local admin after the host computer is restarted (and joined to the azurestack.local domain), you won't see the deployment progress. Не выполняйте развертывание повторно. Вместо этого войдите в систему с учетной записью AzureStack\AzureStackAdmin с паролем учетной записи локального администратора, чтобы проверить выполнение установки.Don't rerun deployment, instead sign in as AzureStack\AzureStackAdmin with the same password as the local admin to validate that the setup is running.

Примеры сценария развертывания AADAzure AD deployment script examples

Полное развертывание AAD можно прописать в сценарии.You can script the entire Azure AD deployment. Несколько примеров с комментариями, содержащими некоторые необязательные параметры.Here are a few commented examples that include some optional parameters.

Если удостоверение AAD связано только с одним каталогом AAD:If your Azure AD identity is only associated with one Azure AD directory:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.

Если удостоверение AAD связано только с несколькими каталогами AAD:If your Azure AD identity is associated with greater than one Azure AD directory:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" #Example: user@AADDirName.onmicrosoft.com 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -InfraAzureDirectoryTenantName "<Azure AD directory in the form of domainname.onmicrosoft.com or an Azure AD verified custom domain name>" -TimeServer 52.168.138.145 #Example time server IP address.

Если в вашей среде отключен протокол DHCP, в один из предоставленных примеров использования необходимо добавить приведенные ниже дополнительные параметры.If your environment doesn't have DHCP enabled, then you must include the following additional parameters to one of the options above (example usage provided):

.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26

Необязательные параметры ASDK InstallAzureStackPOC.ps1ASDK InstallAzureStackPOC.ps1 optional parameters

ПараметрParameter Обязательный/необязательныйRequired/Optional ОписаниеDescription
AdminPasswordAdminPassword ОбязательноRequired Задает учетную запись локального администратора и другие учетные записи пользователей на всех виртуальных машинах, созданных в процессе развертывания ASDK.Sets the local admin account and all other user accounts on all the VMs created as part of ASDK deployment. Этот пароль должен совпадать с текущим паролем локального администратора на узле.This password must match the current local admin password on the host.
InfraAzureDirectoryTenantNameInfraAzureDirectoryTenantName ОбязательноRequired Задает каталог клиента.Sets the tenant directory. Используйте этот параметр, чтобы указать конкретный каталог, где у учетной записи Azure AD есть разрешения на управление несколькими каталогами.Use this parameter to specify a specific directory where the Azure AD account has permissions to manage multiple directories. Полное имя клиента Azure AD в формате .onmicrosoft.com или имя проверенного личного домена Azure AD.Full name of an Azure AD tenant in the format of .onmicrosoft.com or an Azure AD verified custom domain name.
TimeServerTimeServer ОбязательноRequired Используйте этот параметр, чтобы указать определенный сервер времени.Use this parameter to specify a specific time server. Этот параметр может быть предоставлен в качестве допустимого IP-адреса сервера времени.This parameter must be provided as a valid time server IP address. Имена серверов не поддерживаются.Server names aren't supported.
InfraAzureDirectoryTenantAdminCredentialInfraAzureDirectoryTenantAdminCredential НеобязательноOptional Задает имя пользователя и пароль Azure Active Directory.Sets the Azure Active Directory user name and password. В качестве этих учетных данных Azure следует использовать идентификатор организации.These Azure credentials must be an Org ID.
InfraAzureEnvironmentInfraAzureEnvironment НеобязательноOptional Выберите среду Azure, в которой вы хотите зарегистрировать это развертывание Azure Stack.Select the Azure Environment with which you want to register this Azure Stack deployment. Допустимые значения: глобальная служба Azure, Azure — Китай, Azure — US Government.Options include global Azure, Azure - China, Azure - US Government.
DNSForwarderDNSForwarder НеобязательноOptional DNS-сервер, созданный в ходе развертывания Azure Stack.A DNS server is created as part of the Azure Stack deployment. Чтобы разрешить компьютерам в решении разрешать имена, расположенные за пределами метки, укажите имеющийся DNS-сервер инфраструктуры.To allow computers inside the solution to resolve names outside of the stamp, provide your existing infrastructure DNS server. DNS-сервер, расположенный в этой метке, перенаправляет неизвестные запросы на сопоставление имен на этот DNS-сервер.The in-stamp DNS server forwards unknown name resolution requests to this server.
RerunRerun НеобязательноOptional Этот флажок используется для повторного выполнения развертывания.Use this flag to rerun deployment. Используются все предыдущие входные данные.All previous input is used. Повторный ввод ранее предоставленных данных не поддерживается, так как для развертывания создается и используется несколько уникальных значений.Reentering data previously provided isn't supported because several unique values are generated and used for deployment.

Настройка после развертыванияPerform post-deployment configurations

После установки ASDK нужно выполнить несколько рекомендуемых проверок и внести некоторые изменения в конфигурацию.After installing the ASDK, there are a few recommended post-installation checks and configuration changes that should be made. Проверьте правильность установки, использовав командлет test-AzureStack. Затем установите инструменты PowerShell и GitHub для Azure Stack.Validate your installation was installed successfully by using the test-AzureStack cmdlet, then install Azure Stack PowerShell and GitHub tools.

Рекомендуется сбросить политику срока действия паролей, чтобы срок действия пароля для главного компьютера ASDK не завершился до окончания периода ознакомления.We recommend you reset the password expiration policy to make sure that the password for the ASDK host doesn't expire before your evaluation period ends.

Примечание

Кроме того, при необходимости можно также настроить параметры телеметрии Azure Stack после установки ASDK.Optionally, you can also configure Azure Stack telemetry settings after installing the ASDK.

Задачи, выполняемые после развертывания ASDKPost ASDK deployment tasks

Регистрация в AzureRegister with Azure

Azure Stack необходимо зарегистрировать в Azure, чтобы можно было скачивать элементы Azure Marketplace в Azure Stack.You must register Azure Stack with Azure so that you can download Azure Marketplace items to Azure Stack.

Регистрация Azure Stack в AzureRegister Azure Stack with Azure

Дальнейшие действияNext steps

Поздравляем!Congratulations! После выполнения этих действий вы получите среду ASDK с порталом администрирования (https://adminportal.local.azurestack.external) и пользовательским порталом (https://portal.local.azurestack.external).After completing these steps, you'll have an ASDK environment with both admin https://adminportal.local.azurestack.external and user https://portal.local.azurestack.external portals.

Настройка, выполняемая после установки ASDKPost ASDK installation configuration tasks