@azbake/ingredient-storage

更改日志

• @azbake/ingredient-storage (英语)

概览

存储成分是巴克的插件. 当包含在食谱中时, 这将创建一个标准存储账户 。 是否服务 blob, (中文(简体) ), file, (中文(简体) ), disk, (中文(简体) ), queue,或 table 存储在此资源上被挂载,但模板中没有定义,只创建了逻辑构造.

使用量

这通常将作为一个依赖资源列入一种食谱。 可以设置一个 独立 但这不是典型的列入。 计量和诊断日志被记录到存储分析默认启用.

食谱

name: My package
shortName: mypkg
version: 0.0.1
ingredients:
  - "@azbake/ingredient-storage@~0"
parallelRegions: false
resourceGroup: true
variables:
  #"true" or "false" strings.  Defaults to "true" if unspecified.
  blobDiagnosticHourlyMetricsEnabled: "true"
  #Number of days to retain hourly metrics
  blobDiagnosticHourlyMetricsRetentionDays: 12
  #"true" or "false" strings.  Defaults to "true" if unspecified.
  blobDiagnosticMinuteMetricsEnabled: "false"
  #Number of days to retain minute metrics
  blobDiagnosticMinuteMetricsRetentionDays: 10    
    #"true" or "false" strings.  Defaults to "true" if unspecified.
  blobDiagnosticLoggingEnabled: "true"
  #Number of days to retain minute metrics
  blobDiagnosticLoggingRetentionDays: 10    
recipe:
  mypkg-storage:
    properties:
      type: "@azbake/ingredient-storage"
      source: ""
      parameters:
        storageAccountName: "[storage.create_resource_name()]"

*** 请注意,创建这一资源所需的唯一价值是: storageAccountName

匿名公众blob访问

可选 allowBlobPublicAccess 参数控制存储账户是否允许 匿名 公众读取blob数据.

BASELINE FLIP(裂变): 截止本版本,安全默认基线已经改变:

• 旧行为 (Pass-1): 选择 allowBlobPublicAccess 保留了该账户现有的匿名存取状态.
• 新行为( Pass-2) : 选择 allowBlobPublicAccess 现在写一个 明确 false,默认情况下使匿名公共blob访问失效.

影响 : 如果您的食谱重新调配了已有的存储账户, 并依赖于保持其当前匿名访问状态( 如果 true),现在必须明确设置 allowBlobPublicAccess: true 在食谱中保持这种状态.

• 被允许或 false数字 : 以匿名公共blob访问方式部署账户 已禁用。不使用例外标记。 这是新的安全默认基线 .
• true数字 : 允许配置匿名公共blob访问(实际匿名读取仍然取决于每个容器的公开访问级别) 财务报告和审定财务报表 所核准的例外标记 hchb-policy-exempt-anon-blob = true 将它列为匿名否认政策的例外 现有标签( 如 Metrics)被保留.

recipe:
  mypkg-storage:
    properties:
      type: "@azbake/ingredient-storage"
      parameters:
        storageAccountName: "[storage.create_resource_name()]"
        allowBlobPublicAccess: false   # disable anonymous blob access (secure baseline)
        # OR omit allowBlobPublicAccess entirely—it defaults to false

ARM 模板兼容性 :

• storage.json 使用 apiVersion 软件 2020-08-01-preview - 完全支持 allowBlobPublicAccess
• storageNetwork.json 使用 apiVersion 软件 2019-06-01 - 支持 allowBlobPublicAccess (GA'd于2019-04-01) (中文(简体) )
• storageDatalake.json 使用 apiVersion 软件 2018-02-01 ——⚠️事前 allowBlobPublicAccess (2019-04-01);该地产可能默默被ARM忽略,尽管标记仍然是邮票. 数据湖账户IsHnsEnabled),验证目标Azure环境中的部署行为,然后依赖被执行的财产.

公共网络接入(Pass-1 stub-仅标记)

可选 allowPublicNetworkAccess 参数为 a 与前置兼容的根。在这个通行证中,它只盖一个经批准的例外标记;它故意这样做 没有 写入存储账户 publicNetworkAccess 属性,所以网络行为尚未改变.

