@pulumi/docker 4.6.0-alpha.4 → 4.6.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/types/output.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import * as outputs from "../types/output";
2
+ import * as enums from "../types/enums";
2
3
  export interface ContainerCapabilities {
3
4
  /**
4
5
  * List of linux capabilities to add.
@@ -142,13 +143,37 @@ export interface ContainerMountVolumeOptionsLabel {
142
143
  value: string;
143
144
  }
144
145
  export interface ContainerNetworkData {
146
+ /**
147
+ * The network gateway of the container.
148
+ */
145
149
  gateway: string;
150
+ /**
151
+ * The IPV6 address of the container.
152
+ */
146
153
  globalIpv6Address: string;
154
+ /**
155
+ * The IPV6 prefix length address of the container.
156
+ */
147
157
  globalIpv6PrefixLength: number;
158
+ /**
159
+ * The IP address of the container.
160
+ */
148
161
  ipAddress: string;
162
+ /**
163
+ * The IP prefix length of the container.
164
+ */
149
165
  ipPrefixLength: number;
166
+ /**
167
+ * The IPV6 gateway of the container.
168
+ */
150
169
  ipv6Gateway: string;
170
+ /**
171
+ * The MAC address of the container.
172
+ */
151
173
  macAddress: string;
174
+ /**
175
+ * The name of the network
176
+ */
152
177
  networkName: string;
153
178
  }
