后端云原生【免費下載鏈接】botoFor the latest version of boto, see https://github.com/boto/boto3 -- Python interface to Amazon Web Services項目地址https://gitcode.com/gh_mirrors/bo/boto點擊查看免費下載boto v2.18.0 是 2013 年 11 月發(fā)布的重要版本它圍繞身份與訪問管理IAM/STS 的 SAML 聯(lián)合認(rèn)證、CloudWatch 簽名算法升級、ELB 屬性配置、RDS 主從切換與重命名、EC2 快照鏡像注冊等方向補(bǔ)充了大量新 API 與參數(shù)并修復(fù)了 HTTP 請求頭 Unicode 編碼等一系列問題。閱讀本文后你將掌握該版本中每個新特性的調(diào)用入口、參數(shù)語義與底層實現(xiàn)并能基于 boto 倉庫源碼快速定位對應(yīng)代碼。版本概覽本版本的發(fā)布說明見 v2.18.0.rst發(fā)布日期為 2013/11/22。該版本的核心更新方向如下為 AWS Identity and Access ManagementIAM、AWS Security Token ServiceSTS新增與 SAML 相關(guān)的調(diào)用Elastic Load BalancingELB新增 Attributes 支持與跨可用區(qū)負(fù)載均衡Cross Zone Balancing配置Amazon Elastic Compute CloudEC2更新get_all_snapshots并支持基于快照注冊鏡像Amazon Relational Database ServiceRDS新增只讀副本提升promote與實例重命名rename支持Elastic Transcoder API 與參數(shù)獲得補(bǔ)充Amazon Redshift 開始支持 SNS 通知CloudWatch 改用簽名版本四Signature Version 4修復(fù) HTTP 請求頭編碼問題并為多個服務(wù)修復(fù)文檔。SAML 聯(lián)合認(rèn)證STS 與 IAM 的新調(diào)用v2.18.0 的核心新特性之一是為 STS 與 IAM 增加 SAML 相關(guān)調(diào)用對應(yīng) 發(fā)布說明 中 issue 1867 的改動。這套能力讓企業(yè)可以把內(nèi)部身份目錄如 AD/LDAP通過 SAML 2.0 協(xié)議與 AWS 的基于角色的訪問控制綁定無需為每個用戶單獨分發(fā) AWS 密鑰。STSassume_role_with_saml在 boto/sts/connection.py 中新增了assume_role_with_saml方法它返回一組臨時安全憑證Access Key ID、Secret Access Key 與 Security Token供已經(jīng)通過 SAML 認(rèn)證響應(yīng)的用戶使用。方法簽名與參數(shù)語義如下def assume_role_with_saml(self, role_arn, principal_arn, saml_assertion, policyNone, duration_secondsNone):各參數(shù)含義均來自 源碼 docstringrole_arn要扮演的 IAM 角色的 ARNprincipal_arnIAM 中描述 IdP 的 SAML provider 的 ARNsaml_assertionIdP 提供的 Base64 編碼的 SAML 認(rèn)證響應(yīng)斷言policy可選的 IAM JSON 策略用于在角色權(quán)限基礎(chǔ)上進(jìn)一步收斂權(quán)限策略長度必須不超過 2048 字節(jié)、打包后小于 450 字節(jié)duration_seconds會話時長取值范圍 900 秒15 分鐘到 3600 秒1 小時默認(rèn) 3600 秒實際過期時間取本參數(shù)與 SAML 響應(yīng)中NotOnOrAfter字段中較短的哪一個。底層實現(xiàn)上該方法組裝RoleArn、PrincipalArn、SAMLAssertion三個必選參數(shù)可選地附加Policy與DurationSeconds通過get_object(AssumeRoleWithSAML, ...)發(fā)起 POST 請求。一個值得注意的實現(xiàn)細(xì)節(jié)是SAML 斷言在請求中需要被 URL 編碼——這一點在 boto/auth.py 中有明確注釋指出 STS 要求assume_role_with_saml調(diào)用時對saml_response做 URL 編碼。該調(diào)用不需要調(diào)用方持有 AWS 安全憑證調(diào)用者身份通過上傳到 SAML provider 實體的元數(shù)據(jù)文檔中的密鑰來校驗這是它與AssumeRole的重要區(qū)別。IAMSAML Provider 全生命周期管理配合 STS 的AssumeRoleWithSAMLboto/iam/connection.py 新增了 SAML Provider 的增刪改查四個方法方法對應(yīng) API作用create_saml_provider(saml_metadata_document, name)CreateSAMLProvider上傳 IdP 生成的 SAML 2.0 元數(shù)據(jù)文檔創(chuàng)建描述 IdP 的實體list_saml_providers()ListSAMLProviders列出賬號內(nèi)的 SAML providerget_saml_provider(saml_provider_arn)GetSAMLProvider獲取已上傳的元數(shù)據(jù)文檔update_saml_provider(saml_provider_arn, saml_metadata_document)UpdateSAMLProvider更新已有 provider 的元數(shù)據(jù)文檔delete_saml_provider(saml_provider_arn)DeleteSAMLProvider刪除 provider創(chuàng)建 provider 時上傳的元數(shù)據(jù)文檔由組織使用的 IdP 身份管理軟件生成包含簽發(fā)者名稱、過期信息以及用于校驗 SAML 認(rèn)證響應(yīng)斷言的密鑰。這些操作均要求使用 Signature Version 4 簽名源碼 docstring 中明確注明 This operation requires Signature Version 4。需要注意的是刪除 provider 并不會更新任何將其作為信任策略 principal 引用的角色后續(xù)任何嘗試扮演該角色都會失敗。SAML 聯(lián)合認(rèn)證的完整鏈條是IdP 簽發(fā)斷言 → IAM 中的 SAML provider 校驗斷言 → STSAssumeRoleWithSAML發(fā)放臨時憑證。該鏈路常見于企業(yè) Web 單點登錄SSO與 API 級聯(lián)合訪問兩類場景。CloudWatch 升級為 SigV4 簽名v2.18.0 將 CloudWatch 的簽名機(jī)制升級為 Signature Version 4。對應(yīng)實現(xiàn)位于 boto/ec2/cloudwatch/init.pyclass CloudWatchConnection(AWSQueryConnection): APIVersion boto.config.get(Boto, cloudwatch_version, 2010-08-01) DefaultRegionName boto.config.get(Boto, cloudwatch_region_name, us-east-1) DefaultRegionEndpoint boto.config.get(Boto, cloudwatch_region_endpoint, monitoring.us-east-1.amazonaws.com) ... def _required_auth_capability(self): return [hmac-v4]關(guān)鍵點是_required_auth_capability返回[hmac-v4]即該連接類的所有請求默認(rèn)使用 SigV4hmac-v4簽名。CloudWatchConnection還展示了 boto 的配置化設(shè)計API 版本、默認(rèn)區(qū)域、默認(rèn)端點均可通過 boto 配置文件中的cloudwatch_version、cloudwatch_region_name、cloudwatch_region_endpoint覆蓋。此外源碼中還保留了一個時代性 hack因 eu-west-1 端點 SSL 證書配置問題該區(qū)域會自動關(guān)閉證書校驗。SigV4 與舊版 SigV2 的主要差異在于請求需包含規(guī)范化的請求內(nèi)容哈希、按時間排序的簽名字符串以及Authorization頭的特定構(gòu)造。boto 的 SigV4 實現(xiàn)在 boto/auth.py 中同一文件也包含對 S3 這類不做路徑規(guī)范化的服務(wù)的特判邏輯boto/auth.py。ELB屬性配置與跨可用區(qū)負(fù)載均衡本版本為 ELB 增加了 Attributes屬性支持其中最具代表性的是跨可用區(qū)負(fù)載均衡Cross Zone Balancing。相關(guān)實現(xiàn)分布在三個文件中連接層modify_lb_attribute 與 get_lb_attributeboto/ec2/elb/init.py 中的modify_lb_attribute支持以下屬性crosszoneloadbalancing布爾值接收True/False內(nèi)部轉(zhuǎn)換為true/false字符串對應(yīng)請求參數(shù)LoadBalancerAttributes.CrossZoneLoadBalancing.Enabledaccesslog接收AccessLogAttribute實例寫入AccessLog.Enabled、AccessLog.S3BucketName、AccessLog.S3BucketPrefix、AccessLog.EmitIntervalconnectiondraining接收ConnectionDrainingAttribute實例寫入ConnectionDraining.Enabled與ConnectionDraining.Timeoutconnectingsettings接收ConnectionSettingAttribute實例寫入ConnectionSettings.IdleTimeout傳入未知屬性會拋出ValueError(InvalidAttribute, attribute)。讀取側(cè)由get_all_lb_attributes調(diào)用DescribeLoadBalancerAttributes返回LbAttributes對象get_lb_attribute則在其上按屬性名取值。對象層LoadBalancer 便捷方法boto/ec2/elb/loadbalancer.py 為LoadBalancer對象提供了更友好的三個方法lb.is_cross_zone_load_balancing(forceFalse) # 查詢force 為 True 時強(qiáng)制重新拉取屬性 lb.enable_cross_zone_load_balancing() # 啟用跨可用區(qū)負(fù)載均衡 lb.disable_cross_zone_load_balancing() # 禁用跨可用區(qū)負(fù)載均衡數(shù)據(jù)層屬性對象boto/ec2/elb/attributes.py 定義了CrossZoneLoadBalancingAttribute數(shù)據(jù)類其enabled字段承載開關(guān)狀態(tài)LbAttributes則聚合了跨可用區(qū)負(fù)載均衡、連接設(shè)置、訪問日志、連接排空等全部屬性CrossZoneLoadBalancing作為可索引屬性名返回對應(yīng)對象attributes.py。跨可用區(qū)負(fù)載均衡的意義在于負(fù)載均衡器會把流量均勻分發(fā)到所有已注冊實例所在的可用區(qū)而不是僅本區(qū)實例從而提升多可用區(qū)部署時的資源利用率與故障恢復(fù)能力。RDS只讀副本提升與實例重命名v2.18.0 為 RDS 新增了 promote提升只讀副本與 rename重命名實例支持實現(xiàn)均在 boto/rds/init.pypromote_read_replicaboto/rds/init.py 中的promote_read_replica(id, backup_retention_periodNone, preferred_backup_windowNone)將只讀副本提升為獨立的數(shù)據(jù)庫實例。參數(shù)說明id新實例的唯一標(biāo)識1-63 個字母數(shù)字字符首字符必須是字母不能以連字符結(jié)尾或包含兩個連續(xù)連字符backup_retention_period自動備份保留天數(shù)設(shè)為 0 表示禁用自動備份preferred_backup_window自動備份的每日時間窗口UTC格式為hh24:mi-hh24:mi。底層組裝DBInstanceIdentifier并可選附加BackupRetentionPeriod、PreferredBackupWindow調(diào)用PromoteReadReplica后返回DBInstance對象。modify_dbinstance 與 renameboto/rds/init.py 中的modify_dbinstance在原有參數(shù)基礎(chǔ)上新增了new_instance_id參數(shù)底層映射為NewDBInstanceIdentifier請求參數(shù)從而實現(xiàn)實例重命名。該方法整體支持非常全面的修改面參數(shù)組DBParameterGroupName、安全組DBSecurityGroups.member、VpcSecurityGroupIds.member、維護(hù)窗口PreferredMaintenanceWindow、主密碼MasterUserPassword、分配存儲AllocatedStorage、實例規(guī)格DBInstanceClass、備份保留期與備份窗口、多可用區(qū)MultiAZ、立即生效開關(guān)ApplyImmediately以及 IOPSIops。EC2快照查詢更新與基于快照注冊鏡像本版本更新了 EC2 的get_all_snapshots并支持直接用一個 EBS 快照注冊為 AMI。boto/ec2/connection.py 中的get_all_snapshots(snapshot_idsNone, ...)支持按快照 ID 列表過濾通過build_list_params構(gòu)造SnapshotId.member.N參數(shù)同時提供delete_snapshot、copy_snapshot、get_snapshot_attribute等配套操作本版本對過濾、分頁等相關(guān)行為進(jìn)行了更新。更值得關(guān)注的是 register_image 新增的snapshot_id與delete_root_volume_on_termination參數(shù)snapshot_id指定用于鏡像根設(shè)備的快照 ID與block_device_map互斥且要求同時提供root_device_namedelete_root_volume_on_termination僅在使用快照創(chuàng)建鏡像時生效決定實例終止后是否刪除根卷默認(rèn)False——源碼 docstring 特別提醒終止后遺留卷并非免費。實現(xiàn)層面當(dāng)傳入snapshot_id時boto 自動構(gòu)造一個BlockDeviceType(snapshot_id..., delete_on_termination...)并包入BlockDeviceMappingconnection.py最終通過ec2_build_list_params序列化為BlockDeviceMapping.N.Ebs.SnapshotId等請求參數(shù)見 blockdevicemapping.py。這為快照 → AMI → 啟動實例的鏡像生命周期流水線提供了便捷入口。Bugfixes編碼修復(fù)與其他修正v2.18.0 的缺陷修復(fù)集中在以下幾個方面詳見 發(fā)布說明HTTP 請求頭 Unicode 編碼修復(fù)修復(fù)了使用 unicode 值時 HTTP 請求頭編碼異常的問題關(guān)聯(lián) issue 1864、1839、1829、1828、702。這屬于簽名與請求構(gòu)建層的問題影響所有使用 boto 發(fā)起請求的服務(wù)Beanstalk 文檔參數(shù)順序修正調(diào)整 boto/beanstalk/layer1.py 相關(guān)文檔使其與參數(shù)聲明順序一致issue 1863S3 下載清理順序修復(fù)下載 S3 Key 時確保文件在刪除前已正確關(guān)閉issue 1791對應(yīng)實現(xiàn)可參考 boto/s3/key.py 與 keyfile.pyCloudTrail 文檔錯別字修復(fù)修正 boto/cloudtrail/layer1.py 的文檔筆誤issue 1861DynamoDBv2 教程補(bǔ)全修復(fù)教程中缺失動詞的句子issue 1859/1825相關(guān)教程見 dynamodb2_tut.rstGS 參數(shù)校驗修復(fù)修復(fù) Google Storage 連接參數(shù)校驗問題issue 1858。源碼閱讀指引如果想深入驗證本版本內(nèi)容推薦按以下路徑閱讀倉庫源碼SAML 聯(lián)合認(rèn)證boto/sts/connection.py 的assume_role_with_samlboto/iam/connection.py 的 SAML provider 五個方法以及 boto/auth.py 中對 SAML 斷言 URL 編碼的處理CloudWatch SigV4boto/ec2/cloudwatch/init.py 的_required_auth_capability與配置化端點ELB Attributesboto/ec2/elb/init.py、boto/ec2/elb/loadbalancer.py、boto/ec2/elb/attributes.pyRDSboto/rds/init.py 的promote_read_replica與modify_dbinstanceEC2 快照與鏡像boto/ec2/connection.py 的register_image與 get_all_snapshots。該版本處于 boto v2.x 系列中期與相鄰版本 v2.17.0新增 CloudTrail 與 Redshift 新特性見 v2.17.0.rst共同構(gòu)成了 2013 年末 AWS SDK 生態(tài)的能力擴(kuò)張脈絡(luò)。需要注意的是文中所有 API 語義與實現(xiàn)細(xì)節(jié)均以當(dāng)前倉庫源碼為準(zhǔn)boto v2 系列后續(xù)由 boto3 接替演進(jìn)見倉庫 README.rst 的項目說明。贊分享后端云原生【免費下載鏈接】botoFor the latest version of boto, see https://github.com/boto/boto3 -- Python interface to Amazon Web Services項目地址https://gitcode.com/gh_mirrors/bo/boto點擊查看免費下載相關(guān)推薦boto ELB負(fù)載均衡終極指南10步實現(xiàn)高可用應(yīng)用配置boto ELB負(fù)載均衡終極指南10步實現(xiàn)高可用應(yīng)用配置 想要構(gòu)建高可用的Web應(yīng)用boto ELB負(fù)載均衡服務(wù)正是您需要的解決方案 作為AWS彈性負(fù)后端云原生boto 彈性負(fù)載均衡ELB接口實戰(zhàn)指南從連接、健康檢查到實例管理boto 彈性負(fù)載均衡ELB接口實戰(zhàn)指南從連接、健康檢查到實例管理 導(dǎo)讀 本文以 boto 倉庫的官方教程 docs/source/elb_tut.rs后端云原生Proxmox VE Helper-Scripts與華為云ELB負(fù)載均衡集成Proxmox VE Helper Scripts與華為云ELB負(fù)載均衡集成 項目概述 Proxmox VE Helper Scripts 是一套簡化Prox運維虛擬化DevOps上一篇ET 框架的 Cursor 編輯器集成com.unity.ide.cursor 包安裝、源碼原理與版本演進(jìn)全解析下一篇OpenSeek-Mid-v1代碼生成實戰(zhàn)在Python、JavaScript、Java等語言中的表現(xiàn)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考