Megosztás a következőn keresztül:

SqlAzureDacpacDeployment@1 – Azure SQL Database üzembe helyezési v1 feladat

Ezzel a feladattal üzembe helyezhet egy Azure SQL Database-t a DACPAC használatával, vagy szkripteket futtathat az SQLCMD használatával.

Szinopszis

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString' | 'servicePrincipal'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

Bemenetek

azureConnectionType - Azure Service-kapcsolattípus
Bemeneti alias: ConnectedServiceNameSelector. string. Engedélyezett értékek: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Alapértelmezett érték: ConnectedServiceNameARM.


azureClassicSubscription - Klasszikus Azure-előfizetési
Bemeneti alias: ConnectedServiceName. string. ConnectedServiceNameSelector = ConnectedServiceNameesetén kötelező.

Megadja az SQL-fájlok üzembe helyezéséhez használt klasszikus Azure-előfizetést.


azureSubscription - Azure-előfizetési
Bemeneti alias: ConnectedServiceNameARM. string. ConnectedServiceNameSelector = ConnectedServiceNameARMesetén kötelező.

Megadja az SQL-fájlok üzembe helyezéséhez szükséges cél Azure Resource Manager-előfizetést.


AuthenticationType - Hitelesítés típusa
string. Szükséges. Engedélyezett értékek: server (SQL Server-hitelesítés), aadAuthenticationPassword (Active Directory – Jelszó), aadAuthenticationIntegrated (Active Directory – Integrált), connectionString (kapcsolati sztring), servicePrincipal (szolgáltatásnév). Alapértelmezett érték: server.

Megadja az adatbázis-hitelesítés típusát. Ez lehet SQL Server, Active Directory (integrált), Active Directory (jelszó), kapcsolati sztring vagy egyszerű szolgáltatáshitelesítés. Az integrált hitelesítés azt jelenti, hogy az ügynök annak jelenlegi Active Directory-fiók kontextusában fér hozzá az adatbázishoz.

Adja meg az Azure SQL Server-adatbázishoz való csatlakozás lehetőségét. Megadhatja az Azure SQL Server-adatbázis adatait, az SQL Server kapcsolati sztringet, az AD-hitelesítést (jelszó vagy integrált), vagy használhatja a szolgáltatásnevet. Az SQL Server-hitelesítéshez használja az SQL Server felhasználói hitelesítő adatait. Az AD-hitelesítéshez használja az SQL Serverre konfigurált AD-felhasználó hitelesítő adatait.


AuthenticationType - Hitelesítés típusa
string. Szükséges. Engedélyezett értékek: server (SQL Server-hitelesítés), aadAuthenticationPassword (Active Directory – Jelszó), aadAuthenticationIntegrated (Active Directory – Integrált), connectionString (kapcsolati sztring). Alapértelmezett érték: server.

Megadja az adatbázis-hitelesítés típusát. Ez lehet SQL Server, Active Directory (integrált), Active Directory (jelszó), kapcsolati sztring vagy egyszerű szolgáltatáshitelesítés. Az integrált hitelesítés azt jelenti, hogy az ügynök annak jelenlegi Active Directory-fiók kontextusában fér hozzá az adatbázishoz.

Adja meg az Azure SQL Server-adatbázishoz való csatlakozás lehetőségét. Megadhatja az Azure SQL Server-adatbázis adatait, az SQL Server kapcsolati sztringet, az AD-hitelesítést (jelszó vagy integrált), vagy használhatja a szolgáltatásnevet. Az SQL Server-hitelesítéshez használja az SQL Server felhasználói hitelesítő adatait. Az AD-hitelesítéshez használja az SQL Serverre konfigurált AD-felhasználó hitelesítő adatait.


ServerName - Azure SQL Server
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalesetén kötelező.

Megadja az Azure SQL Server nevét, például Fabrikam.database.windows.net.placeholder,1433 vagy Fabrikam.database.windows.net.placeholder.


ServerName - Azure SQL Server
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegratedesetén kötelező.