154
179
  export interface ContainerNetworksAdvanced {
@@ -206,6 +231,9 @@ export interface ContainerUpload {
206
231
  * Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text. Conflicts with `contentBase64` & `source`
207
232
  */
208
233
  content?: string;
234
+ /**
235
+ * Base64-encoded data that will be decoded and uploaded as raw bytes for the object content. This allows safely uploading non-UTF8 binary data, but is recommended only for larger binary content such as the result of the `base64encode` interpolation function. See here for the reason. Conflicts with `content` & `source`
236
+ */
209
237
  contentBase64?: string;
210
238
  /**
211
239
  * If `true`, the file will be uploaded with user executable permission. Defaults to `false`.
@@ -247,11 +275,23 @@ export interface ContainerVolume {
247
275
  volumeName?: string;
248
276
  }
249
277
  export interface GetNetworkIpamConfig {
278
+ /**
279
+ * Auxiliary IPv4 or IPv6 addresses used by Network driver
280
+ */
250
281
  auxAddress?: {
251
282
  [key: string]: any;
252
283
  };
284
+ /**
285
+ * The IP address of the gateway
286
+ */
253
287
  gateway?: string;
288
+ /**
289
+ * The ip range in CIDR form
290
+ */
254
291
  ipRange?: string;
292
+ /**
293
+ * The subnet in CIDR form
294
+ */
255
295
  subnet?: string;
256
296
  }
257
297
  export interface NetworkIpamConfig {
@@ -708,7 +748,7 @@ export interface ServiceTaskSpecContainerSpec {
708
748
  */
709
749
  privileges?: outputs.ServiceTaskSpecContainerSpecPrivileges;
710
750
  /**
711
- * Whether the mount should be read-only
751
+ * Mount the container's root filesystem as read only
712
752
  */
713
753
  readOnly?: boolean;
714
754
  /**
@@ -730,7 +770,7 @@ export interface ServiceTaskSpecContainerSpec {
730
770
  [key: string]: any;
731
771
  };
732
772
  /**
733
- * SELinux user label
773
+ * The user inside the container
734
774
  */
735
775
  user?: string;
736
776
  }
@@ -792,7 +832,7 @@ export interface ServiceTaskSpecContainerSpecHealthcheck {
792
832
  */
793
833
  tests: string[];
794
834
  /**
795
- * The timeout of the service to reach the desired state `(s|m)`. Defaults to `3m`
835
+ * Maximum time to allow one check to run (ms|s|m|h). Defaults to `0s`.
796
836
  */
797
837
  timeout?: string;
798
838
  }
@@ -854,7 +894,7 @@ export interface ServiceTaskSpecContainerSpecMountBindOptions {
854
894
  }
855
895
  export interface ServiceTaskSpecContainerSpecMountTmpfsOptions {
856
896
  /**
857
- * The mode of resolution to use for internal load balancing between tasks
897
+ * The permission mode for the tmpfs mount in an integer
858
898
  */
859
899
  mode?: number;
860
900
  /**
@@ -926,7 +966,7 @@ export interface ServiceTaskSpecContainerSpecPrivilegesSeLinuxContext {
926
966
  */
927
967
  role?: string;
928
968
  /**
929
- * The mount type
969
+ * SELinux type label
930
970
  */
931
971
  type?: string;
932
972
  /**
@@ -936,11 +976,11 @@ export interface ServiceTaskSpecContainerSpecPrivilegesSeLinuxContext {
936
976
  }
937
977
  export interface ServiceTaskSpecContainerSpecSecret {
938
978
  /**
939
- * Represents the file GID. Defaults to `0`.
979
+ * Represents the file GID. Defaults to `0`
940
980
  */
941
981
  fileGid?: string;
942
982
  /**
943
- * Represents represents the FileMode of the file. Defaults to `0o444`.
983
+ * Represents represents the FileMode of the file. Defaults to `0o444`
944
984
  */
945
985
  fileMode?: number;
946
986
  /**
@@ -948,7 +988,7 @@ export interface ServiceTaskSpecContainerSpecSecret {
948
988
  */
949
989
  fileName: string;
950
990
  /**
951
- * Represents the file UID. Defaults to `0`.
991
+ * Represents the file UID. Defaults to `0`
952
992
  */
953
993
  fileUid?: string;
954
994
  /**
@@ -962,11 +1002,11 @@ export interface ServiceTaskSpecContainerSpecSecret {
962
1002
  }
963
1003
  export interface ServiceTaskSpecLogDriver {
964
1004
  /**
965
- * A random name for the port
1005
+ * The logging driver to use
966
1006
  */
967
1007
  name: string;
968
1008
  /**
969
- * A list of internal resolver variables to be modified (e.g., `debug`, `ndots:3`, etc.)
1009
+ * The options for the logging driver
970
1010
  */
971
1011
  options?: {
972
1012
  [key: string]: string;
@@ -982,7 +1022,7 @@ export interface ServiceTaskSpecNetworksAdvanced {
982
1022
  */
983
1023
  driverOpts?: string[];
984
1024
  /**
985
- * A random name for the port
1025
+ * The name/id of the network.
986
1026
  */
987
1027
  name: string;
988
1028
  }
@@ -1044,7 +1084,7 @@ export interface ServiceTaskSpecResourcesReservation {
1044
1084
  */
1045
1085
  memoryBytes?: number;
1046
1086
  /**
1047
- * CPU shares in units of `1/1e9` (or `10^-9`) of the CPU. Should be at least `1000000`
1087
+ * CPU shares in units of 1/1e9 (or 10^-9) of the CPU. Should be at least `1000000`
1048
1088
  */
1049
1089
  nanoCpus?: number;
1050
1090
  }
@@ -1064,7 +1104,7 @@ export interface ServiceTaskSpecRestartPolicy {
1064
1104
  */
1065
1105
  condition?: string;
1066
1106
  /**
1067
- * The interval to check if the desired state is reached `(ms|s)`. Defaults to `7s`.
1107
+ * Delay between restart attempts (ms|s|m|h)
1068
1108
  */
1069
1109
  delay?: string;
1070
1110
  /**
@@ -1113,41 +1153,778 @@ export interface VolumeLabel {
1113
1153
  value: string;
1114
1154
  }
1115
1155
  export declare namespace buildx {
1116
- interface Manifest {
1117
- digest: string;
1118
- platform: outputs.buildx.Platform;
1156
+ interface BuildContext {
1157
+ /**
1158
+ * Resources to use for build context.
1159
+ *
1160
+ * The location can be:
1161
+ * * A relative or absolute path to a local directory (`.`, `./app`,
1162
+ * `/app`, etc.).
1163
+ * * A remote URL of a Git repository, tarball, or plain text file
1164
+ * (`https://github.com/user/myrepo.git`, `http://server/context.tar.gz`,
1165
+ * etc.).
1166
+ */
1167
+ location: string;
1168
+ /**
1169
+ * Additional build contexts to use.
1170
+ *
1171
+ * These contexts are accessed with `FROM name` or `--from=name`
1172
+ * statements when using Dockerfile 1.4+ syntax.
1173
+ *
1174
+ * Values can be local paths, HTTP URLs, or `docker-image://` images.
1175
+ */
1176
+ named?: {
1177
+ [key: string]: outputs.buildx.Context;
1178
+ };
1179
+ }
1180
+ interface BuilderConfig {
1181
+ /**
1182
+ * Name of an existing buildx builder to use.
1183
+ *
1184
+ * Only `docker-container`, `kubernetes`, or `remote` drivers are
1185
+ * supported. The legacy `docker` driver is not supported.
1186
+ *
1187
+ * Equivalent to Docker's `--builder` flag.
1188
+ */
1189
+ name?: string;
1190
+ }
1191
+ interface CacheFromAzureBlob {
1192
+ /**
1193
+ * Base URL of the storage account.
1194
+ */
1195
+ accountUrl?: string;
1196
+ /**
1197
+ * The name of the cache image.
1198
+ */
1199
+ name: string;
1200
+ /**
1201
+ * Blob storage account key.
1202
+ */
1203
+ secretAccessKey?: string;
1204
+ }
1205
+ interface CacheFromEntry {
1206
+ /**
1207
+ * Upload build caches to Azure's blob storage service.
1208
+ */
1209
+ azblob?: outputs.buildx.CacheFromAzureBlob;
1210
+ /**
1211
+ * When `true` this entry will be excluded. Defaults to `false`.
1212
+ */
1213
+ disabled?: boolean;
1214
+ /**
1215
+ * Recommended for use with GitHub Actions workflows.
1216
+ *
1217
+ * An action like `crazy-max/ghaction-github-runtime` is recommended to
1218
+ * expose appropriate credentials to your GitHub workflow.
1219
+ */
1220
+ gha?: outputs.buildx.CacheFromGitHubActions;
1221
+ /**
1222
+ * A simple backend which caches images on your local filesystem.
1223
+ */
1224
+ local?: outputs.buildx.CacheFromLocal;
1225
+ /**
1226
+ * A raw string as you would provide it to the Docker CLI (e.g.,
1227
+ * `type=inline`).
1228
+ */
1229
+ raw?: string;
1230
+ /**
1231
+ * Upload build caches to remote registries.
1232
+ */
1233
+ registry?: outputs.buildx.CacheFromRegistry;
1234
+ /**
1235
+ * Upload build caches to AWS S3 or an S3-compatible services such as
1236
+ * MinIO.
1237
+ */
1238
+ s3?: outputs.buildx.CacheFromS3;
1239
+ }
1240
+ /**
1241
+ * cacheFromEntryProvideDefaults sets the appropriate defaults for CacheFromEntry
1242
+ */
1243
+ function cacheFromEntryProvideDefaults(val: CacheFromEntry): CacheFromEntry;
1244
+ interface CacheFromGitHubActions {
1245
+ /**
1246
+ * The scope to use for cache keys. Defaults to `buildkit`.
1247
+ *
1248
+ * This should be set if building and caching multiple images in one
1249
+ * workflow, otherwise caches will overwrite each other.
1250
+ */
1251
+ scope?: string;
1252
+ /**
1253
+ * The GitHub Actions token to use. This is not a personal access tokens
1254
+ * and is typically generated automatically as part of each job.
1255
+ *
1256
+ * Defaults to `$ACTIONS_RUNTIME_TOKEN`, although a separate action like
1257
+ * `crazy-max/ghaction-github-runtime` is recommended to expose this
1258
+ * environment variable to your jobs.
1259
+ */
1260
+ token?: string;
1261
+ /**
1262
+ * The cache server URL to use for artifacts.
1263
+ *
1264
+ * Defaults to `$ACTIONS_RUNTIME_URL`, although a separate action like
1265
+ * `crazy-max/ghaction-github-runtime` is recommended to expose this
1266
+ * environment variable to your jobs.
1267
+ */
1268
+ url?: string;
1269
+ }
1270
+ /**
1271
+ * cacheFromGitHubActionsProvideDefaults sets the appropriate defaults for CacheFromGitHubActions
1272
+ */
1273
+ function cacheFromGitHubActionsProvideDefaults(val: CacheFromGitHubActions): CacheFromGitHubActions;
1274
+ interface CacheFromLocal {
1275
+ /**
1276
+ * Digest of manifest to import.
1277
+ */
1278
+ digest?: string;
1279
+ /**
1280
+ * Path of the local directory where cache gets imported from.
1281
+ */
1282
+ src: string;
1283
+ }
1284
+ interface CacheFromRegistry {
1285
+ /**
1286
+ * Fully qualified name of the cache image to import.
1287
+ */
1288
+ ref: string;
1289
+ }
1290
+ interface CacheFromS3 {
1291
+ /**
1292
+ * Defaults to `$AWS_ACCESS_KEY_ID`.
1293
+ */
1294
+ accessKeyId?: string;
1295
+ /**
1296
+ * Prefix to prepend to blob filenames.
1297
+ */
1298
+ blobsPrefix?: string;
1299
+ /**
1300
+ * Name of the S3 bucket.
1301
+ */
1302
+ bucket: string;
1303
+ /**
1304
+ * Endpoint of the S3 bucket.
1305
+ */
1306
+ endpointUrl?: string;
1307
+ /**
1308
+ * Prefix to prepend on manifest filenames.
1309
+ */
1310
+ manifestsPrefix?: string;
1311
+ /**
1312
+ * Name of the cache image.
1313
+ */
1314
+ name?: string;
1315
+ /**
1316
+ * The geographic location of the bucket. Defaults to `$AWS_REGION`.
1317
+ */
1318
+ region: string;
1319
+ /**
1320
+ * Defaults to `$AWS_SECRET_ACCESS_KEY`.
1321
+ */
1322
+ secretAccessKey?: string;
1323
+ /**
1324
+ * Defaults to `$AWS_SESSION_TOKEN`.
1325
+ */
1326
+ sessionToken?: string;
1327
+ /**
1328
+ * Uses `bucket` in the URL instead of hostname when `true`.
1329
+ */
1330
+ usePathStyle?: boolean;
1331
+ }
1332
+ /**
1333
+ * cacheFromS3ProvideDefaults sets the appropriate defaults for CacheFromS3
1334
+ */
1335
+ function cacheFromS3ProvideDefaults(val: CacheFromS3): CacheFromS3;
1336
+ interface CacheToAzureBlob {
1337
+ /**
1338
+ * Base URL of the storage account.
1339
+ */
1340
+ accountUrl?: string;
1341
+ /**
1342
+ * Ignore errors caused by failed cache exports.
1343
+ */
1344
+ ignoreError?: boolean;
1345
+ /**
1346
+ * The cache mode to use. Defaults to `min`.
1347
+ */
1348
+ mode?: enums.buildx.CacheMode;
1349
+ /**
1350
+ * The name of the cache image.
1351
+ */
1352
+ name: string;
1353
+ /**
1354
+ * Blob storage account key.
1355
+ */
1356
+ secretAccessKey?: string;
1357
+ }
1358
+ /**
1359
+ * cacheToAzureBlobProvideDefaults sets the appropriate defaults for CacheToAzureBlob
1360
+ */
1361
+ function cacheToAzureBlobProvideDefaults(val: CacheToAzureBlob): CacheToAzureBlob;
1362
+ interface CacheToEntry {
1363
+ /**
1364
+ * Push cache to Azure's blob storage service.
1365
+ */
1366
+ azblob?: outputs.buildx.CacheToAzureBlob;
1367
+ /**
1368
+ * When `true` this entry will be excluded. Defaults to `false`.
1369
+ */
1370
+ disabled?: boolean;
1371
+ /**
1372
+ * Recommended for use with GitHub Actions workflows.
1373
+ *
1374
+ * An action like `crazy-max/ghaction-github-runtime` is recommended to
1375
+ * expose appropriate credentials to your GitHub workflow.
1376
+ */
1377
+ gha?: outputs.buildx.CacheToGitHubActions;
1378
+ /**
1379
+ * The inline cache storage backend is the simplest implementation to get
1380
+ * started with, but it does not handle multi-stage builds. Consider the
1381
+ * `registry` cache backend instead.
1382
+ */
1383
+ inline?: outputs.buildx.CacheToInline;
1384
+ /**
1385
+ * A simple backend which caches imagines on your local filesystem.
1386
+ */
1387
+ local?: outputs.buildx.CacheToLocal;
1388
+ /**
1389
+ * A raw string as you would provide it to the Docker CLI (e.g.,
1390
+ * `type=inline`)
1391
+ */
1392
+ raw?: string;
1393
+ /**
1394
+ * Push caches to remote registries. Incompatible with the `docker` build
1395
+ * driver.
1396
+ */
1397
+ registry?: outputs.buildx.CacheToRegistry;
1398
+ /**
1399
+ * Push cache to AWS S3 or S3-compatible services such as MinIO.
1400
+ */
1401
+ s3?: outputs.buildx.CacheToS3;
1402
+ }
1403
+ /**
1404
+ * cacheToEntryProvideDefaults sets the appropriate defaults for CacheToEntry
1405
+ */
1406
+ function cacheToEntryProvideDefaults(val: CacheToEntry): CacheToEntry;
1407
+ interface CacheToGitHubActions {
1408
+ /**
1409
+ * Ignore errors caused by failed cache exports.
1410
+ */
1411
+ ignoreError?: boolean;
1412
+ /**
1413
+ * The cache mode to use. Defaults to `min`.
1414
+ */
1415
+ mode?: enums.buildx.CacheMode;
1416
+ /**
1417
+ * The scope to use for cache keys. Defaults to `buildkit`.
1418
+ *
1419
+ * This should be set if building and caching multiple images in one
1420
+ * workflow, otherwise caches will overwrite each other.
1421
+ */
1422
+ scope?: string;
1423
+ /**
1424
+ * The GitHub Actions token to use. This is not a personal access tokens
1425
+ * and is typically generated automatically as part of each job.
1426
+ *
1427
+ * Defaults to `$ACTIONS_RUNTIME_TOKEN`, although a separate action like
1428
+ * `crazy-max/ghaction-github-runtime` is recommended to expose this
1429
+ * environment variable to your jobs.
1430
+ */
1431
+ token?: string;
1432
+ /**
1433
+ * The cache server URL to use for artifacts.
1434
+ *
1435
+ * Defaults to `$ACTIONS_RUNTIME_URL`, although a separate action like
1436
+ * `crazy-max/ghaction-github-runtime` is recommended to expose this
1437
+ * environment variable to your jobs.
1438
+ */
1439
+ url?: string;
1440
+ }
1441
+ /**
1442
+ * cacheToGitHubActionsProvideDefaults sets the appropriate defaults for CacheToGitHubActions
1443
+ */
1444
+ function cacheToGitHubActionsProvideDefaults(val: CacheToGitHubActions): CacheToGitHubActions;
1445
+ interface CacheToInline {
1446
+ }
1447
+ interface CacheToLocal {
1448
+ /**
1449
+ * The compression type to use.
1450
+ */
1451
+ compression?: enums.buildx.CompressionType;
1452
+ /**
1453
+ * Compression level from 0 to 22.
1454
+ */
1455
+ compressionLevel?: number;
1456
+ /**
1457
+ * Path of the local directory to export the cache.
1458
+ */
1459
+ dest: string;
1460
+ /**
1461
+ * Forcefully apply compression.
1462
+ */
1463
+ forceCompression?: boolean;
1464
+ /**
1465
+ * Ignore errors caused by failed cache exports.
1466
+ */
1467
+ ignoreError?: boolean;
1468
+ /**
1469
+ * The cache mode to use. Defaults to `min`.
1470
+ */
1471
+ mode?: enums.buildx.CacheMode;
1472
+ }
1473
+ /**
1474
+ * cacheToLocalProvideDefaults sets the appropriate defaults for CacheToLocal
1475
+ */
1476
+ function cacheToLocalProvideDefaults(val: CacheToLocal): CacheToLocal;
1477
+ interface CacheToRegistry {
1478
+ /**
1479
+ * The compression type to use.
1480
+ */
1481
+ compression?: enums.buildx.CompressionType;
1482
+ /**
1483
+ * Compression level from 0 to 22.
1484
+ */
1485
+ compressionLevel?: number;
1119
1486
  /**
1120
- * The manifest's ref
1487
+ * Forcefully apply compression.
1488
+ */
1489
+ forceCompression?: boolean;
1490
+ /**
1491
+ * Ignore errors caused by failed cache exports.
1492
+ */
1493
+ ignoreError?: boolean;
1494
+ /**
1495
+ * Export cache manifest as an OCI-compatible image manifest instead of a
1496
+ * manifest list (requires OCI media types).
1497
+ *
1498
+ * Defaults to `false`.
1499
+ */
1500
+ imageManifest?: boolean;
1501
+ /**
1502
+ * The cache mode to use. Defaults to `min`.
1503
+ */
1504
+ mode?: enums.buildx.CacheMode;
1505
+ /**
1506
+ * Whether to use OCI media types in exported manifests. Defaults to
1507
+ * `true`.
1508
+ */
1509
+ ociMediaTypes?: boolean;
1510
+ /**
1511
+ * Fully qualified name of the cache image to import.
1121
1512
  */
1122
1513
  ref: string;
1123
- size: number;
1124
1514
  }
1125
- interface Platform {
1126
- architecture: string;
1127
- os: string;
1515
+ /**
1516
+ * cacheToRegistryProvideDefaults sets the appropriate defaults for CacheToRegistry
1517
+ */
1518
+ function cacheToRegistryProvideDefaults(val: CacheToRegistry): CacheToRegistry;
1519
+ interface CacheToS3 {
1520
+ /**
1521
+ * Defaults to `$AWS_ACCESS_KEY_ID`.
1522
+ */
1523
+ accessKeyId?: string;
1524
+ /**
1525
+ * Prefix to prepend to blob filenames.
1526
+ */
1527
+ blobsPrefix?: string;
1528
+ /**
1529
+ * Name of the S3 bucket.
1530
+ */
1531
+ bucket: string;
1532
+ /**
1533
+ * Endpoint of the S3 bucket.
1534
+ */
1535
+ endpointUrl?: string;
1536
+ /**
1537
+ * Ignore errors caused by failed cache exports.
1538
+ */
1539
+ ignoreError?: boolean;
1540
+ /**
1541
+ * Prefix to prepend on manifest filenames.
1542
+ */
1543
+ manifestsPrefix?: string;
1544
+ /**
1545
+ * The cache mode to use. Defaults to `min`.
1546
+ */
1547
+ mode?: enums.buildx.CacheMode;
1548
+ /**
1549
+ * Name of the cache image.
1550
+ */
1551
+ name?: string;
1552
+ /**
1553
+ * The geographic location of the bucket. Defaults to `$AWS_REGION`.
1554
+ */
1555
+ region: string;
1556
+ /**
1557
+ * Defaults to `$AWS_SECRET_ACCESS_KEY`.
1558
+ */
1559
+ secretAccessKey?: string;
1560
+ /**
1561
+ * Defaults to `$AWS_SESSION_TOKEN`.
1562
+ */
1563
+ sessionToken?: string;
1564
+ /**
1565
+ * Uses `bucket` in the URL instead of hostname when `true`.
1566
+ */
1567
+ usePathStyle?: boolean;
1568
+ }
1569
+ /**
1570
+ * cacheToS3ProvideDefaults sets the appropriate defaults for CacheToS3
1571
+ */
1572
+ function cacheToS3ProvideDefaults(val: CacheToS3): CacheToS3;
1573
+ interface Context {
1574
+ /**
1575
+ * Resources to use for build context.
1576
+ *
1577
+ * The location can be:
1578
+ * * A relative or absolute path to a local directory (`.`, `./app`,
1579
+ * `/app`, etc.).
1580
+ * * A remote URL of a Git repository, tarball, or plain text file
1581
+ * (`https://github.com/user/myrepo.git`, `http://server/context.tar.gz`,
1582
+ * etc.).
1583
+ */
1584
+ location: string;
1585
+ }
1586
+ interface Dockerfile {
1587
+ /**
1588
+ * Raw Dockerfile contents.
1589
+ *
1590
+ * Conflicts with `location`.
1591
+ *
1592
+ * Equivalent to invoking Docker with `-f -`.
1593
+ */
1594
+ inline?: string;
1595
+ /**
1596
+ * Location of the Dockerfile to use.
1597
+ *
1598
+ * Can be a relative or absolute path to a local file, or a remote URL.
1599
+ *
1600
+ * Defaults to `${context.location}/Dockerfile` if context is on-disk.
1601
+ *
1602
+ * Conflicts with `inline`.
1603
+ */
1604
+ location?: string;
1605
+ }
1606
+ interface ExportDocker {
1607
+ /**
1608
+ * Attach an arbitrary key/value annotation to the image.
1609
+ */
1610
+ annotations?: {
1611
+ [key: string]: string;
1612
+ };
1613
+ /**
1614
+ * The compression type to use.
1615
+ */
1616
+ compression?: enums.buildx.CompressionType;
1617
+ /**
1618
+ * Compression level from 0 to 22.
1619
+ */
1620
+ compressionLevel?: number;
1621
+ /**
1622
+ * The local export path.
1623
+ */
1624
+ dest?: string;
1625
+ /**
1626
+ * Forcefully apply compression.
1627
+ */
1628
+ forceCompression?: boolean;
1629
+ /**
1630
+ * Specify images names to export. This is overridden if tags are already specified.
1631
+ */
1632
+ names?: string[];
1633
+ /**
1634
+ * Use OCI media types in exporter manifests.
1635
+ */
1636
+ ociMediaTypes?: boolean;
1637
+ /**
1638
+ * Bundle the output into a tarball layout.
1639
+ */
1640
+ tar?: boolean;
1641
+ }
1642
+ /**
1643
+ * exportDockerProvideDefaults sets the appropriate defaults for ExportDocker
1644
+ */
1645
+ function exportDockerProvideDefaults(val: ExportDocker): ExportDocker;
1646
+ interface ExportEntry {
1647
+ /**
1648
+ * When `true` this entry will be excluded. Defaults to `false`.
1649
+ */
1650
+ disabled?: boolean;
1651
+ /**
1652
+ * Export as a Docker image layout.
1653
+ */
1654
+ docker?: outputs.buildx.ExportDocker;
1655
+ /**
1656
+ * Outputs the build result into a container image format.
1657
+ */
1658
+ image?: outputs.buildx.ExportImage;
1659
+ /**
1660
+ * Export to a local directory as files and directories.
1661
+ */
1662
+ local?: outputs.buildx.ExportLocal;
1663
+ /**
1664
+ * Identical to the Docker exporter but uses OCI media types by default.
1665
+ */
1666
+ oci?: outputs.buildx.ExportOCI;
1667
+ /**
1668
+ * A raw string as you would provide it to the Docker CLI (e.g.,
1669
+ * `type=docker`)
1670
+ */
1671
+ raw?: string;
1672
+ /**
1673
+ * Identical to the Image exporter, but pushes by default.
1674
+ */
1675
+ registry?: outputs.buildx.ExportRegistry;
1676
+ /**
1677
+ * Export to a local directory as a tarball.
1678
+ */
1679
+ tar?: outputs.buildx.ExportTar;
1680
+ }
1681
+ /**
1682
+ * exportEntryProvideDefaults sets the appropriate defaults for ExportEntry
1683
+ */
1684
+ function exportEntryProvideDefaults(val: ExportEntry): ExportEntry;
1685
+ interface ExportImage {
1686
+ /**
1687
+ * Attach an arbitrary key/value annotation to the image.
1688
+ */
1689
+ annotations?: {
1690
+ [key: string]: string;
1691
+ };
1692
+ /**
1693
+ * The compression type to use.
1694
+ */
1695
+ compression?: enums.buildx.CompressionType;
1696
+ /**
1697
+ * Compression level from 0 to 22.
1698
+ */
1699
+ compressionLevel?: number;
1700
+ /**
1701
+ * Name image with `prefix@<digest>`, used for anonymous images.
1702
+ */
1703
+ danglingNamePrefix?: string;
1704
+ /**
1705
+ * Forcefully apply compression.
1706
+ */
1707
+ forceCompression?: boolean;
1708
+ /**
1709
+ * Allow pushing to an insecure registry.
1710
+ */
1711
+ insecure?: boolean;
1712
+ /**
1713
+ * Add additional canonical name (`name@<digest>`).
1714
+ */
1715
+ nameCanonical?: boolean;
1716
+ /**
1717
+ * Specify images names to export. This is overridden if tags are already specified.
1718
+ */
1719
+ names?: string[];
1720
+ /**
1721
+ * Use OCI media types in exporter manifests.
1722
+ */
1723
+ ociMediaTypes?: boolean;
1724
+ /**
1725
+ * Push after creating the image.
1726
+ */
1727
+ push?: boolean;
1728
+ /**
1729
+ * Push image without name.
1730
+ */
1731
+ pushByDigest?: boolean;
1732
+ /**
1733
+ * Store resulting images to the worker's image store and ensure all of
1734
+ * its blobs are in the content store.
1735
+ *
1736
+ * Defaults to `true`.
1737
+ *
1738
+ * Ignored if the worker doesn't have image store (when using OCI workers,
1739
+ * for example).
1740
+ */
1741
+ store?: boolean;
1742
+ /**
1743
+ * Unpack image after creation (for use with containerd). Defaults to
1744
+ * `false`.
1745
+ */
1746
+ unpack?: boolean;
1747
+ }
1748
+ /**
1749
+ * exportImageProvideDefaults sets the appropriate defaults for ExportImage
1750
+ */
1751
+ function exportImageProvideDefaults(val: ExportImage): ExportImage;
1752
+ interface ExportLocal {
1753
+ /**
1754
+ * Output path.
1755
+ */
1756
+ dest: string;
1757
+ }
1758
+ interface ExportOCI {
1759
+ /**
1760
+ * Attach an arbitrary key/value annotation to the image.
1761
+ */
1762
+ annotations?: {
1763
+ [key: string]: string;
1764
+ };
1765
+ /**
1766
+ * The compression type to use.
1767
+ */
1768
+ compression?: enums.buildx.CompressionType;
1769
+ /**
1770
+ * Compression level from 0 to 22.
1771
+ */
1772
+ compressionLevel?: number;
1773
+ /**
1774
+ * The local export path.
1775
+ */
1776
+ dest?: string;
1777
+ /**
1778
+ * Forcefully apply compression.
1779
+ */
1780
+ forceCompression?: boolean;
1781
+ /**
1782
+ * Specify images names to export. This is overridden if tags are already specified.
1783
+ */
1784
+ names?: string[];
1785
+ /**
1786
+ * Use OCI media types in exporter manifests.
1787
+ */
1788
+ ociMediaTypes?: boolean;
1789
+ /**
1790
+ * Bundle the output into a tarball layout.
1791
+ */
1792
+ tar?: boolean;
1793
+ }
1794
+ /**
1795
+ * exportOCIProvideDefaults sets the appropriate defaults for ExportOCI
1796
+ */
1797
+ function exportOCIProvideDefaults(val: ExportOCI): ExportOCI;
1798
+ interface ExportRegistry {
1799
+ /**
1800
+ * Attach an arbitrary key/value annotation to the image.
1801
+ */
1802
+ annotations?: {
1803
+ [key: string]: string;
1804
+ };
1805
+ /**
1806
+ * The compression type to use.
1807
+ */
1808
+ compression?: enums.buildx.CompressionType;
1809
+ /**
1810
+ * Compression level from 0 to 22.
1811
+ */
1812
+ compressionLevel?: number;
1813
+ /**
1814
+ * Name image with `prefix@<digest>`, used for anonymous images.
1815
+ */
1816
+ danglingNamePrefix?: string;
1817
+ /**
1818
+ * Forcefully apply compression.
1819
+ */
1820
+ forceCompression?: boolean;
1821
+ /**
1822
+ * Allow pushing to an insecure registry.
1823
+ */
1824
+ insecure?: boolean;
1825
+ /**
1826
+ * Add additional canonical name (`name@<digest>`).
1827
+ */
1828
+ nameCanonical?: boolean;
1829
+ /**
1830
+ * Specify images names to export. This is overridden if tags are already specified.
1831
+ */
1832
+ names?: string[];
1833
+ /**
1834
+ * Use OCI media types in exporter manifests.
1835
+ */
1836
+ ociMediaTypes?: boolean;
1837
+ /**
1838
+ * Push after creating the image.
1839
+ */
1840
+ push?: boolean;
1841
+ /**
1842
+ * Push image without name.
1843
+ */
1844
+ pushByDigest?: boolean;
1845
+ /**
1846
+ * Store resulting images to the worker's image store and ensure all of
1847
+ * its blobs are in the content store.
1848
+ *
1849
+ * Defaults to `true`.
1850
+ *
1851
+ * Ignored if the worker doesn't have image store (when using OCI workers,
1852
+ * for example).
1853
+ */
1854
+ store?: boolean;
1855
+ /**
1856
+ * Unpack image after creation (for use with containerd). Defaults to
1857
+ * `false`.
1858
+ */
1859
+ unpack?: boolean;
1860
+ }
1861
+ /**
1862
+ * exportRegistryProvideDefaults sets the appropriate defaults for ExportRegistry
1863
+ */
1864
+ function exportRegistryProvideDefaults(val: ExportRegistry): ExportRegistry;
1865
+ interface ExportTar {
1866
+ /**
1867
+ * Output path.
1868
+ */
1869
+ dest: string;
1128
1870
  }
1129
1871
  interface RegistryAuth {
1130
1872
  /**
1131
- * The registry's address (e.g. "docker.io")
1873
+ * The registry's address (e.g. "docker.io").
1132
1874
  */
1133
1875
  address: string;
1134
1876
  /**
1135
- * Password or token for the registry
1877
+ * Password or token for the registry.
1136
1878
  */
1137
1879
  password?: string;
1138
1880
  /**
1139
- * Username for the registry
1881
+ * Username for the registry.
1140
1882
  */
1141
1883
  username?: string;
1142
1884
  }
1885
+ interface SSH {
1886
+ /**
1887
+ * Useful for distinguishing different servers that are part of the same
1888
+ * build.
1889
+ *
1890
+ * A value of `default` is appropriate if only dealing with a single host.
1891
+ */
1892
+ id: string;
1893
+ /**
1894
+ * SSH agent socket or private keys to expose to the build under the given
1895
+ * identifier.
1896
+ *
1897
+ * Defaults to `[$SSH_AUTH_SOCK]`.
1898
+ *
1899
+ * Note that your keys are **not** automatically added when using an
1900
+ * agent. Run `ssh-add -l` locally to confirm which public keys are
1901
+ * visible to the agent; these will be exposed to your build.
1902
+ */
1903
+ paths?: string[];
1904
+ }
1143
1905
  }
1144
1906
  export declare namespace config {
1145
1907
  interface RegistryAuth {
1908
+ /**
1909
+ * Address of the registry.
1910
+ */
1146
1911
  address: string;
1147
1912
  authDisabled?: boolean;
1913
+ /**
1914
+ * Path to docker json file for registry auth. Defaults to `~/.docker/config.json`. If `DOCKER_CONFIG` is set, the value of `DOCKER_CONFIG` is used as the path. `configFile` has predencen over all other options.
1915
+ */
1148
1916
  configFile?: string;
1917
+ /**
1918
+ * Plain content of the docker json file for registry auth. `configFileContent` has precedence over username/password.
1919
+ */
1149
1920
  configFileContent?: string;
1921
+ /**
1922
+ * Password for the registry. Defaults to `DOCKER_REGISTRY_PASS` env variable if set.
1923
+ */
1150
1924
  password?: string;
1925
+ /**
1926
+ * Username for the registry. Defaults to `DOCKER_REGISTRY_USER` env variable if set.
1927
+ */
1151
1928
  username?: string;
1152
1929
  }
1153
1930
  }