• 输入( 默认) : 没有书写,没有标签,没有财产。 完全向后兼容.
• false数字 : 没有标记,也没有书写任何财产(Pass-1 stub—— publicNetworkAccess 属性被推迟).
• true数字 : 所核准的例外标记 hchb-policy-exempt-public-network = true 将其标为公共网络接入拒绝政策中受制裁的例外。 现有标签( 如 Metrics)被保留,这个标记与 hchb-policy-exempt-anon-blob (CDN案).

推迟执行: 布尔将随后映射到 publicNetworkAccess Enabled编号 :Disabled (有私人端口) 在地物698027中,在NetOps私人-DNS门后(Feature 701425)——无需再进行食谱编辑. 在 DNS 启用器存在之前设置属性会断开连接, 这就是为什么 Pass 1 仅标记 .

recipe:
  mypkg-storage:
    properties:
      type: "@azbake/ingredient-storage"
      parameters:
        storageAccountName: "[storage.create_resource_name()]"
        allowPublicNetworkAccess: true   # stamp the exception tag only (no property yet)

上传文件到 Blob 存储

文件可以在部署期间通过指定 source 在食谱中的属性。 源属性支持通过 file:/// 语法或用相对路径指向目录.

注:此时仅支持blob存储.

name: My package
shortName: mypkg
version: 0.0.1
ingredients:
  - "@azbake/ingredient-storage@~0"
parallelRegions: false
resourceGroup: false
recipe:
  mypkg-storage:
    properties:
      type: "@azbake/ingredient-storage"
      source: "file:///./deploy/deploy.zip" # "./deploy"
      parameters:
        storageAccountName: "[storage.create_resource_name()]"
        container: myContainer
        uploadPath: mypkg/__build_buildNumber__
        deploy: false
        unzip: true

公用事业

工具课可以在烘焙内部使用. 参数和源值的 Yaml 文件 .

storage 类

函数细节

创建 资源 名称 ()

获得交通管理器配置文件的创建名称 .

...
parameters:
    storageAccountName: "[storage.create_resource_name()]"
...

回返

字符串

生命周期管理政策

存储成分支持Azure Blob存储生命周期管理政策,根据年龄自动删除blob. 您可以在全球、每个容器、甚至路径前缀应用政策.

添加 删除 政策( 名称、 启用日期、 日期、 选项) 吗

为blob生命周期管理创建删除政策规则。 支持全球政策(所有blobs),容器级,路径级,或基于标签的过滤.

示例:全局删除策略( 所有 blobs)

// Delete all blockBlobs in the storage account after 90 days
const globalRule = storage.add_delete_policy("delete-all", true, 90);

示例:集装箱级TTL

// Delete blobs in 'logs' container after 30 days
const logsRule = storage.add_delete_policy("delete-logs", true, 30, { prefixMatch: ["logs/"] });

// Delete blobs in 'temp' container after 7 days  
const tempRule = storage.add_delete_policy("delete-temp", true, 7, { prefixMatch: ["temp/"] });

// Delete blobs in 'archive' container after 365 days
const archiveRule = storage.add_delete_policy("delete-archive", true, 365, { prefixMatch: ["archive/"] });

// Create combined policy
const policy = storage.create_policy(logsRule, tempRule, archiveRule);

示例:容器内的路径级 TTL

// Delete blobs in 'data/temp/' after 7 days, 'data/cache/' after 14 days
const tempRule = storage.add_delete_policy("delete-data-temp", true, 7, { prefixMatch: ["data/temp/"] });
const cacheRule = storage.add_delete_policy("delete-data-cache", true, 14, { prefixMatch: ["data/cache/"] });

const policy = storage.create_policy(tempRule, cacheRule);

示例: 由 blob 索引标签过滤

// Delete blobs tagged as "archived" in 'reports' container after 14 days
const rule = storage.add_delete_policy("delete-archived-reports", true, 14, {
  prefixMatch: ["reports/"],
  blobIndexMatch: [{ name: "status", op: "==", value: "archived" }]
});

示例:包含附件块

// Delete both blockBlobs and appendBlobs in 'logs' container after 30 days
const rule = storage.add_delete_policy("delete-all-types", true, 30, { 
  prefixMatch: ["logs/"],
  blobTypes: ["blockBlob", "appendBlob"] 
});

创建政策(...规则)

根据一个或多个政策规则创建管理政策计划.

获取容器( 账户、 容器、 访问级别 ? 策略 ?)

获得或创建容器,可选择适用管理政策。 当提供政策时,它通过添加前缀过滤器,自动将政策规则的范围扩大到指定的容器.