Megadja az Azure SQL Server nevét, például Fabrikam.database.windows.net.placeholder,1433 vagy Fabrikam.database.windows.net.placeholder.


adatbázis-DatabaseName -
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalesetén kötelező.

Megadja annak az Azure SQL-adatbázisnak a nevét, amelyben a fájlok üzembe vannak helyezve.


adatbázis-DatabaseName -
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegratedesetén kötelező.

Megadja annak az Azure SQL-adatbázisnak a nevét, amelyben a fájlok üzembe vannak helyezve.


SqlUsername - bejelentkezési
string. AuthenticationType = serveresetén kötelező.

Az Azure SQL Server rendszergazdai bejelentkezését adja meg.


SqlPassword - jelszó
string. AuthenticationType = serveresetén kötelező.

Megadja az Azure SQL Server rendszergazdájának jelszavát. A buildelési vagy kiadási folyamatokban $(passwordVariable) definiált változók elfogadottak. A változótípust secret ként jelölheti meg a biztonságossá tételéhez.


aadSqlUsername - bejelentkezési
string. AuthenticationType = aadAuthenticationPasswordesetén kötelező.

Megadja az Active Directory felhasználónevét.


aadSqlPassword - jelszó
string. AuthenticationType = aadAuthenticationPasswordesetén kötelező.

Megadja az Active Directory-felhasználó jelszavát. A buildelési vagy kiadási folyamatokban $(passwordVariable) definiált változók elfogadottak. A változótípust secret ként jelölheti meg a biztonságossá tételéhez.


ConnectionString - kapcsolati sztring
string. AuthenticationType = connectionStringesetén kötelező.

Megadja az Azure SQL Server kapcsolati sztringet, például Server=testServer.database.windows.net.placeholder;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.


deployType - Üzembe helyezési típus
Bemeneti alias: TaskNameSelector. string. Szükséges. Engedélyezett értékek: DacpacTask (SQL DACPAC-fájl), SqlTask (SQL-szkriptfájl), InlineSqlTask (beágyazott SQL-szkript). Alapértelmezett érték: DacpacTask.


DeploymentAction - művelet
string. TaskNameSelector = DacpacTaskesetén kötelező. Engedélyezett értékek: Publish, Extract, Export, Import, Script, DriftReport (Sodródási jelentés), DeployReport (Jelentés üzembe helyezése). Alapértelmezett érték: Publish.

Megadja a listából származó SQL-műveletek egyikét. További információ a SQL-műveletek listájáról.


DacpacFile - DACPAC-fájl
string. DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReportesetén kötelező.

Megadja a DACPAC-fájl helyét az automatizálási ügynökön vagy az automatizálási ügynök számára elérhető UNC elérési úton, például \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Előre definiált rendszerváltozók is használhatók, például $(agent.releaseDirectory).


BacpacFile - BACPAC-fájl
string. DeploymentAction = Importesetén kötelező.

Megadja a BACPAC-fájl helyét az automatizálási ügynökön vagy egy, az automatizálási ügynök számára elérhető UNC elérési úton, például \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Előre definiált rendszerváltozók is használhatók, például $(agent.releaseDirectory).


SqlFile - SQL-szkript
string. TaskNameSelector = SqlTaskesetén kötelező.

Az SQL-szkriptfájl helyét adja meg az automation-ügynökön vagy egy, az automatizálási ügynök számára elérhető UNC elérési úton, például \\BudgetIT\Web\Deploy\FabrikamDB.sql. Előre definiált rendszerváltozók is használhatók, például $(agent.releaseDirectory).


SqlInline - beágyazott SQL-szkript
string. TaskNameSelector = InlineSqlTaskesetén kötelező.

Megadja a korábban kijelölt adatbázisban végrehajtandó SQL-szkriptet.


PublishProfile - Profil közzététele
string. Opcionális. Használja a TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Részletes vezérlést biztosít az Azure SQL-adatbázisok létrehozása vagy frissítései felett.
Megadja a közzétételi profil XML-fájljának elérési útját az automation agent gépen vagy UNC-megosztáson. Ha a közzétételi profil titkos kulcsokat ( például hitelesítő adatokat) tartalmaz, töltse fel a biztonságos fájlokba tárba, ahol titkosítással biztonságosan tárolja. Ezután a folyamat elején található Biztonságos fájl letöltése feladat használatával töltse le az ügynökgépre a folyamat futtatásakor. Törölje, ha a folyamat befejeződött. Előre definiált rendszerváltozók, például $(agent.buildDirectory) vagy $(agent.releaseDirectory)is használhatók.


AdditionalArguments - További SqlPackage.exe argumentumok
string. Opcionális. Használja a TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Megadja azOkat a további SqlPackage.exe argumentumokat, amelyeket az Azure SQL-adatbázis telepítésekor alkalmazunk, ha a DACPAC lehetőség van kiválasztva, például /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Ezek az argumentumok felülbírálják a közzétételi profil XML-fájljának beállításait (ha vannak ilyenek).


SqlAdditionalArguments - További Invoke-Sqlcmd argumentumok
string. Opcionális. Használja a TaskNameSelector = SqlTask.

Megadja azokat a további Invoke-Sqlcmd argumentumokat, amelyek az adott SQL-lekérdezés Azure SQL-adatbázison való végrehajtásakor lesznek alkalmazva, például -ConnectionTimeout 100 -OutputSqlErrors.


InlineAdditionalArguments - További Invoke-Sqlcmd argumentumok
string. Opcionális. Használja a TaskNameSelector = InlineSqlTask.

Megadja azokat a további Invoke-Sqlcmd argumentumokat, amelyeket a rendszer az adott SQL-lekérdezés végrehajtásakor alkalmaz az Azure SQL Database-en, például -ConnectionTimeout 100 -OutputSqlErrors.


IpDetectionMethod - Tűzfalszabályok megadása használatával
string. Szükséges. Engedélyezett értékek: AutoDetect, IPAddressRange. Alapértelmezett érték: AutoDetect.

A feladat futtatásához hozzá kell adni az automatizálási ügynök IP-címét az Azure SQL Server tűzfalán Engedélyezett IP-címekhez. Az automatikus észlelés lehetőséget választva automatikusan hozzáadhatja a tűzfalkivételt az automation-ügynök lehetséges IP-címtartományához, vagy explicit módon megadhatja a tartományt.


StartIpAddress - IP-cím indítása
string. IpDetectionMethod = IPAddressRangeesetén kötelező.

Az Automation-ügynök gépkészletének kezdő IP-címét adja meg, például 196.21.30.50.


EndIpAddress - végfelhasználói IP-cím
string. IpDetectionMethod = IPAddressRangeesetén kötelező.

Az automation agent gépkészlet záró IP-címét adja meg, például 196.21.30.65.


DeleteFirewallRule - Szabály törlése a tevékenység befejezése után
boolean. Alapértelmezett érték: true.

Ha ki van választva, a feladat befejezése után az itt megadott IP-címek törlődnek az Azure SQL Server tűzfalának engedélyezett IP-címek listájából.


Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

SqlDeploymentOutputFile
Az üzembehelyezési csomag műveletének Extract, Export, Script, DriftReportvagy DeployReportlétrehozott kimeneti fájl elérési útja.

Megjegyzések

Ezzel a feladattal üzembe helyezhet egy Azure SQL-adatbázist DACPAC használatával, vagy szkripteket futtathat az SQLCMD használatával.

Fontos

Ez a feladat csak Windows-környezetben támogatott. Ha azure Active Directory (Azure AD) integrált hitelesítést próbál használni, létre kell hoznia egy privát ügynököt. Az Azure AD integrált hitelesítése nem támogatott az üzemeltetett ügynökök esetében.

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva Ügynök
Követelmények A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük, amelyek megfelelnek az alábbi követelményeknek, kell futtatniuk a feladatot használó feladatokat: sqlpackage
képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások Bármely
Változók beállítása Bármely
Ügynök verziója 1.103.0 vagy újabb
Tevékenységkategória Üzembe helyezés
  • Last updated on