microsoft
/
developerkorea
зеркало из https://github.com/microsoft/developerkorea.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

V2 (#42)

This commit is contained in:
Justin Yoo 2023-09-13 00:14:23 +09:00 коммит произвёл GitHub
Родитель 73dac1d20a
Коммит ff685baf08
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
292 изменённых файлов: 7685 добавлений и 27933 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

481
.editorconfig
Просмотреть файл

@ -1,44 +1,465 @@
# http://editorconfig.org
# Version: 4.1.1 (Using https://semver.org/)
# Updated: 2022-05-23
# See https://github.com/RehanSaeed/EditorConfig/releases for release notes.
# See https://github.com/RehanSaeed/EditorConfig for updates to this file.
# See http://EditorConfig.org for more information about .editorconfig files.
##########################################
# Common Settings
##########################################
# This file is the top-most EditorConfig file
root = true
# All Files
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
# Use 4 spaces for the Python files
[*.py]
indent_style = space
indent_size = 4
max_line_length = 80
insert_final_newline = true
trim_trailing_whitespace = true
# The JSON files contain newlines inconsistently
[*.json]
insert_final_newline = ignore
##########################################
# File Extension Settings
##########################################
# Minified JavaScript files shouldn't be changed
[**.min.js]
indent_style = ignore
insert_final_newline = ignore
# Visual Studio Solution Files
[*.sln]
indent_style = tab
# Makefiles always use tabs for indentation
# Visual Studio XML Project Files
[*.{csproj,vbproj,vcxproj.filters,proj,projitems,shproj}]
indent_size = 2
# XML Configuration Files
[*.{xml,config,props,targets,nuspec,resx,ruleset,vsixmanifest,vsct}]
indent_size = 2
# JSON Files
[*.{json,json5,webmanifest}]
indent_size = 2
# YAML Files
[*.{yml,yaml}]
indent_size = 2
# Markdown Files
[*.{md,mdx}]
trim_trailing_whitespace = false
# Web Files
[*.{htm,html,js,jsm,ts,tsx,cjs,cts,ctsx,mjs,mts,mtsx,css,sass,scss,less,pcss,svg,vue}]
indent_size = 2
# Batch Files
[*.{cmd,bat}]
end_of_line = crlf
# Bash Files
[*.sh]
end_of_line = lf
# Makefiles
[Makefile]
indent_style = tab
# Batch files use tabs for indentation
[*.bat]
indent_style = tab
# Bicep files
[*.bicep]
indent_size = 2
[*.md]
trim_trailing_whitespace = false
##########################################
# Default .NET Code Style Severities
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/configuration-options#scope
##########################################
# C# files
[*.cs]
indent_size = 4
end_of_line = crlf
[*.{cs,csx,cake,vb,vbx}]
# Default Severity for all .NET Code Style rules below
dotnet_analyzer_diagnostic.severity = warning
# Shell scripts
[*.sh]
indent_size = 4
##########################################
# Language Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/language-rules
##########################################
# .NET Style Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/language-rules#net-style-rules
[*.{cs,csx,cake,vb,vbx}]
# "this." and "Me." qualifiers
dotnet_style_qualification_for_field = true:warning
dotnet_style_qualification_for_property = true:warning
dotnet_style_qualification_for_method = true:warning
dotnet_style_qualification_for_event = true:warning
# Language keywords instead of framework type names for type references
dotnet_style_predefined_type_for_locals_parameters_members = true:warning
dotnet_style_predefined_type_for_member_access = true:warning
# Modifier preferences
dotnet_style_require_accessibility_modifiers = always:warning
csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:warning
visual_basic_preferred_modifier_order = Partial,Default,Private,Protected,Public,Friend,NotOverridable,Overridable,MustOverride,Overloads,Overrides,MustInherit,NotInheritable,Static,Shared,Shadows,ReadOnly,WriteOnly,Dim,Const,WithEvents,Widening,Narrowing,Custom,Async:warning
dotnet_style_readonly_field = true:warning
# Parentheses preferences
dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:warning
dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:warning
dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:warning
dotnet_style_parentheses_in_other_operators = never_if_unnecessary:warning
# Expression-level preferences
dotnet_style_object_initializer = true:warning
dotnet_style_collection_initializer = true:warning
dotnet_style_explicit_tuple_names = true:warning
dotnet_style_prefer_inferred_tuple_names = true:warning
dotnet_style_prefer_inferred_anonymous_type_member_names = true:warning
dotnet_style_prefer_auto_properties = true:warning
dotnet_style_prefer_conditional_expression_over_assignment = false:suggestion
dotnet_diagnostic.IDE0045.severity = suggestion
dotnet_style_prefer_conditional_expression_over_return = false:suggestion
dotnet_diagnostic.IDE0046.severity = suggestion
dotnet_style_prefer_compound_assignment = true:warning
dotnet_style_prefer_simplified_interpolation = true:warning
dotnet_style_prefer_simplified_boolean_expressions = true:warning
# Null-checking preferences
dotnet_style_coalesce_expression = true:warning
dotnet_style_null_propagation = true:warning
dotnet_style_prefer_is_null_check_over_reference_equality_method = true:warning
# File header preferences
# file_header_template = <copyright file="{fileName}" company="PROJECT-AUTHOR">\n© PROJECT-AUTHOR\n</copyright>
# If you use StyleCop, you'll need to disable SA1636: File header copyright text should match.
# dotnet_diagnostic.SA1636.severity = none
# Undocumented
dotnet_style_operator_placement_when_wrapping = end_of_line:warning
csharp_style_prefer_null_check_over_type_check = true:warning
# C# Style Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/language-rules#c-style-rules
[*.{cs,csx,cake}]
# 'var' preferences
csharp_style_var_for_built_in_types = true:warning
csharp_style_var_when_type_is_apparent = true:warning
csharp_style_var_elsewhere = true:warning
# Expression-bodied members
csharp_style_expression_bodied_methods = true:warning
csharp_style_expression_bodied_constructors = true:warning
csharp_style_expression_bodied_operators = true:warning
csharp_style_expression_bodied_properties = true:warning
csharp_style_expression_bodied_indexers = true:warning
csharp_style_expression_bodied_accessors = true:warning
csharp_style_expression_bodied_lambdas = true:warning
csharp_style_expression_bodied_local_functions = true:warning
# Pattern matching preferences
csharp_style_pattern_matching_over_is_with_cast_check = true:warning
csharp_style_pattern_matching_over_as_with_null_check = true:warning
csharp_style_prefer_switch_expression = true:warning
csharp_style_prefer_pattern_matching = true:warning
csharp_style_prefer_not_pattern = true:warning
# Expression-level preferences
csharp_style_inlined_variable_declaration = true:warning
csharp_prefer_simple_default_expression = true:warning
csharp_style_pattern_local_over_anonymous_function = true:warning
csharp_style_deconstructed_variable_declaration = true:warning
csharp_style_prefer_index_operator = true:warning
csharp_style_prefer_range_operator = true:warning
csharp_style_implicit_object_creation_when_type_is_apparent = true:warning
# "Null" checking preferences
csharp_style_throw_expression = true:warning
csharp_style_conditional_delegate_call = true:warning
# Code block preferences
csharp_prefer_braces = true:warning
csharp_prefer_simple_using_statement = true:suggestion
dotnet_diagnostic.IDE0063.severity = suggestion
# 'using' directive preferences
# csharp_using_directive_placement = inside_namespace:warning
csharp_using_directive_placement = outside_namespace:warning
dotnet_diagnostic.IDE0065.severity = none
# Modifier preferences
csharp_prefer_static_local_function = true:warning
##########################################
# Unnecessary Code Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/unnecessary-code-rules
##########################################
# .NET Unnecessary code rules
[*.{cs,csx,cake,vb,vbx}]
dotnet_code_quality_unused_parameters = all:warning
dotnet_remove_unnecessary_suppression_exclusions = none:warning
# C# Unnecessary code rules
[*.{cs,csx,cake}]
csharp_style_unused_value_expression_statement_preference = discard_variable:suggestion
dotnet_diagnostic.IDE0058.severity = suggestion
csharp_style_unused_value_assignment_preference = discard_variable:suggestion
dotnet_diagnostic.IDE0059.severity = suggestion
##########################################
# Formatting Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules
##########################################
# .NET formatting rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#net-formatting-rules
[*.{cs,csx,cake,vb,vbx}]
# Organize using directives
dotnet_sort_system_directives_first = true
dotnet_separate_import_directive_groups = false
# Dotnet namespace options
dotnet_style_namespace_match_folder = true:suggestion
dotnet_diagnostic.IDE0130.severity = suggestion
# C# formatting rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#c-formatting-rules
[*.{cs,csx,cake}]
# Newline options
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#new-line-options
csharp_new_line_before_open_brace = all
csharp_new_line_before_else = true
csharp_new_line_before_catch = true
csharp_new_line_before_finally = true
csharp_new_line_before_members_in_object_initializers = true
csharp_new_line_before_members_in_anonymous_types = true
csharp_new_line_between_query_expression_clauses = true
# Indentation options
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#indentation-options
csharp_indent_case_contents = true
csharp_indent_switch_labels = true
csharp_indent_labels = no_change
csharp_indent_block_contents = true
csharp_indent_braces = false
csharp_indent_case_contents_when_block = false
# Spacing options
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#spacing-options
csharp_space_after_cast = false
csharp_space_after_keywords_in_control_flow_statements = true
csharp_space_between_parentheses = false
csharp_space_before_colon_in_inheritance_clause = true
csharp_space_after_colon_in_inheritance_clause = true
csharp_space_around_binary_operators = before_and_after
csharp_space_between_method_declaration_parameter_list_parentheses = false
csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
csharp_space_between_method_declaration_name_and_open_parenthesis = false
csharp_space_between_method_call_parameter_list_parentheses = false
csharp_space_between_method_call_empty_parameter_list_parentheses = false
csharp_space_between_method_call_name_and_opening_parenthesis = false
csharp_space_after_comma = true
csharp_space_before_comma = false
csharp_space_after_dot = false
csharp_space_before_dot = false
csharp_space_after_semicolon_in_for_statement = true
csharp_space_before_semicolon_in_for_statement = false
csharp_space_around_declaration_statements = false
csharp_space_before_open_square_brackets = false
csharp_space_between_empty_square_brackets = false
csharp_space_between_square_brackets = false
# Wrap options
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#wrap-options
csharp_preserve_single_line_statements = false
csharp_preserve_single_line_blocks = true
# Namespace options
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/formatting-rules#namespace-options
csharp_style_namespace_declarations = file_scoped:warning
##########################################
# .NET Naming Rules
# https://docs.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/naming-rules
##########################################
[*.{cs,csx,cake,vb,vbx}]
# ignore IDE1006: Naming Styles
dotnet_diagnostic.IDE1006.severity = none
##########################################
# Styles
##########################################
# camel_case_style - Define the camelCase style
dotnet_naming_style.camel_case_style.capitalization = camel_case
# pascal_case_style - Define the PascalCase style
dotnet_naming_style.pascal_case_style.capitalization = pascal_case
# first_upper_style - The first character must start with an upper-case character
dotnet_naming_style.first_upper_style.capitalization = first_word_upper
# prefix_interface_with_i_style - Interfaces must be PascalCase and the first character of an interface must be an 'I'
dotnet_naming_style.prefix_interface_with_i_style.capitalization = pascal_case
dotnet_naming_style.prefix_interface_with_i_style.required_prefix = I
# prefix_type_parameters_with_t_style - Generic Type Parameters must be PascalCase and the first character must be a 'T'
dotnet_naming_style.prefix_type_parameters_with_t_style.capitalization = pascal_case
dotnet_naming_style.prefix_type_parameters_with_t_style.required_prefix = T
# disallowed_style - Anything that has this style applied is marked as disallowed
dotnet_naming_style.disallowed_style.capitalization = pascal_case
dotnet_naming_style.disallowed_style.required_prefix = ____RULE_VIOLATION____
dotnet_naming_style.disallowed_style.required_suffix = ____RULE_VIOLATION____
# internal_error_style - This style should never occur... if it does, it indicates a bug in file or in the parser using the file
dotnet_naming_style.internal_error_style.capitalization = pascal_case
dotnet_naming_style.internal_error_style.required_prefix = ____INTERNAL_ERROR____
dotnet_naming_style.internal_error_style.required_suffix = ____INTERNAL_ERROR____
##########################################
# .NET Design Guideline Field Naming Rules
# Naming rules for fields follow the .NET Framework design guidelines
# https://docs.microsoft.com/dotnet/standard/design-guidelines/index
##########################################
# All public/protected/protected_internal constant fields must be PascalCase
# https://docs.microsoft.com/dotnet/standard/design-guidelines/field
dotnet_naming_symbols.public_protected_constant_fields_group.applicable_accessibilities = public, protected, protected_internal
dotnet_naming_symbols.public_protected_constant_fields_group.required_modifiers = const
dotnet_naming_symbols.public_protected_constant_fields_group.applicable_kinds = field
dotnet_naming_rule.public_protected_constant_fields_must_be_pascal_case_rule.symbols = public_protected_constant_fields_group
dotnet_naming_rule.public_protected_constant_fields_must_be_pascal_case_rule.style = pascal_case_style
dotnet_naming_rule.public_protected_constant_fields_must_be_pascal_case_rule.severity = warning
# All public/protected/protected_internal static readonly fields must be PascalCase
# https://docs.microsoft.com/dotnet/standard/design-guidelines/field
dotnet_naming_symbols.public_protected_static_readonly_fields_group.applicable_accessibilities = public, protected, protected_internal
dotnet_naming_symbols.public_protected_static_readonly_fields_group.required_modifiers = static, readonly
dotnet_naming_symbols.public_protected_static_readonly_fields_group.applicable_kinds = field
dotnet_naming_rule.public_protected_static_readonly_fields_must_be_pascal_case_rule.symbols = public_protected_static_readonly_fields_group
dotnet_naming_rule.public_protected_static_readonly_fields_must_be_pascal_case_rule.style = pascal_case_style
dotnet_naming_rule.public_protected_static_readonly_fields_must_be_pascal_case_rule.severity = warning
# No other public/protected/protected_internal fields are allowed
# https://docs.microsoft.com/dotnet/standard/design-guidelines/field
dotnet_naming_symbols.other_public_protected_fields_group.applicable_accessibilities = public, protected, protected_internal
dotnet_naming_symbols.other_public_protected_fields_group.applicable_kinds = field
dotnet_naming_rule.other_public_protected_fields_disallowed_rule.symbols = other_public_protected_fields_group
dotnet_naming_rule.other_public_protected_fields_disallowed_rule.style = disallowed_style
dotnet_naming_rule.other_public_protected_fields_disallowed_rule.severity = error
##########################################
# StyleCop Field Naming Rules
# Naming rules for fields follow the StyleCop analyzers
# This does not override any rules using disallowed_style above
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers
##########################################
# All constant fields must be PascalCase
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1303.md
dotnet_naming_symbols.stylecop_constant_fields_group.applicable_accessibilities = public, internal, protected_internal, protected, private_protected, private
dotnet_naming_symbols.stylecop_constant_fields_group.required_modifiers = const
dotnet_naming_symbols.stylecop_constant_fields_group.applicable_kinds = field
dotnet_naming_rule.stylecop_constant_fields_must_be_pascal_case_rule.symbols = stylecop_constant_fields_group
dotnet_naming_rule.stylecop_constant_fields_must_be_pascal_case_rule.style = pascal_case_style
dotnet_naming_rule.stylecop_constant_fields_must_be_pascal_case_rule.severity = warning
# All static readonly fields must be PascalCase
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1311.md
dotnet_naming_symbols.stylecop_static_readonly_fields_group.applicable_accessibilities = public, internal, protected_internal, protected, private_protected, private
dotnet_naming_symbols.stylecop_static_readonly_fields_group.required_modifiers = static, readonly
dotnet_naming_symbols.stylecop_static_readonly_fields_group.applicable_kinds = field
dotnet_naming_rule.stylecop_static_readonly_fields_must_be_pascal_case_rule.symbols = stylecop_static_readonly_fields_group
dotnet_naming_rule.stylecop_static_readonly_fields_must_be_pascal_case_rule.style = pascal_case_style
dotnet_naming_rule.stylecop_static_readonly_fields_must_be_pascal_case_rule.severity = warning
# No non-private instance fields are allowed
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1401.md
dotnet_naming_symbols.stylecop_fields_must_be_private_group.applicable_accessibilities = public, internal, protected_internal, protected, private_protected
dotnet_naming_symbols.stylecop_fields_must_be_private_group.applicable_kinds = field
dotnet_naming_rule.stylecop_instance_fields_must_be_private_rule.symbols = stylecop_fields_must_be_private_group
dotnet_naming_rule.stylecop_instance_fields_must_be_private_rule.style = disallowed_style
dotnet_naming_rule.stylecop_instance_fields_must_be_private_rule.severity = error
# Private fields must be camelCase
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1306.md
dotnet_naming_symbols.stylecop_private_fields_group.applicable_accessibilities = private
dotnet_naming_symbols.stylecop_private_fields_group.applicable_kinds = field
dotnet_naming_rule.stylecop_private_fields_must_be_camel_case_rule.symbols = stylecop_private_fields_group
dotnet_naming_rule.stylecop_private_fields_must_be_camel_case_rule.style = camel_case_style
dotnet_naming_rule.stylecop_private_fields_must_be_camel_case_rule.severity = warning
# Local variables must be camelCase
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1312.md
dotnet_naming_symbols.stylecop_local_fields_group.applicable_accessibilities = local
dotnet_naming_symbols.stylecop_local_fields_group.applicable_kinds = local
dotnet_naming_rule.stylecop_local_fields_must_be_camel_case_rule.symbols = stylecop_local_fields_group
dotnet_naming_rule.stylecop_local_fields_must_be_camel_case_rule.style = camel_case_style
dotnet_naming_rule.stylecop_local_fields_must_be_camel_case_rule.severity = silent
# This rule should never fire. However, it's included for at least two purposes:
# First, it helps to understand, reason about, and root-case certain types of issues, such as bugs in .editorconfig parsers.
# Second, it helps to raise immediate awareness if a new field type is added (as occurred recently in C#).
dotnet_naming_symbols.sanity_check_uncovered_field_case_group.applicable_accessibilities = *
dotnet_naming_symbols.sanity_check_uncovered_field_case_group.applicable_kinds = field
dotnet_naming_rule.sanity_check_uncovered_field_case_rule.symbols = sanity_check_uncovered_field_case_group
dotnet_naming_rule.sanity_check_uncovered_field_case_rule.style = internal_error_style
dotnet_naming_rule.sanity_check_uncovered_field_case_rule.severity = error
##########################################
# Other Naming Rules
##########################################
# All of the following must be PascalCase:
# - Namespaces
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-namespaces
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1300.md
# - Classes and Enumerations
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-classes-structs-and-interfaces
# https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/documentation/SA1300.md
# - Delegates
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-classes-structs-and-interfaces#names-of-common-types
# - Constructors, Properties, Events, Methods
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-type-members
dotnet_naming_symbols.element_group.applicable_kinds = namespace, class, enum, struct, delegate, event, method, property
dotnet_naming_rule.element_rule.symbols = element_group
dotnet_naming_rule.element_rule.style = pascal_case_style
dotnet_naming_rule.element_rule.severity = warning
# Interfaces use PascalCase and are prefixed with uppercase 'I'
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-classes-structs-and-interfaces
dotnet_naming_symbols.interface_group.applicable_kinds = interface
dotnet_naming_rule.interface_rule.symbols = interface_group
dotnet_naming_rule.interface_rule.style = prefix_interface_with_i_style
dotnet_naming_rule.interface_rule.severity = warning
# Generics Type Parameters use PascalCase and are prefixed with uppercase 'T'
# https://docs.microsoft.com/dotnet/standard/design-guidelines/names-of-classes-structs-and-interfaces
dotnet_naming_symbols.type_parameter_group.applicable_kinds = type_parameter
dotnet_naming_rule.type_parameter_rule.symbols = type_parameter_group
dotnet_naming_rule.type_parameter_rule.style = prefix_type_parameters_with_t_style
dotnet_naming_rule.type_parameter_rule.severity = warning
# Function parameters use camelCase
# https://docs.microsoft.com/dotnet/standard/design-guidelines/naming-parameters
dotnet_naming_symbols.parameters_group.applicable_kinds = parameter
dotnet_naming_rule.parameters_rule.symbols = parameters_group
dotnet_naming_rule.parameters_rule.style = camel_case_style
dotnet_naming_rule.parameters_rule.severity = warning
##########################################
# Compiler Rules
##########################################
# .NET compiler messages
dotnet_diagnostic.CS8634.severity = none
##########################################
# License
##########################################
# The following applies as to the .editorconfig file ONLY, and is
# included below for reference, per the requirements of the license
# corresponding to this .editorconfig file.
# See: https://github.com/RehanSaeed/EditorConfig
#
# MIT License
#
# Copyright (c) 2017-2019 Muhammad Rehan Saeed
# Copyright (c) 2019 Henry Gabryjelski
#
# Permission is hereby granted, free of charge, to any
# person obtaining a copy of this software and associated
# documentation files (the "Software"), to deal in the
# Software without restriction, including without limitation
# the rights to use, copy, modify, merge, publish, distribute,
# sublicense, and/or sell copies of the Software, and to permit
# persons to whom the Software is furnished to do so, subject
# to the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
# OTHER DEALINGS IN THE SOFTWARE.
##########################################

103
.github/workflows/dispatch.yaml.bak поставляемый
Просмотреть файл

@ -1,103 +0,0 @@
name: Repository Dispatch
on: repository_dispatch
jobs:
merge_pr:
name: Merge PR
if: github.event.action == 'merge-pr'
runs-on: ubuntu-latest
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
- name: Merge PR
uses: justinyoo/github-pr-merge-action@v0.8.0
with:
authToken: ${{ secrets.GITHUB_TOKEN }}
owner: ${{ github.event.client_payload.owner }}
repository: ${{ github.event.client_payload.repository }}
issueId: '${{ github.event.client_payload.issueId }}'
mergeMethod: Squash
commitTitle: ''
commitDescription: ''
deleteBranch: 'true'
- name: Send dispatch event for publish
shell: bash
run: |
curl -X POST 'https://${{ secrets.AZURE_FUNCTIONS_NAME }}.azurewebsites.net/api/events/publish' -d '{ "owner": "microsoft", "repository": "developerkorea" }' -H "x-functions-key: ${{ secrets.AZURE_FUNCTIONS_KEY }}" -H "Content-Type: application/json"
build_and_publish:
name: Build and publish
if: github.event.action == 'publish'
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v2
with:
persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal token
fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
- name: Setup node.js SDK
uses: actions/setup-node@v2
with:
node-version: '12'
- name: Clone theme
shell: bash
run: |
git clone https://github.com/devrel-kr/gridsome-starter-liebling.git blog
- name: Copy files to overwrite
shell: bash
run: |
rm -rf ./blog/src/assets/images
cp -R ./overwrites/. ./blog
- name: Copy contents
shell: bash
run: |
rm -rf ./blog/content
cp -R ./content/. ./blog/content
- name: Clear artifacts
shell: bash
run: |
rm -rf ./docs
- name: Install npm packages
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
npm install
- name: Build app
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
npm run build
- name: Copy artifacts
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
cp -R ./dist/. ../docs
rm ../docs/README.md
- name: Publish artifacts
shell: bash
run: |
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add ./docs/\* --force
git commit -m "Publish: ${{ github.event.head_commit.message }}"
- name: Push artifacts
uses: ad-m/github-push-action@master
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
branch: ${{ github.ref }}

94
.github/workflows/main.yaml поставляемый Normal file
Просмотреть файл

@ -0,0 +1,94 @@
name: Deploy static content to Pages
on:
workflow_dispatch:
push:
branches:
- main
- v2
- 'feature/**'
pull_request:
branches:
- main
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: "pages"
cancel-in-progress: true
jobs:
build-test:
name: Build Test
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v3
- name: Setup .NET SDK
uses: actions/setup-dotnet@v3
with:
dotnet-version: 8.x
dotnet-quality: preview
- name: Restore NuGet packages
shell: bash
run: |
dotnet restore
- name: Build solution
shell: bash
run: |
dotnet build -c Release
- name: Test solution
shell: bash
run: |
dotnet test -c Release
- name: Update database - Light up Azure
shell: bash
run: |
pushd src/DeveloperKorea.ConsoleApp
dotnet run -c Release -- \
--api-key ${{ secrets.GOOGLE_API_KEY }} \
--channel-id ${{ secrets.YOUTUBE_CHANNEL_ID }} \
--playlist-name "Light up Azure" \
--output-path ${{ github.workspace }}/src/DeveloperKorea.WebApp/wwwroot/data/light-up-azure.json \
--greetings "Well generated!"
popd
- name: Publish artifact
if: (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && github.ref_name == 'main'
shell: bash
run: |
dotnet publish -c Release
- name: Upload artifact
if: (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && github.ref_name == 'main'
uses: actions/upload-pages-artifact@v1
with:
path: artifacts/publish/DeveloperKorea.WebApp/release/wwwroot
deploy:
name: Deploy to Pages
if: (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && github.ref_name == 'main'
needs:
- build-test
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v1

80
.github/workflows/main.yaml.bak поставляемый
Просмотреть файл

@ -1,80 +0,0 @@
name: Build and Publish Static Website to GH Pages
on:
push:
branches:
- main
jobs:
build_and_publish:
name: Build and publish
if: github.repository_owner == 'microsoft' && github.ref == 'refs/heads/main'
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v2
with:
persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal token
fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
- name: Setup node.js SDK
uses: actions/setup-node@v2
with:
node-version: '12'
- name: Clone theme
shell: bash
run: |
git clone https://github.com/devrel-kr/gridsome-starter-liebling.git blog
- name: Copy files to overwrite
shell: bash
run: |
rm -rf ./blog/src/assets/images
cp -R ./overwrites/. ./blog
- name: Copy contents
shell: bash
run: |
rm -rf ./blog/content
cp -R ./content/. ./blog/content
- name: Clear artifacts
shell: bash
run: |
rm -rf ./docs
- name: Install npm packages
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
npm install
- name: Build app
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
npm run build
- name: Copy artifacts
shell: bash
run: |
cd $GITHUB_WORKSPACE/blog
cp -R ./dist/. ../docs
rm ../docs/README.md
- name: Publish artifacts
shell: bash
run: |
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add ./docs/\* --force
git commit -m "Publish: ${{ github.event.head_commit.message }}"
- name: Push artifacts
uses: ad-m/github-push-action@master
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
branch: ${{ github.ref }}

71
.github/workflows/pr.yaml.bak поставляемый
Просмотреть файл

@ -1,71 +0,0 @@
name: Pull Request
on:
pull_request:
branches:
- main
types:
- opened
# - edited
# - synchronize
jobs:
schedule_publish:
name: Schedule publish
runs-on: ubuntu-latest
steps:
# - name: Check event payload
# shell: bash
# run: |
# echo ${{ toJSON(github.event) }}
- name: Check PR title
id: prtitle
shell: bash
run: |
echo "value=$(echo ${{ github.event.pull_request.title }})" >> $GITHUB_OUTPUT
- name: Check PR body
id: prbody
shell: bash
run: |
echo "value=$(echo ${{ toJSON(github.event.pull_request.body) }})" >> $GITHUB_OUTPUT
- name: Check PR values
shell: bash
run: |
echo "Title: ${{ steps.prtitle.outputs.value }}"
echo "Body: ${{ steps.prbody.outputs.value }}"
- name: Extract frontmatter from PR body
if: startsWith(steps.prtitle.outputs.value, '새 포스트:') || startsWith(steps.prtitle.outputs.value, '새포스트:')
id: frontmatter
uses: aliencube/frontmatter-to-json-actions@v1
with:
markdown: '${{ toJSON(steps.prbody.outputs.value) }}'
- name: Get publish schedule
if: startsWith(steps.prtitle.outputs.value, '새 포스트:') || startsWith(steps.prtitle.outputs.value, '새포스트:')
id: schedule
shell: bash
run: |
schedule=$(TZ=Asia/Seoul date --date $(echo ${{ toJSON(steps.frontmatter.outputs.jsonised) }} | jq -r ".schedule") --iso-8601=s)
echo "value=$schedule" >> $GITHUB_OUTPUT
# - name: Get owner and repository
# uses: jungwinter/split@v1
# id: split
# with:
# msg: ${{ github.event.repository.full_name) }}
# separator: '/'
- name: Schedule publish
if: startsWith(steps.prtitle.outputs.value, '새 포스트:') || startsWith(steps.prtitle.outputs.value, '새포스트:')
shell: bash
run: |
curl -X POST 'https://${{ secrets.AZURE_FUNCTIONS_NAME }}.azurewebsites.net/api/orchestrators/schedule-event' \
-H "x-functions-key: ${{ secrets.AZURE_FUNCTIONS_KEY }}" \
-H "Content-Type: application/json" \
-d '{ "owner": "microsoft", "repository": "developerkorea", "issueId": ${{ github.event.pull_request.number }}, "schedule": "${{ steps.schedule.outputs.value }}" }} }'

44
DeveloperKorea.sln Normal file
Просмотреть файл

@ -0,0 +1,44 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.0.31903.59
MinimumVisualStudioVersion = 10.0.40219.1
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{71477364-801C-41FD-9E93-DA56F1EE6B58}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DeveloperKorea.ConsoleApp", "src\DeveloperKorea.ConsoleApp\DeveloperKorea.ConsoleApp.csproj", "{5CC35165-5E2D-4605-9516-E0E55EA8B586}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DeveloperKorea.WebApp", "src\DeveloperKorea.WebApp\DeveloperKorea.WebApp.csproj", "{87B75002-B214-44B9-B4F1-F71BAA1BDE08}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DeveloperKorea.Models", "src\DeveloperKorea.Models\DeveloperKorea.Models.csproj", "{D82CD246-C408-4F3E-BA2A-4CDC4CD21071}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{5CC35165-5E2D-4605-9516-E0E55EA8B586}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{5CC35165-5E2D-4605-9516-E0E55EA8B586}.Debug|Any CPU.Build.0 = Debug|Any CPU
{5CC35165-5E2D-4605-9516-E0E55EA8B586}.Release|Any CPU.ActiveCfg = Release|Any CPU
{5CC35165-5E2D-4605-9516-E0E55EA8B586}.Release|Any CPU.Build.0 = Release|Any CPU
{87B75002-B214-44B9-B4F1-F71BAA1BDE08}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{87B75002-B214-44B9-B4F1-F71BAA1BDE08}.Debug|Any CPU.Build.0 = Debug|Any CPU
{87B75002-B214-44B9-B4F1-F71BAA1BDE08}.Release|Any CPU.ActiveCfg = Release|Any CPU
{87B75002-B214-44B9-B4F1-F71BAA1BDE08}.Release|Any CPU.Build.0 = Release|Any CPU
{D82CD246-C408-4F3E-BA2A-4CDC4CD21071}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{D82CD246-C408-4F3E-BA2A-4CDC4CD21071}.Debug|Any CPU.Build.0 = Debug|Any CPU
{D82CD246-C408-4F3E-BA2A-4CDC4CD21071}.Release|Any CPU.ActiveCfg = Release|Any CPU
{D82CD246-C408-4F3E-BA2A-4CDC4CD21071}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(NestedProjects) = preSolution
{5CC35165-5E2D-4605-9516-E0E55EA8B586} = {71477364-801C-41FD-9E93-DA56F1EE6B58}
{87B75002-B214-44B9-B4F1-F71BAA1BDE08} = {71477364-801C-41FD-9E93-DA56F1EE6B58}
{D82CD246-C408-4F3E-BA2A-4CDC4CD21071} = {71477364-801C-41FD-9E93-DA56F1EE6B58}
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {54149DEC-9C80-4AED-8BC1-580043943F15}
EndGlobalSection
EndGlobal

11
Directory.Build.props Normal file
Просмотреть файл

@ -0,0 +1,11 @@
<Project>
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<LangVersion>latest</LangVersion>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<ArtifactsPath>$(MSBuildThisFileDirectory)artifacts</ArtifactsPath>
</PropertyGroup>
</Project>

412
LICENSE
Просмотреть файл

@ -1,395 +1,17 @@
Attribution 4.0 International
=======================================================================
Creative Commons Corporation ("Creative Commons") is not a law firm and
does not provide legal services or legal advice. Distribution of
Creative Commons public licenses does not create a lawyer-client or
other relationship. Creative Commons makes its licenses and related
information available on an "as-is" basis. Creative Commons gives no
warranties regarding its licenses, any material licensed under their
terms and conditions, or any related information. Creative Commons
disclaims all liability for damages resulting from their use to the
fullest extent possible.
Using Creative Commons Public Licenses
Creative Commons public licenses provide a standard set of terms and
conditions that creators and other rights holders may use to share
original works of authorship and other material subject to copyright
and certain other rights specified in the public license below. The
following considerations are for informational purposes only, are not
exhaustive, and do not form part of our licenses.
Considerations for licensors: Our public licenses are
intended for use by those authorized to give the public
permission to use material in ways otherwise restricted by
copyright and certain other rights. Our licenses are
irrevocable. Licensors should read and understand the terms
and conditions of the license they choose before applying it.
Licensors should also secure all rights necessary before
applying our licenses so that the public can reuse the
material as expected. Licensors should clearly mark any
material not subject to the license. This includes other CC-
licensed material, or material used under an exception or
limitation to copyright. More considerations for licensors:
wiki.creativecommons.org/Considerations_for_licensors
Considerations for the public: By using one of our public
licenses, a licensor grants the public permission to use the
licensed material under specified terms and conditions. If
the licensor's permission is not necessary for any reason--for
example, because of any applicable exception or limitation to
copyright--then that use is not regulated by the license. Our
licenses grant only permissions under copyright and certain
other rights that a licensor has authority to grant. Use of
the licensed material may still be restricted for other
reasons, including because others have copyright or other
rights in the material. A licensor may make special requests,
such as asking that all changes be marked or described.
Although not required by our licenses, you are encouraged to
respect those requests where reasonable. More_considerations
for the public:
wiki.creativecommons.org/Considerations_for_licensees
=======================================================================
Creative Commons Attribution 4.0 International Public License
By exercising the Licensed Rights (defined below), You accept and agree
to be bound by the terms and conditions of this Creative Commons
Attribution 4.0 International Public License ("Public License"). To the
extent this Public License may be interpreted as a contract, You are
granted the Licensed Rights in consideration of Your acceptance of
these terms and conditions, and the Licensor grants You such rights in
consideration of benefits the Licensor receives from making the
Licensed Material available under these terms and conditions.
Section 1 -- Definitions.
a. Adapted Material means material subject to Copyright and Similar
Rights that is derived from or based upon the Licensed Material
and in which the Licensed Material is translated, altered,
arranged, transformed, or otherwise modified in a manner requiring
permission under the Copyright and Similar Rights held by the
Licensor. For purposes of this Public License, where the Licensed
Material is a musical work, performance, or sound recording,
Adapted Material is always produced where the Licensed Material is
synched in timed relation with a moving image.
b. Adapter's License means the license You apply to Your Copyright
and Similar Rights in Your contributions to Adapted Material in
accordance with the terms and conditions of this Public License.
c. Copyright and Similar Rights means copyright and/or similar rights
closely related to copyright including, without limitation,
performance, broadcast, sound recording, and Sui Generis Database
Rights, without regard to how the rights are labeled or
categorized. For purposes of this Public License, the rights
specified in Section 2(b)(1)-(2) are not Copyright and Similar
Rights.
d. Effective Technological Measures means those measures that, in the
absence of proper authority, may not be circumvented under laws
fulfilling obligations under Article 11 of the WIPO Copyright
Treaty adopted on December 20, 1996, and/or similar international
agreements.
e. Exceptions and Limitations means fair use, fair dealing, and/or
any other exception or limitation to Copyright and Similar Rights
that applies to Your use of the Licensed Material.
f. Licensed Material means the artistic or literary work, database,
or other material to which the Licensor applied this Public
License.
g. Licensed Rights means the rights granted to You subject to the
terms and conditions of this Public License, which are limited to
all Copyright and Similar Rights that apply to Your use of the
Licensed Material and that the Licensor has authority to license.
h. Licensor means the individual(s) or entity(ies) granting rights
under this Public License.
i. Share means to provide material to the public by any means or
process that requires permission under the Licensed Rights, such
as reproduction, public display, public performance, distribution,
dissemination, communication, or importation, and to make material
available to the public including in ways that members of the
public may access the material from a place and at a time
individually chosen by them.
j. Sui Generis Database Rights means rights other than copyright
resulting from Directive 96/9/EC of the European Parliament and of
the Council of 11 March 1996 on the legal protection of databases,
as amended and/or succeeded, as well as other essentially
equivalent rights anywhere in the world.
k. You means the individual or entity exercising the Licensed Rights
under this Public License. Your has a corresponding meaning.
Section 2 -- Scope.
a. License grant.
1. Subject to the terms and conditions of this Public License,
the Licensor hereby grants You a worldwide, royalty-free,
non-sublicensable, non-exclusive, irrevocable license to
exercise the Licensed Rights in the Licensed Material to:
a. reproduce and Share the Licensed Material, in whole or
in part; and
b. produce, reproduce, and Share Adapted Material.
2. Exceptions and Limitations. For the avoidance of doubt, where
Exceptions and Limitations apply to Your use, this Public
License does not apply, and You do not need to comply with
its terms and conditions.
3. Term. The term of this Public License is specified in Section
6(a).
4. Media and formats; technical modifications allowed. The
Licensor authorizes You to exercise the Licensed Rights in
all media and formats whether now known or hereafter created,
and to make technical modifications necessary to do so. The
Licensor waives and/or agrees not to assert any right or
authority to forbid You from making technical modifications
necessary to exercise the Licensed Rights, including
technical modifications necessary to circumvent Effective
Technological Measures. For purposes of this Public License,
simply making modifications authorized by this Section 2(a)
(4) never produces Adapted Material.
5. Downstream recipients.
a. Offer from the Licensor -- Licensed Material. Every
recipient of the Licensed Material automatically
receives an offer from the Licensor to exercise the
Licensed Rights under the terms and conditions of this
Public License.
b. No downstream restrictions. You may not offer or impose
any additional or different terms or conditions on, or
apply any Effective Technological Measures to, the
Licensed Material if doing so restricts exercise of the
Licensed Rights by any recipient of the Licensed
Material.
6. No endorsement. Nothing in this Public License constitutes or
may be construed as permission to assert or imply that You
are, or that Your use of the Licensed Material is, connected
with, or sponsored, endorsed, or granted official status by,
the Licensor or others designated to receive attribution as
provided in Section 3(a)(1)(A)(i).
b. Other rights.
1. Moral rights, such as the right of integrity, are not
licensed under this Public License, nor are publicity,
privacy, and/or other similar personality rights; however, to
the extent possible, the Licensor waives and/or agrees not to
assert any such rights held by the Licensor to the limited
extent necessary to allow You to exercise the Licensed
Rights, but not otherwise.
2. Patent and trademark rights are not licensed under this
Public License.
3. To the extent possible, the Licensor waives any right to
collect royalties from You for the exercise of the Licensed
Rights, whether directly or through a collecting society
under any voluntary or waivable statutory or compulsory
licensing scheme. In all other cases the Licensor expressly
reserves any right to collect such royalties.
Section 3 -- License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the
following conditions.
a. Attribution.
1. If You Share the Licensed Material (including in modified
form), You must:
a. retain the following if it is supplied by the Licensor
with the Licensed Material:
i. identification of the creator(s) of the Licensed
Material and any others designated to receive
attribution, in any reasonable manner requested by
the Licensor (including by pseudonym if
designated);
ii. a copyright notice;
iii. a notice that refers to this Public License;
iv. a notice that refers to the disclaimer of
warranties;
v. a URI or hyperlink to the Licensed Material to the
extent reasonably practicable;
b. indicate if You modified the Licensed Material and
retain an indication of any previous modifications; and
c. indicate the Licensed Material is licensed under this
Public License, and include the text of, or the URI or
hyperlink to, this Public License.
2. You may satisfy the conditions in Section 3(a)(1) in any
reasonable manner based on the medium, means, and context in
which You Share the Licensed Material. For example, it may be
reasonable to satisfy the conditions by providing a URI or
hyperlink to a resource that includes the required
information.
3. If requested by the Licensor, You must remove any of the
information required by Section 3(a)(1)(A) to the extent
reasonably practicable.
4. If You Share Adapted Material You produce, the Adapter's
License You apply must not prevent recipients of the Adapted
Material from complying with this Public License.
Section 4 -- Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that
apply to Your use of the Licensed Material:
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
to extract, reuse, reproduce, and Share all or a substantial
portion of the contents of the database;
b. if You include all or a substantial portion of the database
contents in a database in which You have Sui Generis Database
Rights, then the database in which You have Sui Generis Database
Rights (but not its individual contents) is Adapted Material; and
c. You must comply with the conditions in Section 3(a) if You Share
all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not
replace Your obligations under this Public License where the Licensed
Rights include other Copyright and Similar Rights.
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
c. The disclaimer of warranties and limitation of liability provided
above shall be interpreted in a manner that, to the extent
possible, most closely approximates an absolute disclaimer and
waiver of all liability.
Section 6 -- Term and Termination.
a. This Public License applies for the term of the Copyright and
Similar Rights licensed here. However, if You fail to comply with
this Public License, then Your rights under this Public License
terminate automatically.
b. Where Your right to use the Licensed Material has terminated under
Section 6(a), it reinstates:
1. automatically as of the date the violation is cured, provided
it is cured within 30 days of Your discovery of the
violation; or
2. upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any
right the Licensor may have to seek remedies for Your violations
of this Public License.
c. For the avoidance of doubt, the Licensor may also offer the
Licensed Material under separate terms or conditions or stop
distributing the Licensed Material at any time; however, doing so
will not terminate this Public License.
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
License.
Section 7 -- Other Terms and Conditions.
a. The Licensor shall not be bound by any additional or different
terms or conditions communicated by You unless expressly agreed.
b. Any arrangements, understandings, or agreements regarding the
Licensed Material not stated herein are separate from and
independent of the terms and conditions of this Public License.
Section 8 -- Interpretation.
a. For the avoidance of doubt, this Public License does not, and
shall not be interpreted to, reduce, limit, restrict, or impose
conditions on any use of the Licensed Material that could lawfully
be made without permission under this Public License.
b. To the extent possible, if any provision of this Public License is
deemed unenforceable, it shall be automatically reformed to the
minimum extent necessary to make it enforceable. If the provision
cannot be reformed, it shall be severed from this Public License
without affecting the enforceability of the remaining terms and
conditions.
c. No term or condition of this Public License will be waived and no
failure to comply consented to unless expressly agreed to by the
Licensor.
d. Nothing in this Public License constitutes or may be interpreted
as a limitation upon, or waiver of, any privileges and immunities
that apply to the Licensor or You, including from the legal
processes of any jurisdiction or authority.
=======================================================================
Creative Commons is not a party to its public
licenses. Notwithstanding, Creative Commons may elect to apply one of
its public licenses to material it publishes and in those instances
will be considered the “Licensor.” The text of the Creative Commons
public licenses is dedicated to the public domain under the CC0 Public
Domain Dedication. Except for the limited purpose of indicating that
material is shared under a Creative Commons public license or as
otherwise permitted by the Creative Commons policies published at
creativecommons.org/policies, Creative Commons does not authorize the
use of the trademark "Creative Commons" or any other trademark or logo
of Creative Commons without its prior written consent including,
without limitation, in connection with any unauthorized modifications
to any of its public licenses or any other arrangements,
understandings, or agreements concerning use of licensed material. For
the avoidance of doubt, this paragraph does not form part of the
public licenses.
Creative Commons may be contacted at creativecommons.org.
The MIT License (MIT)
Copyright (c) Microsoft Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

32
LICENSE-CODE
Просмотреть файл

@ -1,17 +1,17 @@
The MIT License (MIT)
Copyright (c) Microsoft Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
The MIT License (MIT)
Copyright (c) Microsoft Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Двоичные данные
content/authors/covers/devrel-kr.png
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 558 KiB

Двоичные данные
content/authors/covers/ian-choi.jpg
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 659 KiB

Двоичные данные
content/authors/covers/justin-yoo.jpg
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 2.5 MiB

13
content/authors/devrel-kr.md
Просмотреть файл

@ -1,13 +0,0 @@
---
id: devrel-kr
slug: devrel-kr
name: DevRel Korea @ Microsoft
bio: 마이크로소프트 디벨로퍼 릴레이션
cover: ./covers/devrel-kr.png
image: ./images/devrel-kr.png
github: https://github.com/microsoft/developerkorea
linkedin: https://linkedin.com/showcase/microsoft-developers/
twitter: https://twitter.com/microsofttechKR
facebook: https://www.facebook.com/MicrosoftDeveloper.Korea
instagram: https://www.instagram.com/microsoftdeveloper/
---

12
content/authors/ian-choi.md
Просмотреть файл

@ -1,12 +0,0 @@
---
id: ian-choi
slug: ian-choi
name: Ian Choi
bio: 마이크로소프트 Dev PMM | 오픈소스 번역/컨트리뷰터 | 애저와 모든 개발 | 개발자 커뮤니티 활동중
cover: ./covers/ian-choi.jpg
image: ./images/ian-choi.jpg
github: https://github.com/ianychoi
linkedin: https://linkedin.com/in/ianychoi
twitter: https://twitter.com/ianychoi
facebook: https://facebook.com/ianychoi
---

Двоичные данные
content/authors/images/devrel-kr.png
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 70 KiB

Двоичные данные
content/authors/images/ian-choi.jpg
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 91 KiB

Двоичные данные
content/authors/images/justin-yoo.png
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 246 KiB

12
content/authors/justin-yoo.md
Просмотреть файл

@ -1,12 +0,0 @@
---
id: justin-yoo
slug: justin-yoo
name: 유저스틴
bio: 마이크로소프트 클라우드 🥑 | 서버리스 덕후 | DevOps/SRE | 엔터프라이즈 통합 솔루션
cover: ./covers/justin-yoo.jpg
image: ./images/justin-yoo.png
github: https://github.com/justinyoo
linkedin: https://linked.in.com/in/justinyoo
twitter: https://twitter.com/justinchronicle
facebook: https://facebook.com/aliencube.community
---

338
content/pages/getting-started.md
Просмотреть файл

@ -1,338 +0,0 @@
---
title: 시작하기
slug: getting-started
---
이 페이지는 블로그를 마크다운 형식으로 작성할 때 필요한 메타데이터 삽입 요령과, 마크다운 문법, 그리고 유튜브 비디오 혹은 gist 코드 블록과 같은 외부 미디어 삽입 방법에 대해 알려줍니다.
## 목차 ##
> - [목차](#목차)
> - [글쓴이 생성](#글쓴이-생성)
> - [글쓴이용 프론트매터](#글쓴이용-프론트매터)
> - [포스트 생성](#포스트-생성)
> - [포스트 프론트매터](#포스트-프론트매터)
> - [헤딩 Headings](#헤딩-headings)
> - [일반 텍스트 Normal Text](#일반-텍스트-normal-text)
> - [한글 Korean](#한글-korean)
> - [영문 English](#영문-english)
> - [인용문 Blockquotes](#인용문-blockquotes)
> - [리스트 Lists](#리스트-lists)
> - [Ordered List](#ordered-list)
> - [Unordered List](#unordered-list)
> - [테이블 Tables](#테이블-tables)
> - [코드 블록 Codeblocks](#코드-블록-codeblocks)
> - [인라인 코드 Inline Code](#인라인-코드-inline-code)
> - [코드 블록 Codeblock](#코드-블록-codeblock)
> - [이미지 Images](#이미지-images)
> - [외부 이미지](#외부-이미지)
> - [내부 이미지](#내부-이미지)
> - [단축 코드](#단축-코드)
> - [깃헙 Gist](#깃헙-gist)
> - [Gist 전체 공유](#gist-전체-공유)
> - [Gist 내 특정 파일 공유](#gist-내-특정-파일-공유)
> - [Gist 내 특정 파일의 특정 라인 하이라이트](#gist-내-특정-파일의-특정-라인-하이라이트)
> - [유튜브 YouTube](#유튜브-youtube)
> - [트위터 Twitter](#트위터-twitter)
## 글쓴이 생성 ##
모든 포스트는 기본적으로 글 작성자를 포함해야 합니다.
* 파일 이름: `<first-name>-<last-name>.md`
* 파일 위치: `content/authors`
* 커퍼 파일 이름: `<first-name>-<last-name>.(jpg|png)` 최소 `2000x1000`px 사이즈 이상
* 커버 파일 위치: `content/authors/covers`
* 프사 파일 이름: `<first-name>-<last-name>.(jpg|png)` 최소 `500x500`px 사이즈 이상
* 프사 파일 위치: `content/authors/images`
### 글쓴이용 프론트매터 ###
글쓴이 정보를 아래와 같이 프론트매터 형식으로 작성합니다.
```yaml
---
id: (필수) gildong-hong
slug: (필수) gildong-hong
name: (필수) 홍길동
bio: (필수) 글쓴이에 대한 간략한 소개
cover: (필수) ./covers/gildong-hong.png (외부 URL, 내부 URL 모두 허용)
image: (필수) ./images/gildong-hong.png (외부 URL, 내부 URL 모두 허용)
github: (선택) https://github.com
linkedin: (선택) https://www.linkedin.com
twitter: (선택) https://www.twitter.com
facebook: (선택) https://www.facebook.com
instagram: (선택) https://instagram.com
---
```
## 포스트 생성 ##
* 파일 이름: `<yyyy>-<MM>-<dd>-<slug>.md`
* 파일 위치: `content/posts/<year>-<MM>`
### 포스트 프론트매터 ###
프론트매터는 모든 포스트의 맨 첫머리에 포스트의 기본적인 메타데이터를 정의하는 부분입니다. 아래와 같은 형식으로 작성합니다.
```yaml
---
title: (필수) 블로그 포스트 제목
slug: (필수) post-url
description: (필수) 포스트 간략 설명
date: (필수) 2021-01-01
image: (선택) 히어로 이미지 URL (외부 URL만 허용)
image_caption: (선택) 히어로 이미지 캡션
author: (필수) author-id
category: (필수) Microsoft Azure, Microsoft 365, Power Platform 셋 중 하나 선택
tags: (필수) tag1, tag2
canonical_url: (선택) 원본 포스트가 있을 경우 원본 포스트 URL
featured: true (관리자가 지정)
---
```
## 헤딩 Headings ##
```html
# Heading 1 #
## Heading 2 ##
### Heading 3 ###
#### Heading 4 ####
##### Heading 5 #####
###### Heading 6 ######
```
## 일반 텍스트 Normal Text ##
### 한글 Korean ###
하나 새워 없이 이웃 별 있습니다. 나는 비둘기, 파란 패, 있습니다. 시인의 시와 파란 불러 봅니다. 시와 했던 무덤 아무 어머님, 패, 별 내 묻힌 계십니다. 이런 이름자 가슴속에 하나의 하나에 이름과, 어머니, 있습니다. 책상을 오면 하나 내 그러나 거외다. 멀리 헤일 가을 까닭이요, 이름과, 했던 별 무덤 그리워 거외다. 아스라히 가난한 이름을 있습니다. 쓸쓸함과 한 때 마리아 다 언덕 겨울이 버리었습니다. 아무 별 헤는 소녀들의 나의 위에도 노루, 못 듯합니다. 하늘에는 아직 별빛이 있습니다.
아름다운 부끄러운 애기 가난한 별 소학교 멀듯이, 있습니다. 까닭이요, 별 이름자를 둘 이름과, 무엇인지 하늘에는 봄이 쓸쓸함과 있습니다. 없이 벌써 우는 나의 못 불러 가을로 옥 거외다. 멀리 했던 묻힌 지나고 하나 이네들은 쉬이 하나에 계절이 듯합니다. 아침이 잠, 릴케 슬퍼하는 있습니다. 내일 같이 많은 별 아스라히 옥 거외다. 가을 책상을 별 딴은 슬퍼하는 남은 때 하나에 봅니다. 동경과 별 강아지, 가난한 이름과, 내일 어머니 겨울이 슬퍼하는 있습니다. 써 가을로 자랑처럼 마디씩 이름과, 같이 딴은 봅니다. 추억과 보고, 이름과, 된 버리었습니다. 동경과 언덕 멀리 써 딴은 가득 있습니다.
사랑과 속의 어머니, 내 계집애들의 듯합니다. 프랑시스 하나에 오면 버리었습니다. 써 보고, 별을 청춘이 내 헤일 다 있습니다. 애기 내 이름과, 버리었습니다. 아름다운 청춘이 슬퍼하는 나의 소학교 않은 책상을 아스라히 내 봅니다. 한 마디씩 새겨지는 남은 자랑처럼 벌써 릴케 라이너 까닭입니다. 많은 사랑과 옥 마리아 이름과, 하나에 라이너 쓸쓸함과 버리었습니다. 쓸쓸함과 시와 프랑시스 버리었습니다. 하나에 계집애들의 사랑과 때 언덕 거외다. 강아지, 별 불러 내린 나는 별 거외다.
### 영문 English ###
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam a placerat quam. Etiam sagittis et ex et rhoncus. Aenean ut elit et libero tincidunt aliquet. Proin semper sed sem sed pellentesque. Donec scelerisque, turpis vitae blandit sollicitudin, tortor purus fermentum enim, sit amet ullamcorper eros sem et turpis. Vivamus et interdum mi, quis placerat ante. Mauris semper id diam pellentesque lacinia.
Integer accumsan dui leo. In ac molestie sem. Maecenas vel maximus sapien, rhoncus pretium sapien. Nunc ut maximus augue, eu ultricies lectus. Quisque aliquet luctus consequat. Praesent et placerat diam. Ut sit amet dictum augue, eu ullamcorper ex. Nullam venenatis luctus orci quis suscipit. Etiam et nisi est. Quisque non dolor sodales mi pretium porta. Praesent interdum hendrerit arcu nec efficitur.
Vestibulum non sapien massa. In risus mauris, auctor at eros ut, semper sodales ante. Phasellus nec nibh ac enim faucibus mollis. Suspendisse viverra faucibus arcu nec tristique. Phasellus volutpat dolor at quam cursus, nec suscipit ante hendrerit. Suspendisse potenti. Proin tempor, leo vehicula dignissim commodo, risus magna ornare nisl, quis molestie lorem lacus lacinia tortor. In eget dictum enim. Phasellus tempor fermentum est, quis feugiat tellus gravida sed. Sed eget condimentum ipsum, id fermentum dui. Nunc ornare mauris ex, eu suscipit ipsum sodales eu. Morbi blandit nisl velit, eu ullamcorper lacus gravida eget. Ut erat velit, mollis eget laoreet in, malesuada id odio.
## 인용문 Blockquotes ##
```html
> 위에 하나에 피어나듯이 별 지나고 별 책상을 것은 있습니다. 남은 이국 별 어머님, 사랑과 있습니다.
> 별 차 가난한 별 나의 릴케 내일 헤일 있습니다. 청춘이 것은 묻힌 이름을 하나에 별빛이 이제 봅니다.
> 별이 이런 차 위에 그러나 경, 무덤 시인의 계십니다. 말 하나에 내린 새겨지는 겨울이 슬퍼하는 이네들은
> 된 했던 까닭입니다. 까닭이요, 다 무덤 나는 남은 둘 그리워 멀리 오면 까닭입니다. 나의 이름과
> 소녀들의 거외다. 속의 무성할 북간도에 나의 걱정도 부끄러운 쓸쓸함과 사람들의 멀리 있습니다.
> 딴은 별 별이 까닭이요, 이런 다하지 가을 버리었습니다.
```
> 위에 하나에 피어나듯이 별 지나고 별 책상을 것은 있습니다. 남은 이국 별 어머님, 사랑과 있습니다.
> 별 차 가난한 별 나의 릴케 내일 헤일 있습니다. 청춘이 것은 묻힌 이름을 하나에 별빛이 이제 봅니다.
> 별이 이런 차 위에 그러나 경, 무덤 시인의 계십니다. 말 하나에 내린 새겨지는 겨울이 슬퍼하는 이네들은
> 된 했던 까닭입니다. 까닭이요, 다 무덤 나는 남은 둘 그리워 멀리 오면 까닭입니다. 나의 이름과
> 소녀들의 거외다. 속의 무성할 북간도에 나의 걱정도 부끄러운 쓸쓸함과 사람들의 멀리 있습니다.
> 딴은 별 별이 까닭이요, 이런 다하지 가을 버리었습니다.
## 리스트 Lists ##
### Ordered List ###
```html
1. 하나에 밤이 어머님, 까닭이요,
1. 소녀들의 이웃 시인의 있습니다.
1. 다하지 밤이 이런 거외다.
1. 하늘에는 내 나의 밤을 부끄러운 불러 시인의 봅니다.
```
1. 하나에 밤이 어머님, 까닭이요,
1. 소녀들의 이웃 시인의 있습니다.
1. 다하지 밤이 이런 거외다.
1. 하늘에는 내 나의 밤을 부끄러운 불러 시인의 봅니다.
### Unordered List ###
```html
* 그러나 벌써 가난한 까닭이요,
* 다 하나에 하나에 듯합니다.
* 오면 내 하나에 이네들은 거외다.
* 마리아 시와 덮어 계절이 어머니, 있습니다.
* 위에 이름을 언덕 별 거외다.
* 소학교 다 나는 동경과 시와 하나에 위에도 내 비둘기, 계십니다.
* 벌써 가난한 하나 릴케 내 덮어 계십니다.
* 나는 이름을 말 이름과 있습니다.
```
* 그러나 벌써 가난한 까닭이요,
* 다 하나에 하나에 듯합니다.
* 오면 내 하나에 이네들은 거외다.
* 마리아 시와 덮어 계절이 어머니, 있습니다.
* 위에 이름을 언덕 별 거외다.
* 소학교 다 나는 동경과 시와 하나에 위에도 내 비둘기, 계십니다.
* 벌써 가난한 하나 릴케 내 덮어 계십니다.
* 나는 이름을 말 이름과 있습니다.
## 테이블 Tables ##
```html
| Tables | Are | Cool |
|----------|:-------------:|------:|
| col 1 is | left-aligned | $1600 |
| col 2 is | centered | $12 |
| col 3 is | right-aligned | $1 |
```
| Tables | Are | Cool |
|----------|:-------------:|------:|
| col 1 is | left-aligned | $1600 |
| col 2 is | centered | $12 |
| col 3 is | right-aligned | $1 |
## 코드 블록 Codeblocks ##
### 인라인 코드 Inline Code ###
```html
PHP 코드를 인라인으로 보여준다면 `<?php echo 'inline code'; ?>` 코드 부분을 백틱(`` ` ``)으로 감싸줍니다.
```
PHP 코드를 인라인으로 보여준다면 `<?php echo 'inline code'; ?>` 코드 부분을 백틱(`` ` ``)으로 감싸줍니다.
### 코드 블록 Codeblock ###
```html
```js
function visitor(node) {
try {
const alignment = node.align;
visit(node, 'tableRow', (rowNode) => {
rowNode.children.forEach(function (cellNode, index) {
cellNode.align = alignment[index]
});
});
node.align = node.align.map(function(value) {
return null;
});
} catch (e) {
}
}
```
코드 블록 위 아래로 백틱 세 개(`` ``` ``)를 이용해 감싸줍니다.
```js
function visitor(node) {
try {
const alignment = node.align;
visit(node, 'tableRow', (rowNode) => {
rowNode.children.forEach(function (cellNode, index) {
cellNode.align = alignment[index]
});
});
node.align = node.align.map(function(value) {
return null;
});
} catch (e) {
}
}
```
## 이미지 Images ##
### 외부 이미지 ###
```html
![Photo by Ingmar Hoogerhoud on Unsplash](https://github.com/devrel-kr/gridsome-starter-liebling/blob/main/content/posts/images/ingmar-hoogerhoud-lm91dJNPRS4-unsplash.jpg?raw=true)
```
![Photo by Ingmar Hoogerhoud on Unsplash](https://github.com/devrel-kr/gridsome-starter-liebling/blob/main/content/posts/images/ingmar-hoogerhoud-lm91dJNPRS4-unsplash.jpg?raw=true)
### 내부 이미지 ###
```html
![Designed by Ashley Willis](./images/bit-apex.png)
```
![Designed by Ashley Willis](./images/bit-apex.png)
## 단축 코드 ##
자주 쓰는 외부 미디어들 링크를 위한 단축 코드를 나타냅니다.
### 깃헙 Gist ###
### Gist 전체 공유 ###
```
https://gist.github.com/<username_or_orgname>/<gist_id>
```
https://gist.github.com/ianychoi/d6ca01ed4f57d1ddbef588e6d125f563
### Gist 내 특정 파일 공유 ###
```
https://gist.github.com/<username_or_orgname>/<gist_id>?file=07-proxy-http-trigger.js
```
https://gist.github.com/justinyoo/fcba3e387d240a057e76a28f233fec82?file=07-proxy-http-trigger.js
### Gist 내 특정 파일의 특정 라인 하이라이트 ###
```
https://gist.github.com/<username_or_orgname>/<gist_id>?file=07-proxy-http-trigger.js&highlights=4-6,9,11
```
https://gist.github.com/justinyoo/fcba3e387d240a057e76a28f233fec82?file=07-proxy-http-trigger.js&highlights=4-6,9,11
### 유튜브 YouTube ###
```
https://youtu.be/q2N6NZKxipg
```
https://youtu.be/q2N6NZKxipg
### 트위터 Twitter ###
```
https://twitter.com/microsofttechKR/status/1340869604869025793
```
https://twitter.com/microsofttechKR/status/1340869604869025793

Двоичные данные
content/pages/images/bit-apex.png
Просмотреть файл

Двоичный файл не отображается.
Режим "рядом"

До

Ширина:  |  Высота:  |  Размер: 558 KiB

27
content/posts/2021/01/2021-01-01-tech-blog-opening.md
Просмотреть файл

@ -1,27 +0,0 @@
---
title: Microsoft Korea 기술 블로그를 시작합니다
slug: tech-blog-opening
description: 2021년을 맞이해서 Microsoft Korea에서 새롭게 기술 블로그를 선보입니다
date: 2021-01-01
image: https://sa0blogs.blob.core.windows.net/msdevkr/2021/01/2021-01-01-tech-blog-opening-00.png
image_caption: APEX Bit
author: devrel-kr
category: Announcement
tags: azure, microsoft365, power-platform
featured: false
---
안녕하세요!
2021년 한국 마이크로소프트에서 새롭게 기술 블로그를 선보입니다. 마이크로소프트의 클라우드 서비스 삼대 축을 이루는 [Microsoft Azure][ms azure], [Microsoft 365][ms 365] 그리고 [Microsoft Power Platform][ms pwpf]을 중심으로 현업 개발자들이 필요로 하는 기술적인 내용들을 다룰 예정입니다.
많은 성원 부탁드립니다!
![Developer Advocate Bit][image-01]
[image-01]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/01/2021-01-01-tech-blog-opening-01.png
[ms azure]: https://azure.microsoft.com/ko-kr/
[ms 365]: https://www.microsoft.com/ko-kr/microsoft-365
[ms pwpf]: https://powerplatform.microsoft.com/ko-kr/

150
content/posts/2021/01/2021-01-06-provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli.md
Просмотреть файл

@ -1,150 +0,0 @@
---
title: 애저 CLI를 이용해 애저 이벤트그리드 구독 및 로직앱 이벤트 핸들러 프로비저닝하기
slug: provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli
description: 애저 이벤트그리드 커스텀 토픽에 대한 애저 이벤트그리드 구독 리소스는 ARM 템플릿을 통해 프로비저닝 할 수 없습니다. 이 포스트는 애저 CLI를 이용해서 이 애저 이벤트그리드 구독과 로직앱 이벤트 핸들러를 별다른 외부 입력값 없이 자동으로 프로비저닝하는 방법에 대해 알아봅니다.
date: 2021-01-06
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli-00.png
image_caption: 애저 이벤트그리드 구독을 위한 애저 CLI 명령어
author: justin-yoo
category: Azure
tags: devops, azure-cli, azure-logic-apps, azure-eventgrid, github-actions
canonical_url: https://blog.aliencube.org/ko/2021/01/06/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli/
featured: false
---
[애저 이벤트그리드][az evtgrd]라는 서비스를 이용하면 다양한 형태의 이벤트 기반 아키텍처를 구성할 수 있습니다. 특히 다양한 형태로 기존에 존재하는 애플리케이션간 이벤트 메시지를 전송하는데 있어서 꽤 유용하게 쓰이지요.
![애저 이벤트그리드][image-01]
## 이벤트 기반 아키텍처의 세 요소 ##
이벤트 기반 아키텍처를 구성할 때 중요한 역할을 하는 세 가지 요소는 아래와 같습니다.
### 이벤트 생성자/퍼블리셔 ###
이벤트 생성자/퍼블리셔는 이벤트가 발생하는 근원입니다. 이벤트만 발생시킬 수 있다면 무엇이든 이벤트 생성자가 될 수 있죠. 아래 그림은 지난 2018년 [오픈 인프라 데이즈][oid]에서 발표했던 [클라우드이벤트 CloudEvents][oid ce] 발표 내용의 일부를 캡쳐한 것인데요, 아래 그림에서는 라즈베리파이 장치에서 이벤트를 생성하는 것에 대해 묘사합니다.
![이벤트 생성자 Event Publisher][image-02]
### 이벤트 구독자/섭스크라이버/처리자/핸들러 ###
이벤트 구독자와 처리자는 엄밀히 말하면 다른 것이긴 하지만, 보통은 구독하면서 동시에 해당 이벤트를 처리하기 때문에 같은 것드로 봐도 큰 무리는 없습니다. 아래 그림에서는 이벤트 생성자가 보낸 이벤트를 받아 시각화 처리를 하는 형태를 보여줍니다.
![이벤트 구독자 Event Subscriber][image-03]
### 이벤트 중개자/브로커 ###
일반적으로 이 이벤트 생성자와 구독자 사이에서는 직접적인 연결을 하지 않고 비동기식으로 진행하는데, 이 때 필요한 것이 바로 [애저 이벤트그리드][az evtgrd]와 같은 이벤트 중개자입니다. 아래 그림은 바로 [애저 이벤트그리드][az evtgrd]가 이벤트 생성자와 구독자 사이에서 어떤 역할을 하는지 보여줍니다.
![이벤트 중개자 Event Broker][image-04]
> [클라우드이벤트][ce]에 대해 좀 더 알고 싶다면, [발표 영상][oid yt]과 [발표 자료][oid ss]를 확인해 보세요!
## 애저 이벤트그리드 구독자 생성하기 ##
일반적인 CI/CD 환경에서 애저 이벤트그리드 토픽을 생성할 때에는 [ARM 템플릿][az evtgrd arm topic]을 이용하면 쉽습니다. 하지만, 이벤트그리드 구독을 생성하는 [ARM 템플릿][az evtgrd arm sub]은 내가 생성한 이벤트그리드 토픽을 지정할 수 없기 때문에 여기서는 안타깝지만 사용할 수 없습니다. 대신, [애저 CLI][az cli]를 사용해서 내가 지정한 토픽에 대해 구독을 생성하면 됩니다.
---
***추가:***
정확하게는 이벤트그리드 구독 리소스를 생성하면서 토픽을 지정할 수 있는 방법이 사실 두 가지가 있습니다.
### 스코프 지정하기 (권장하는 방법) ###
위에 언급한 이벤트그리드 구독용 [ARM 템플릿][az evtgrd arm sub]을 사용하기 위해서는 `scope` 속성값을 지정해 주면 됩니다 (line #7). ARM 템플릿을 [bicep][az bicep]으로 구현한 샘플 코드는 대략 아래와 같습니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=06-az-eventgrid-event-subscription-create-1.bicep&highlights=7
### 하위 리소스 타입 지정하기 (권장하지는 않지만 허용되는 방법) ###
또는 아래와 같이 하위 리소스 타입으로 구현을 할 수도 있습니다. 이 떄는 `scope` 속성값이 필요하진 않지만, 리소스 타입과 이름을 좀 더 길게 정해줘야 하는 번거로움이 있습니다 (line #6-7).
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=07-az-eventgrid-event-subscription-create-2.bicep&highlights=6-7
따라서, 위와 같은 방식으로 애저 이벤트그리드 구독 리소스를 프로비저닝해도 됩니다. 다만, 이 포스트는 애저 CLI에 초점을 맞추도록 하겠습니다.
---
## 애저 CLI 사전 준비사항 ##
[애저 CLI][az cli]로 이벤트그리드 구독 리소스를 프로비저닝하기 위해서는 아래 [확장기능][az cli extensions]을 먼저 설치해야 합니다. 여기서 [Logic][az cli extensions logic]은 [애저 로직앱][az logapp]을 위한 것인데, 이 포스트에서는 이벤트 처리자로서 로직앱을 사용하기 때문입니다.
* [EventGrid][az cli extensions eventgrid]
* [Logic][az cli extensions logic]
> 이 두 확장기능은 이 글을 쓰는 현재 프리뷰 기능이며 언제든 구현이 바뀔 수 있다는 점 잊지 마세요!
## 애저 CLI 명령어 ##
먼저 [애저 로직앱][az logapp]을 이벤트 처리자로 사용하기 위해서는 로직앱의 엔드포인트 URL을 알아내야 합니다. 로직앱은 특성상 엔드포인트 뒤에 항상 SAS 토큰이 붙어오기 때문에 이를 함께 알아내야 합니다. 먼저 엔드포인트를 찾고자 하는 로직앱의 리소스 ID를 아래와 같이 `az logic workflow show` 명령어를 통해 알아냅니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=01-az-logic-workflow-show.sh
그 다음에는 `az rest` 명령어를 통해 SAS 토큰이 붙어 있는 엔드포인트 값을 알아냅니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=02-az-rest.sh
이제 로직앱을 이벤트 처리자로 사용하기 위한 준비는 끝났습니다. 다음 순서는 이벤트그리드 토픽의 리소스 ID를 아래와 같이 `az eventgrid topic show` 명령어를 통해 알아냅니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=03-az-eventgrid-topic-show.sh
이벤트그리드 구독자를 생성하기 위한 모든 준비가 끝났습니다. 아래 `az eventgrid event-subscription create` 명령어를 통해 이벤트그리드 구독자를 생성합니다. 여기서는 [CNCF][cncf]의 인큐베이팅 프로젝트인 [CloudEvents 스키마][ce]를 사용하는 것으로 합니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=04-az-eventgrid-event-subscription-create.sh
위와 같은 방법으로 하면 곧바로 애저 이벤트그리드 구독자 리소스를 프로비저닝할 수 있습니다. 위 명령어를 한줄로 합치면 아래와 같습니다.
https://gist.github.com/justinyoo/8865213b31baeda9f7c1ad258351a039?file=05-one-liner.sh
---
지금까지 이벤트그리드 구독자를 프로비저닝하고 로직앱을 그 처리자로 설정하기 위해 애저 CLI를 이용하는 방법에 대해 알아 보았습니다. 이를 조금 더 활용하면 [깃헙 액션][gh actions]과 같은 CI/CD 파이프라인에서도 손쉽게 통합시킬 수 있을 것입니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://docs.microsoft.com/ko-kr/azure/event-grid/media/overview/functional-model.png?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli-04.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[az cli]: https://docs.microsoft.com/ko-kr/cli/azure/what-is-azure-cli?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[az cli extensions]: https://docs.microsoft.com/ko-kr/cli/azure/azure-cli-extensions-list?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[az cli extensions eventgrid]: https://github.com/Azure/azure-cli-extensions/tree/master/src/eventgrid
[az cli extensions logic]: https://github.com/Azure/azure-cli-extensions/tree/master/src/logic
[az bicep]: https://github.com/Azure/bicep
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[az evtgrd]: https://docs.microsoft.com/ko-kr/azure/event-grid/overview?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[az evtgrd arm topic]: https://docs.microsoft.com/ko-kr/azure/templates/microsoft.eventgrid/topics?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[az evtgrd arm sub]: https://docs.microsoft.com/ko-kr/azure/templates/microsoft.eventgrid/eventsubscriptions?WT.mc_id=devops-12244-juyoo&ocid=AID3027813
[oid]: https://event.openinfradays.kr/2018/about/
[oid ce]: https://event.openinfradays.kr/2018/session1/track_4_0
[oid yt]: https://youtu.be/h2_ZNTXwlVc
[oid ss]: https://www.slideshare.net/openstack_kr/openinfra-days-korea-2018-track-4-cloudevents
[cncf]: https://www.cncf.io/
[ce]: https://cloudevents.io/
[gh actions]: https://docs.github.com/en/free-pro-team@latest/actions

211
content/posts/2021/01/2021-01-12-refactoring-azure-devops-pipelines.md
Просмотреть файл

@ -1,211 +0,0 @@
---
title: 애저 DevOps 파이프라인을 리팩토링하는 6가지 방법
slug: 6-ways-refactoring-azure-devops-pipelines
description: 애저 DevOps 파이프라인 YAML 파일을 사용하다 보면 반복적인 작업이 많이 나옵니다. 이 반복적인 작업 부분을 템플릿 형태로 리팩토링할 수 있는 포인트가 최소 여섯 군데 정도인데, 이러한 리팩토링 테크닉에 대해 다뤄봅니다.
date: 2021-01-12
image: https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-00.jpg
image_caption: 퍼즐을 푸는 사람들
author: justin-yoo
category: Azure
tags: devops, azure-devops, azure-pipelines, multi-stage-pipelines, refactoring, yaml
canonical_url: https://blog.aliencube.org/ko/2019/09/04/azure-devops-pipelines-refactoring-technics/
featured: false
---
[애저 DevOps][az devops]에서 [CI/CD 파이프라인][az devops pipelines]을 구성하다보면 보통 반복적인 작업들이 많습니다. 이게 [태스크 Tasks][az devops pipelines tasks] 수준일 수도 있고, [작업 Jobs][az devops pipelines jobs] 수준일 수도 있고, [스테이지 Stages][az devops pipelines stages] 수준일 수도 있는데, 코딩을 할 때는 반복적인 부분을 리팩토링 한다지만, 파이프라인에서 반복적인 부분을 리팩토링할 수는 없을까요? 물론 있습니다. 그것도 파이프라인을 리팩토링할 수 있는 포인트가 최소 여섯 군데 정도 있습니다. 이 포스트에서는 애저 파이프라인의 [YAML][az devops pipelines yaml] 형식 [템플릿][az devops pipelines templates]을 이용해서 반복적으로 나타나는 부분을 리팩토링하는 방법에 대해 알아보겠습니다.
> 이 포스트에 쓰인 예제 파이프라인 코드를 [이 리포지토리](https://github.com/devkimchi/Azure-Pipelines-Template-Sample)에서 확인해 보세요!
## 빌드 파이프라인 ##
우선 일반적인 빌드 파이프라인을 한 번 만들어 보겠습니다. 아래는 그냥 빌드 `Stage`를 작성한 것입니다. `Stages/Stage` 아래 `Jobs/Job` 아래 `Steps/Task`가 들어가 있습니다. `Greeting` 이라는 변수값을 출력시키는 파이프라인입니다 (line #18, 25)
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-build-without-template.yaml&highlights=18,25
이 파이프라인을 실행시키면 아래와 같은 결과가 나옵니다. `Hello World`가 보이죠?
![리팩토링 전 애저 빌드 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-01.png)
이제 이 빌드 파이프라인을 리팩토링할 차례입니다. 리팩토링은 크게 세 곳에서 가능한데요, 하나는 `Steps` 수준, 다른 하나는 `Jobs` 수준, 그리고 마지막 하나는 `Stages` 수준입니다.
## 빌드 파이프라인을 `Steps` 수준에서 리팩토링하기 ##
예를 들어 node.js 기반의 애플리케이션을 하나 만든다고 가정해 보죠. 이 경우 보통 순서가
1. node.js 런타임 설치하기
2. npm 패키지 복원하기
3. 애플리케이션 빌드하기
4. 애플리케이션 테스트하기
5. 아티팩트 생성하기
정도가 될 것입니다. 이 때 마지막 5번 항목을 제외하고는 거의 대부분의 경우 같은 순서로, 그리고 저 1-4번 작업을 한 세트로 해서 진행을 하게 되죠. 그렇다면 이 1-4번 작업 흐름을 그냥 하나로 묶어서 템플릿 형태로 빼 놓을 수도 있지 않을까요? 이럴 때 바로 `Steps` 수준의 리팩토링을 진행하게 됩니다. 만약 다른 작업에서는 이후 추가 작업을 더 필요로 한다고 하면 템플릿을 돌리고 난 후 추가 태스크를 정의하면 되므로 별 문제는 없습니다.
이제 위에 정의한 빌드 파이프라인의 `Steps` 부분을 별도의 템플릿으로 분리합니다. 그렇다면 원래 파이프라인과 템플릿은 아래와 같이 바뀔 것입니다. 원래 파이프라인(`pipeline.yaml`)의 `steps` 항목 아래에 `template` 라는 항목이 생기고 (line #21), `parameters`를 통해 템플릿으로 값을 전달하는 것이 보일 것입니다 (line #22-23).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-build-with-steps-template.yaml&highlights=21-23
그리고 `Steps` 수준 리팩토링 결과 템플릿인 `template-steps-build.yaml`을 보면, 아래와 같이 `parameters`와 `steps`를 정의했습니다 (line #2, 5). 이 `parameters` 항목을 통해 부모 파이프라인과 템플릿 사이 값을 교환할 수 있게 해 줍니다.
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-steps-build.yaml&highlights=2,5
이렇게 리팩토링을 한 후 파이프라인을 돌려보면 아래와 같은 결과 화면을 보게 됩니다. 부모 파이프라인에서 템플릿으로 넘겨준 파라미터 값이 잘 표현되는 것이 보이죠?
![Steps 수준 리팩토링 후 애저 빌드 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-02.png)
## 빌드 파이프라인을 `Jobs` 수준에서 리팩토링하기 ##
이번에는 `Jobs` 수준에서 리팩토링을 한 번 해보겠습니다. 앞서 연습해 봤던 `Steps` 수준 리팩토링은 공통의 태스크들을 묶어주는 정도였다면, `Jobs` 수준의 리팩토링은 그보다 큰 덩어리를 다룹니다. 이 덩어리에는 [빌드 에이전트][az devops pipelines agents]의 종류까지 결정할 수 있고, 템플릿 안의 모든 태스크를 동일하게 가져갈 수 있습니다.
> 물론 [조건 표현식][az devops pipelines conditions]과 같은 고급 기능을 사용하면 좀 더 다양한 시나리오에서 다양한 태스크들을 활용할 수 있습니다.
아래와 같이 부모 파이프라인을 수정해 보죠 (line #13-16).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-build-with-jobs-template.yaml&highlights=13-16
그리고 난 후, 아래와 같이 `template-jobs-build.yaml` 파일을 작성합니다. 파라미터로 `vmImage`와 `message`를 넘겨 템플릿에서 어떻게 사용하는지 살펴보죠 (line #2-4).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-jobs-build.yaml&highlights=2-4
`Jobs` 수준에서 사용하는 빌드 에이전트의 종류까지도 변수화시켜 사용할 수 있는 것이 보이나요? 부모 템플릿에서 에이전트를 `Windows Server 2016` 버전으로 설정했으므로 실제 이를 파이프라인으로 돌려보면 아래와 같은 결과가 나타납니다.
![Jobs 수준 리팩토링후 애저 빌드 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-03.png)
## 빌드 파이프라인을 `Stages` 수준에서 리팩토링하기 ##
이번에는 `Stages` 수준에서 파이프라인 리팩토링을 시도해 보겠습니다. 하나의 스테이지에는 여러개의 `Job`을 동시에 돌리거나 순차적으로 돌릴 수 있습니다. `Job` 수준에서 돌아가는 공통의 작업들이 있다면 이를 `Job` 수준에서 묶어 리팩토링 할 수 있겠지만, 아예 공통의 `Job`들 까지 묶어서 하나의 `Stage`를 만들고 이를 별도의 템플릿으로 빼낼 수 있는데, 이것이 이 연습의 핵심입니다. 아래 부모 파이프라인 코드를 보세요. `stages` 아래에 곧바로 템플릿을 지정하고 변수를 보냅니다 (line #9-12).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-build-with-stages-template.yaml&highlights=9-12
위에서 언급한 `template-stage-build.yaml` 파일은 아래와 같이 작성할 수 있습니다. 부모에서 받아온 파라미터를 통해 빌드 에이전트에 쓰일 OS와 다른 값들을 설정할 수 있는게 보이죠 (line #2-4)?
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-stages-build.yaml&highlights=2-4
이렇게 해서 파이프라인을 실행해 본 결과는 대략 아래와 같습니다. 변수를 통해 전달한 값에 따라 빌드 에이전트가 `Ubuntu 16.04` 버전으로 설정이 되었고, 글로벌 변수 값을 별도로 재정의하지 않았으므로 아래 그림과 같이 `G'day, mate`라는 글로벌 변수 값을 볼 수 있습니다.
![Stages 수준 리팩토링 후 애저 빌드 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-04.png)
## 빌드 파이프라인을 다단계 템플릿으로 리팩토링하기 ##
이렇게 `Steps` 수준, `Jobs` 수준, `Stages` 수준에서 모두 리팩토링을 해 봤습니다. 그렇다면 리팩토링의 결과물인 템플릿을 다단계로 걸쳐서 사용할 수는 없을까요? 물론 당연히 되죠. 아래와 같이 부모 파이프라인을 수정해 보겠습니다. 이번에는 맥OS를 에이전트로 선택해 볼까요 (line #9-12)?
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-build-with-nested-stages-template.yaml&highlights=9-12
`Stage` 수준에서 다단계 템플릿을 만들어서 붙여봤습니다. 이 템플릿 안에서 또다시 `Jobs` 수준의 다단계 템플릿을 호출합니다 (line #11-14).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-stages-nested-build.yaml&highlights=11-14
`Jobs` 수준의 다단계 템플릿은 대략 아래와 같습니다. 그리고, 이 안에서 또다시 앞서 만들어 둔 `Steps` 수준의 템플릿을 호출합니다 (line #17-19).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-jobs-nested-build.yaml&highlights=17-19
이렇게 다단계로 템플릿을 만들어 붙여놓은 후 파이프라인을 돌려보면 아래와 같습니다.
![다단계 리팩토링 후 애저 빌드 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-05.png)
아주 문제 없이 다단계 템플릿이 잘 돌아가는게 보이죠?
지금까지 빌드 파이프라인을 리팩토링해 봤습니다. 이제 릴리즈 파이프라인으로 들어가 보겠습니다.
## 릴리즈 파이프라인 ##
릴리즈 파이프라인은 빌드 파이프라인과 크게 다르지 않습니다. 다만 `job` 대신 [`deployment job`][az devpos pipelines deploymentjobs]을 사용한다는 차이가 있을 뿐입니다. 이 둘의 차이에 대해 얘기하는 것은 이 포스트의 범위를 벗어나니 여기까지만 하기로 하고, 실제 릴리즈 파이프라인의 구성을 보겠습니다. 템플릿 리팩토링 없는 전형적인 릴리즈 스테이지는 아래와 같습니다.
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-release-without-template.yaml&highlights=9
위 코드를 보면 `Jobs` 수준에 `deployment`를 사용해서 작업 단위를 정의한 것을 볼 수 있죠 (line #9)? 이를 실행시킨 결과는 대략 아래와 같습니다.
![리팩토링 전 애저 릴리즈 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-06.png)
이제 이 릴리즈 파이프라인을 동일하게 세 곳, `Steps`, `Jobs`, `Stages` 수준에서 리팩토링을 할 수 있습니다. 각각의 리팩토링 방식은 크게 다르지 않으므로 아래 리팩토링 결과만을 적어놓도록 하겠습니다.
## 릴리즈 파이프라인을 `Steps` 수준에서 리팩토링하기 ##
우선 `Steps` 수준에서 릴리즈 템플릿을 만들어 보도록 하죠. 부모 템플릿은 아래와 같습니다 (line #24-26).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-release-with-steps-template.yaml&highlights=24-26
그리고 템플릿으로 빼낸 `Steps`는 아래와 같습니다. 앞서 빌드 파이프라인에서 사용한 템플릿과 구조가 다르지 않죠 (line #2-3)?
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-steps-release.yaml&highlights=2-3
그리고 그 결과를 보면 아래와 같습니다.
![Steps 수준 리팩토링 후 애저 릴리즈 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-07.png)
## 릴리즈 파이프라인을 `Jobs` 수준에서 리팩토링하기 ##
이번에는 릴리즈 파이프라인을 `Jobs` 수준에서 리팩토링해 보겠습니다 (line #13-17).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-release-with-jobs-template.yaml&highlights=13-17
그리고 리팩토링한 템플릿은 아래와 같습니다. 여기서 눈여겨 봐야 할 부분은 바로 [`environment`][az devops pipelines environments] 이름도 파라미터로 처리가 가능하다는 점입니다 (line #14). 즉, 거의 대부분의 설정을 부모 파이프라인에서 파라미터로 내려주면 템플릿에서 받아 처리가 가능합니다 (line #2-5).
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-jobs-release.yaml&highlights=2-5,14
![Jobs 수준 리팩토링 후 애저 릴리즈 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-08.png)
## 릴리즈 파이프라인을 `Stages` 수준에서 리팩토링하기 ##
더 이상의 자세한 설명은 생략합니다 (line #5-9). 😉
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-release-with-stages-template.yaml&highlights=5-9
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=tmplate-stages-release.yaml&highlights=2-5
![Stages 수준 리팩토링 후 애저 릴리즈 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-09.png)
## 릴리즈 파이프라인을 다단계 템플릿으로 리팩토링하기 ##
릴리즈 파이프라인 역시 다단계 템플릿으로 구성이 가능합니다.
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=pipeline-release-with-nested-stages-template.yaml&highlights=5-9
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-stages-nested-release.yaml&highlights=2-5,12-16
https://gist.github.com/justinyoo/41e3c56debe1eaa0bb1d0ac062bb38b9?file=template-jobs-nested-release.yaml&highlights=20-22
![다단계 리팩토링 후 애저 릴리즈 파이프라인 실행 결과](https://sa0blogs.blob.core.windows.net/aliencube/2019/08/azure-devops-pipelines-refactoring-technics-10.png)
---
이렇게 빌드 및 릴리즈 파이프라인을 모든 [`Stages`][az devops pipelines stages], [`Jobs`][az devops pipelines jobs], [`Steps`][az devops pipelines tasks] 수준에서 [템플릿][az devops pipelines templates]을 이용해 리팩토링을 해 보았습니다. 파이프라인 작업을 하다 보면 분명히 리팩토링이 필요한 순간이 생깁니다. 그리고 어느 수준에서 템플릿을 만들어 써야 할 지는 전적으로 상황마다 다르다고 할 수 있습니다.
다만 한 가지 고려해야 할 것은, 템플릿은 가급적이면 단순한 작업을 할 수 있게끔 만드는 것이 좋습니다. 템플릿 표현식을 보면 조건문도 있고 반복문도 있고 굉장히 고급 기능을 사용할 수 있긴 하지만, 우선은 단순하게 시작해서 템플릿을 다듬어 나가는 것이 좋을 것입니다. 아무쪼록 [애저 데브옵스 파이프라인][az devops pipelines]의 [다중 스테이지 파이프라인 기법][az devops pipelines multi-stage]을 통해 다양한 템플릿 활용 테크닉을 도입해 보고 그 강력함을 느낄 수 있기를 바랍니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 DevOps에 관심이 있으신가요? ➡️ [무료 애저 DevOps 사용하기][az devops free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops free]: https://azure.microsoft.com/ko-kr/services/devops/?WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[az devops]: https://docs.microsoft.com/ko-kr/azure/devops/user-guide/what-is-azure-devops?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/get-started/what-is-azure-pipelines?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines tasks]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/tasks?view=azure-devops&tabs=yaml&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines jobs]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/phases?view=azure-devops&tabs=yaml&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devpos pipelines deploymentjobs]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/deployment-jobs?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines stages]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/stages?view=azure-devops&tabs=yaml&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines yaml]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/yaml-schema?view=azure-devops&tabs=schema%2Cparameter-schema&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines templates]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/templates?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines conditions]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/conditions?view=azure-devops&tabs=yaml&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines agents]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/agents/agents?view=azure-devops&tabs=browser&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines multi-stage]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/get-started/multi-stage-pipelines-experience?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813
[az devops pipelines environments]: https://docs.microsoft.com/ko-kr/azure/devops/pipelines/process/environments?view=azure-devops&WT.mc_id=devops-12575-juyoo&ocid=AID3027813

128
content/posts/2021/01/2021-01-19-dealing-cloudevents-with-azure-functions-for-azure-eventgrid.md
Просмотреть файл

@ -1,128 +0,0 @@
---
title: "애저 펑션과 애저 이벤트그리드간 CloudEvents 형식 이벤트 데이터 주고받기"
slug: cloudevents-for-azure-eventgrid-via-azure-functions
description: "이 포스트에서는 애저 펑션의 이벤트그리드 바인딩이 아직 지원하지 않는 CloudEvents 형식의 이벤트 데이터를 다루는 방법에 대해 알아봅니다."
date: 2021-01-19
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/dealing-cloudevents-with-azure-functions-for-azure-eventgrid-00.png
image_caption: 애저 펑션에서 이벤트 그리드로, 다시 애저 펑션으로 클라우드 이벤트 형식 데이터 이동
author: justin-yoo
category: Azure
tags: azure-functions, azure-eventgrid, cloudevents, azure-sdk
canonical_url: https://blog.aliencube.org/ko/2021/01/13/dealing-cloudevents-with-azure-functions-for-azure-eventgrid/
featured: false
---
[애저 펑션][az fncapp]은 자체적으로 [애저 이벤트그리드][az evtgrd]에 대한 [바인딩 확장 기능][az fncapp binding evtgrd]을 제공하고 있어서 이벤트그리드로 이벤트 데이터를 아주 손쉽게 주고 받을 수 있습니다. 하지만, 현재 바인딩 확장 기능은 아직 정식으로 [CloudEvents][ce] 형식을 지원하지 않는데, 그 이유는 [현재 버전의 SDK][nuget evtgrd legacy]가 아직 CloudEvents 형식을 지원하지 않기 때문입니다. 아마도 [새 버전의 SDK][nuget evtgrd new]가 GA되는 시점이 되면 애저 펑션 확장 기능에서도 이를 지원하지 않을까 예상하는데요, 따라서, 그 때 까지는 CloudEvents 형식을 사용해서 이벤트그리드에 데이터를 주고 받기 위해서 별도의 작업을 해 줘야 합니다. 이 포스트에서는 그 방법에 대해 간단히 정리해 보도록 하겠습니다.
> 이 포스트에서는 [.NET SDK][az sdk evtgrd dotnet]를 대상으로 기술합니다. 다른 언어로도 SDK를 지원하고 있으니, 아래 링크를 클릭해서 새 SDK를 확인해 보세요!
>
> * [JavaScript][az sdk evtgrd js]
> * [Python][az sdk evtgrd python]
> * [Java][az sdk evtgrd java]
## 애저 이벤트그리드 SDK 프리뷰 버전 설치 ##
이 글을 쓰는 현재 새 버전의 애저 이벤트그리드 SDK 버전은 [`4.0.0-beta.4`][nuget evtgrd new]로, 아직 프리뷰 상태입니다. 이 프리뷰 버전의 SDK를 사용하면 CloudEvents 형식의 이벤트 데이터를 활용할 수 있죠. 먼저 아래 명령어를 통해 프리뷰 버전의 SDK를 설치합니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=01-dotnet-add-package.sh
이제 본격적으로 이벤트그리드 데이터를 작업해 보도록 하겠습니다!
## CloudEvents 형식으로 이벤트 데이터 보내기 ##
애저 CLI에서 이벤트그리드 명령어를 사용하기 위해서는 먼저 아래와 같이 [확장 기능][az cli extensions]을 설치해야 합니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=02-az-extension-add.sh
확장 기능을 설치하고 나면, 아래 [애저 CLI][az cli] 명령어를 통해 이벤트그리드 커스텀 토픽의 엔드포인트를 확인합니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=03-get-endpoint.sh
그리고, 접속 키는 아래 명령어를 이용해서 확인합니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=04-get-access-key.sh
위에서 확인한 엔드포인트와 접속 키를 이용해서 아래와 같이 애저 펑션 안에 이벤트그리드용 데이터 퍼블리셔 인스턴스를 만듭니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=05-create-publisher.cs
CloudEvents 형식의 데이터를 보내기 위해서는 이벤트 데이터 뿐만 아니라 몇 가지 다른 메타 데이터 정보가 필요합니다.
* `source`: 이벤트 발생자. 보통 URL 형식으로 작성합니다.
* `type`: 이벤트 타입. 이 값을 이용해서 이벤트를 구분합니다. 형식은 `com.example.someevent`와 비슷한 형태가 됩니다.
* `datacontenttype`: 항상 `application/cloudevents+json` 값으로 지정해 주면 됩니다.
이외에도 다른 메타 데이터 정보가 필요하지만, 나머지는 SDK에서 자동으로 처리해주니 여기서는 크게 상관하지 않습니다.
> CloudEvents 데이터 형식에 대한 내용을 좀 더 확인하고 싶다면, [이 링크][ce spec json]를 읽어보세요!
위 메타 데이터 정보를 이용해 아래와 같이 CloudEvents 데이터를 작성한 후 이벤트그리드로 보내면 됩니다.
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=06-publish-event.cs
위의 방법을 통해 CloudEvents 형식의 이벤트 데이터를 이벤트그리드 커스텀 토픽으로 보낼 수 있게 됐습니다.
## CloudEvents 형식으로 이벤트 데이터 받기 ##
앞서 [애저 펑션][az fncapp]에서는 [이벤트그리드 바인딩 확장 기능의 제약][az fncapp binding evtgrd]이 있다고 했습니다. 때문에 CloudEvents 형식의 데이터를 받아 처리하기 위해서는 [HTTP 트리거][az fncapp trigger http]를 이용해야 하는데요, 이 트리거는 두 가지 요청을 동시에 처리해야 합니다.
* 이벤트 핸들러 엔드포인트 검증 요청
* 이벤트 데이터 처리
### 이벤트 핸들러 엔드포인트 검증 요청 ###
[CloudEvents의 웹훅 스펙][ce spec webhook]에 따르면 검증 요청은 `OPTIONS` 메소드를 이용하고 요청 헤더에 반드시 `WebHook-Request-Origin`를 포함합니다 (line #8). 따라서 이 검증 요청에 응답하기 위해서는 이 요청 헤더 값을 응답 헤더의 `WebHook-Allowed-Origin` 값에 실어 보내야 합니다 (line #9).
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=07-validate-request.cs&highlights=8,9
### 이벤트 데이터 처리 ###
위와 같이 이벤트 핸들러로서 애저 펑션 엔드포인트 검증에 성공했다면, 애저 이벤트그리드는 앞으로 이벤트 데이터를 계속해서 동일한 엔드포인트로 `POST` 메소드를 이용해 보냅니다. 이 때, CloudEvents 이벤트 데이터 전체를 사용하고 싶다면 아래 코드의 `@event` 인스턴스를 이용하면 되고 (line #18), `data` 부분만 사용하려면 아래 코드와 같이 비직렬화해서 사용합니다 (line #19).
https://gist.github.com/justinyoo/8282de7244bccca562cd508e64d89470?file=08-handle-event.cs&highlights=18,19
위와 같이 CloudEvents 형식의 이벤트 데이터를 이벤트 토픽에서 애저 펑션으로 받아 처리할 수 있게 됐습니다.
---
지금까지 [애저 펑션][az fncapp]에서 [애저 이벤트그리드][az evtgrd]로 [CloudEvents][ce] 형식의 이벤트 데이터를 보내고 받는 방법에 대해 알아 보았습니다. 이 방법은 포스트 안에서 계속 언급했다시피, 현재 [바인딩 확장 기능][az fncapp binding evtgrd]은 아직 CloudEvents 형식을 지원하지 않기 때문에, 일종의 임시방편으로 사용하는 방법입니다. 조만간 새 버전의 확장 기능이 릴리즈 되기를 기대합니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az devops free]: https://azure.microsoft.com/ko-kr/services/devops/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[az cli]: https://docs.microsoft.com/ko-kr/cli/azure/what-is-azure-cli?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az cli extensions]: https://docs.microsoft.com/ko-kr/cli/azure/azure-cli-extensions-list?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az fncapp binding evtgrd]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-event-grid?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az fncapp trigger http]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=csharp&WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az evtgrd]: https://docs.microsoft.com/ko-kr/azure/event-grid/overview?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[az evtgrd topic custom]: https://docs.microsoft.com/ko-kr/azure/event-grid/custom-topics?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[nuget evtgrd legacy]: https://www.nuget.org/packages/Microsoft.Azure.EventGrid/
[nuget evtgrd new]: https://www.nuget.org/packages/Azure.Messaging.EventGrid/
[az sdk evtgrd dotnet]: https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventgrid/Azure.Messaging.EventGrid
[az sdk evtgrd js]: https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/eventgrid/eventgrid
[az sdk evtgrd python]: https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/eventgrid/azure-eventgrid
[az sdk evtgrd java]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/eventgrid/azure-messaging-eventgrid
[ce]: https://cloudevents.io/
[ce spec json]: https://github.com/cloudevents/spec/blob/v1.0/json-format.md#23-examples
[ce spec webhook]: https://github.com/cloudevents/spec/blob/v1.0/http-webhook.md#4-abuse-protection

136
content/posts/2021/01/2021-01-26-towards-fairness-ai-with-fairlearn-and-azure-mlops.md
Просмотреть файл

@ -1,136 +0,0 @@
---
title: 공정한 & 편향없는 AI를 위한 Fairlearn 및 애저 MLOps 도구 활용
slug: towards-fairness-ai-with-fairlearn-and-azure-mlops
description: 공정한, 그리고 편향없는 AI를 실현하기 위한 마음가짐/윤리적인 자세도 중요하겠지만, 도구를 잘 활용하여 사용하는 데이터/알고리즘에 대한 편향성을 조기에 발견할 수 있다면 더욱 좋겠죠? Fairlearn 오픈소스와 애저 머신러닝 서비스를 활용한 MLOps 도구를 통해 공정한/편향없는 AI 실현이 어떻게 가능한지 다뤄봅니다.
date: 2021-01-26
image: https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/fairness_and_interpretability_in_ai.jpg
image_caption: AI에서 공정성 및 해석을 어떻게 해야할까
author: ian-choi
category: Azure
tags: azure, azure-ml, fairness, fairlearn, open-source, mlops, python
canonical_url: https://github.com/ianychoi/Azure-oss-hands-on-labs/blob/master/06-Azure-ML-with-Fairlearn/README.md
featured: false
---
개인의 삶에 영향을 미치는 중요한 결정에 많은 데이터 활용이 이루어지면서 보다 안전하고, 윤리적이면서 책임감있는 사용을 보장하는 AI(인공지능)에 대한 중요성이 대두되고 있습니다. 선한 목적으로 알고리즘을 개발하고 데이터를 활용하더라도 의도하지 않게 성별, 문화적, 민족적 편향성을 AI가 보여준다면 결코 공정하다고 할 수 없을 것입니다.
![애저 머신러닝 - 책임있는 ML](https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/responsible-ml.png)
마이크로소프트는 책임감있고 사람들의 신뢰를 보장하는 방식으로 AI 시스템이 개발되도록 AETHER 위원회를 비롯한 작업 그룹들이 주도하는 노력과 지원을 계속하고 있습니다 ([참고][ms-ai-approach]). 그 중, 지난 빌드 2020에서는 애저 머신러닝 서비스를 통해 책임있는 ML을 어떻게 구현하는지에 대한 발표가 있었습니다. 데이터 과학자 및 개발자 분들께서 머신러닝 모델을 보다 잘 <b>이해</b>하고, 데이터를 <b>보호</b>하며 머신러닝 전반 과정을 <b>제어</b>하는 과정을 통해 신뢰할 수 있는 AI를 구축가능하다는 것입니다.
![AI에서의 공정성 (Fairness)](https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/ai-and-fairness-from-build-korea-azure-ai.jpg)
지난 2020년 7월, 마이크로소프트 [Data&AI 클라우드 솔루션 아키텍트이신 박소은님][linkedin-soeun-park]이 [Azure AI의 새로운 기능][ms-build-korea-2020-azure-track]에 대해 발표하시면서 AI에서의 공정성 (Fairness)을 말씀해주셨습니다. AI 시스템이 공정하지 않게 동작할 때 발생하는 여러 피해 중, 하나는 서비스 품질 (Quality of Service)에 대한 피해가 있습니다. 제품이 특정 그룹에서는 잘 동작하지만 다른 그룹에서는 다른 품질을 보여준다는 것으로, 어떤 음성인식 시스템에서, 남성의 목소리는 잘 인식하는 반면, 여성의 소리를 잘 인식하지 못한다면 서비스 품질 피해가 있다고 할 수 있습니다. 두 번째로는 할당 (Allocation)에 대한 피해로, 예를 들어 대출 심사나 채용 과정에서 관련없는 특징이 고려되어 판단이 되어 의도하지 않은 할당 피해가 있다는 것입니다. 이러한 문제들을 해결하기 위해서는 AI에 접근할 때 윤리적인 마음가짐과 함께 올바른 규정을 준수하는 부분도 중요하겠지만, 어떻게 모델을 분석하고, 특정 그룹의 사람들에게 부정적인 결과를 초래할 수 있는 이러한 행동들이 AI 시스템에 반영되었는지를 잘 확인하는 방법 또한 중요할 것입니다.
도구를 보다 잘 활용하여 사용하는 데이터 및 알고리즘이 공정한지를 어떻게 발견하고 대처할 수 있을까요? 이번 포스트에서는 머신러닝 시스템을 만들 때, 파이썬 라이브러리인 [Fairlearn][fairlearn-website] 오픈소스와 [애저 머신러닝 서비스][ms-azure-ml-docs]를 활용하여 보다 공정하고 편향없는 AI를 어떻게 실현할 수 있는지에 대해 알아보겠습니다.
## Fairlearn 오픈소스를 사용한 머신러닝 모델 평가 ##
Fairlearn은 머신러닝 모델에서 발생할 수 있는 비공정성을 평가하는 기능을 제공하면서 동시에 비공정성을 완화 가능한 알고리즘들을 제공하여 비공정성을 개선하고자 사용하는 오픈소스 툴킷입니다. 파이썬으로 작성된 오픈소스로 [깃허브에 공개][fairlearn-github]되어 있으며, [pip 명령어를 사용][fairlearn-pypi]해 로컬/클라우드 환경에 직접 설치하여 사용하실 수도 있습니다. 본 포스트에서는 비공정성 평가에 대한 부분을 살펴보겠습니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=01-pip-install-fairlearn.sh
일반적으로 머신러닝을 사용해 모델을 정의 후 트레이닝 및 예측하는 과정을 거치며, 머신러닝 모델을 평가하기 위해서는 분류(Classification), 회귀 (Regression), 클러스터링과 같은 모델 유형에 따라 정확도 (Accuracy), 정밀도 (Precision), 재현율 (Recall), AUC, MAE, RMSE 등과 같은 여러 지표 (Metric)들을 사용합니다 ([마이크로소프트 문서][ms-docs-ml-algorithm-evaluation-model-metrics]에서 자세한 내용을 영문으로 확인하실 수 있습니다). Fairlearn에서는 공정성을 평가하기 위해 이와 같은 지표들을 기반으로 1) 민감한 피처를 선택하고 2) 성능과 예측 차이에 따른 평가 결과를 확인하는 라이브러리 함수를 제공합니다. 또한, 대시보드를 Jupyter 노트북에서 확인하여 만든 머신러닝 모델이 공정한지를 보다 쉽게 확인도 가능합니다. 참고로, 애저에서는 뒤에서 설명하는 [애저 머신러닝 서비스에서 Jupyter 노트북을 쉽게 실행][ms-azure-ml-jupyter]할 수 있습니다.
![Fairlearn - 모델 평가](https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/fairlearn-ml-model-assessment.jpg)
그렇다면, 이제부터는 실제 데이터셋으로 머신러닝 모델을 트레이닝할 때 Fairlearn을 어떻게 사용하는지 살펴보겠습니다. [OpenML에 업로드된 성인 인구조사 데이터셋][openml-adult-census-1590]을 활용해 보겠습니다. [Scikit-learn에서 제공하는 fetch_openml() 함수][scikit-learn-fetch_openml]를 통해 데이터셋 숫자인 1590만 알면 아래 코드 예제와 같이 쉽게 데이터셋을 불러올 수 있습니다. 연간 소득이 5만 달러를 넘는지에 대한 여부를 판단하는 예측 모델을 만들고자 합니다. 여기서 한 가지, 머신러닝 모델 트레이닝을 할 때 성별, 인종과 같은 민감한 피처를 제외하는 것이 좋습니다. 앞에서 언급하였던 할당 피해를 방지할 수 있을 것입니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=02-fetch_openml.py
그리고 머신러닝 모델을 트레이닝할 때, 일반적으로 평가를 위해 데이터를 트레이닝 셋과 테스트 셋으로 분리합니다. 예제에서는 30%를 테스트 셋으로 배정하였으며, 인덱스를 정리하는 짧은 코드를 추가하였습니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=03-dataset-split.py
데이터 준비가 이제 다 끝났으니, 모델 트레이닝 및 예측이 가능하겠죠? 예제에서는 [Scikit-learn에서 제공하는 분류를 위한 의사결정트리인 DecisionTreeClassifier][scikit-learn-tree]를 사용해 보겠습니다. 구체적인 `min_samples_leaf` 및 `max_depth` 값 등을 튜닝하는 것도 중요하겠지만, 본 포스트에서는 AI 공정성을 위한 평가를 어떻게 하는지에 집중하도록 하겠습니다. 테스트셋으로 예측한 결과들을 정확도, 정밀도, 재현율 등 지표를 통해 확인할 수 있으나, 해당 지표 자체만으로 머신러닝 모델이 공정성을 얼마나 확보하였는지를 이해하기에는 쉽지 않은 것 같습니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=04-training.py
Jupyter 노트북에서 Fairlearn 라이브러리에서 제공하는 `FairlearnDashboard()` 함수를 사용하면 대시보드를 불러올 수 있습니다. 함수를 호출할 때, 민감한 피처에 대한 데이터셋과 예측 모델을 지정하면 민감한 피처와 측정하고자 하는 성능 항목을 선택하여 성능과 예측에 대한 차이 (disparity)를 확인하는 대시보드를 제공합니다. 각 민감한 피처 값 유형에 따라 살펴보고자 하는 지표가 과소/과대 예측이 되었는지에 대한 성능 차이 및 데이터 선택에 따른 공정성이 있는지에 대한 예측 차이를 확인할 수 있습니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=05-fairlearn-dashboard.py
## MLOps 실현을 위한 애저 머신러닝 서비스에 모델 & 실험 업로드 ##
방대한 양의 데이터에서부터 머신러닝 모델이 여러 트레이닝 및 예측, 튜닝 과정을 걸쳐 완성되어도, 실제 서비스화를 위해서는 성능 최적화와 함께 트레이닝 데이터 및 모델에 대한 모니터링 및 관리 등 많은 과정이 있습니다. [애저 머신러닝 서비스][ms-azure-ml-service-page]는 사람, 프로세스, 제품이 함께 결합하여 최종 고객에게 가치를 지속적으로 전달한다는 DevOps를 넘어서, 이러한 전반적인 머신러닝을 고려한 MLOps 실천 사례 경험을 반영한 애저 서비스입니다. 복잡한 데이터셋 변화와 발전하는 머신러닝 모델에 대한 추적 뿐만 아니라, 보다 빠르게 머신러닝 모델을 빌드하고 학습, 배포할 수 있는 다양한 생산적인 환경을 개발자와 데이터 과학자에게 제공하고 있습니다. (MLOps에 대한 자세한 내용은 마이크로소프트에서 AI 플랫폼을 담당하시는 [한석진님][linkedin-seokjin-han]이 공유주신 [MLOps 101 영상][yt-mlops-101-seokjin]을 통해 확인하실 수 있습니다.)
- 실험: 머신러닝을 하는 과정은 1) 데이터셋 준비 2) 모델 트레이닝을 위한 피처 선택 3) 알고리즘 선택 및 파라미터 지정 4) 트레이닝 수행이라는 과정을 거쳐 하나의 머신러닝 모델이 만들어집니다. 이를 애저 머신러닝 서비스에서는 실험이라는 단위로 추상화를 하였습니다. 예를 들어 위 예제에서 테스트셋 비율을 30%로, DecisionTreeClassifier를 사용하여 `min_samples_leaf` 값은 10으로, `max_depth` 값은 4로 지정하였는데, 이 전체를 실행했던 과정을 하나의 실험으로 보는 것입니다. 같은 실험을 반복해서 실행하기도 하며, 데이터셋을 바꿔서 다시 실행하거나, `max_depth` 값을 3으로 바꾸어서 트레이닝을 한다면 또 다른 실험 단위를 실행할 수도 있겠죠.
- 모델: 실험 과정을 거쳐, 반복 & 재사용이 가능한 모델이라는 단위도 생각해볼 수 있습니다. 모델은 1) 어떤 머신러닝 알고리즘을 선택하는지 2) 어떤 파라미터 값을 사용하는지에 대한 내용을 가지는 추상화 단위입니다. 이렇게 모델을 실험과 따로 분리하여 살펴봄으로써, 동일한 모델이 서로 다른 데이터셋을 사용하여 실험할 때 어떤 결과 차이를 보이는지 확인할 수가 있을 것입니다.
무엇보다 애저 머신러닝 서비스는 책임있는 ML을 위한 머신러닝 모델 **이해**, 데이터 **보호**, 전체 과정 **제어**를 위한 쉬운 도구 연계를 염두한 서비스라는 특징을 가지고 있습니다. 위에서 살펴본 Fairlearn의 경우, AI 공정성을 보장하기 위한 머신러닝 모델 이해와 관련이 있는데요, 애저 머신러닝 서비스에서는 Fairlearn 오픈소스와 연동이 가능하여 애저 머신러닝 서비스 UI에서 모델과 실험 단위로 Fairlearn 대시보드를 살펴볼 수 있습니다. 이제부터는 애저 머신러닝 서비스에서 실험과 모델이 어떻게 관리되는지 간단히 살펴보고, 위에서 만든 머신러닝 모델을 애저 머신러닝 서비스에 모델 및 실험 단위로 업로드하여 책임있는 ML을 위해 MLOps를 어떻게 활용할 수 있는지를 살펴보고자 합니다.
업로드를 위해서는 애저 머신러닝 서비스라는 리소스를 만들어야겠죠? 애저 포털에서 애저 머신러닝 서비스를 만드는 방법은 [마이크로소프트 Learn에 설명된 머신러닝 소개 및 작업 영역][ms-learn-azure-ml-workspace] 내용을 참고하실 수 있습니다. 애저 머신러닝 서비스를 쉽게 연결하려면 [azureml-sdk][azureml-sdk-pypi] 및 관련 라이브러리가 필요합니다. 애저 머신러닝 노트북에 대한 한 예제 파일에 나와있는 아래 내용을 통해 의존성있는 라이브러리 목록을 확인할 수 있습니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=05-2-upload-fairness-dashboard.yml
애저 머신러닝 서비스 접속 구성을 담고 있는 `config.json` 파일이 필요합니다. 해당 파일은 애저 머신러닝 서비스 리소스를 애저에서 만든 다음 받으셔서 로컬 및 다른 개발 환경에서 연결하실 수도 있으며, 아니면 애저 머신러닝 스튜디오를 실행한 후, Notebooks 탭에서 Jupyter 노트북을 작성하면 추가한 컴퓨팅 자원에서 바로 `config.json` 파일을 불러오실 수도 있습니다.
![Azure Machine Learning Service - config.json 다운로드](https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/azure-ml-download-config.png)
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=06-azureml-config.py
그 다음으로, 애저 머신러닝 서비스에 모델을 등록합니다. 이때, 등록할 모델은 이전에 [Scikit-learn에서 제공하는 분류를 위한 의사결정트리인 DecisionTreeClassifier][scikit-learn-tree]를 사용하였고, 구체적인 `min_samples_leaf` 및 `max_depth` 값을 지정하였던, 개체 인스턴스에 대응합니다. 모델을 등록하면 모델 ID 값을 반환하는데, 이 값은 바로 다음에 실험을 추가할 때 사용하므로 변수에 저장해두고자 합니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=07-azure-model-reg.py
애저 머신러닝 서비스에서 Fairlearn에서 실행했던 결과를 포함해 실험으로 관리할 수 있습니다. 이렇게 관리를 하려면 Fairlearn으로 실행한 결과를 계산하여 저장해 두고 있어야겠죠. [fairlearn.metrics][fairlearn-metrics-package] 패키지에 있는 `_create_group_metric_set()` 함수를 통해 미리 계산한 결과를 저장합니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=08-fairlearn-metric-calc.py
다음으로 애저 머신러닝 서비스에 실험 단위로 업로드합니다. [azureml.core.Experiment 클래스][ms-azureml-core-experiment-class] 인스턴스를 생성한 후, 업로드를 진행합니다. 이 때, 바로 이전에 Fairlearn에서 계산된 결과를 Experiment 인스턴스에 같이 전달합니다.
https://gist.github.com/ianychoi/3850d7c34c76aa2e6219db698ed57241?file=09-azureml-upload.py
이제, 애저 머신러닝 서비스에서 어떻게 보이는지 확인해보면 되겠죠? 애저 머신러닝 스튜디오에서 실험 -> 목록 선택 -> 실행 단위를 선택한 다음, 공정성 탭에 들어가면 확인하실 수 있습니다. 코드 예제와 함께 단계별로 살펴보았는데요, 애저 머신러닝 서비스를 사용한다면 공정성에 대한 부분을 개발자는 Fairlearn으로 관련 지표를 계산하여 업로드하며, 관리자 / 머신러닝 종사자는 애저 머신러닝 스튜디오 UI에서 실험 및 모델 단위로 공정성에 대한 지표를 UI를 통해 쉽게 확인할 수가 있습니다. 또한, 모니터링이나 전체 머신러닝 프로세스를 코드로 잘 관리한다면, 책임있는 ML을 MLOps 실천 사례에 따라 실현할 수 있으며, 구성원 모두 및 외부에도 보다 신뢰있는 AI라고 할 수 있을 것입니다.
![애저 머신러닝 서비스 - 스튜디오에서 공정성 확인](https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/azure-ml-studio-fairness.png)
이와 같이, 머신러닝 솔루션이 공정하고 예측의 가치를 이해하고 설명하기 쉽도록 하려면 개발자와 데이터 과학자가 AI 시스템의 공정성을 평가하고 관찰된 불공정 문제를 완화하는 데 사용할 수 있는 프로세스를 도구와 함께 구축하는 것이 중요합니다. 2021년 1월 개최된 CES 2021에서 마이크로소프트 최고법률책임자인 브래드 스미스는 "기술에는 양심이 없지만 사람에게는 있다"며 "기술이 어떤 방식으로 쓰이든 그것은 사람의 책임"이라고 이야기하였습니다. 이번 포스트에서 소개된 머신러닝 도구 및 실천사례가 잘 활용되어, 보다 공정한, 그리고 편향없는 AI와 함께 모두 지낼 수 있기를 희망합니다.
> 이 포스트에 쓰인 예제 Jupyter 노트북 코드를 [여기](https://github.com/ianychoi/Azure-oss-hands-on-labs/blob/master/06-Azure-ML-with-Fairlearn/fairlearn-quickstart-on-AzureMLStudio.ipynb)에서 확인해 보세요!
그리고 영문으로 되어 있지만, Fairlearn에 대해 자세하게 설명한 많은 내용이 있으며, 해당 내용을 참고하여 본 포스트를 작성하였습니다:
- [Fairlearn - A Python package to assess AI system's fairness][ms-tc-fairlearn]
- [Microsoft Docs: What is responsible machine learning?][ms-docs-responsible-ml]
- [Fairlearn: A toolkit for assessing and improving fairness in AI][ms-research-fairlearn]
- [Creating Fair Machine Learning Models with Fairlearn][towardsdatascience-tutorial-fairness]
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][ms-az-account-free]
* 애저 머신러닝 서비스에 관심이 있으신가요? ➡️ [애저 머신러닝 서비스 살펴보기][ms-azure-ml-service-page]
* 애저에서 머신러닝을 한다는 것은 무엇일까요? ➡️ [한석진님이 쓰신 기고를 살펴보세요][seokjin-azure-and-ml]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms-learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt-msdevkr]
[ms-az-account-free]: https://azure.microsoft.com/ko-kr/free/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-azure-ml-service-page]: https://azure.microsoft.com/ko-kr/services/machine-learning/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-learn]: https://docs.microsoft.com/ko-kr/learn/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[yt-msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[fairlearn-website]: https://fairlearn.github.io
[fairlearn-github]: https://github.com/fairlearn/fairlearn
[fairlearn-pypi]: https://pypi.org/project/fairlearn/
[openml-adult-census-1590]: https://www.openml.org/d/1590
[scikit-learn-fetch_openml]: https://scikit-learn.org/stable/modules/generated/sklearn.datasets.fetch_openml.html
[scikit-learn-tree]: https://scikit-learn.org/stable/modules/tree.html
[scikit-learn-model-evaluation]: https://scikit-learn.org/stable/modules/model_evaluation.html
[yt-mlops-101-seokjin]: https://www.youtube.com/playlist?list=PLDZRZwFT9Wku509LgbJviEcHxX4AYj3QP
[azureml-sdk-pypi]: https://pypi.org/project/azureml-sdk/
[fairlearn-metrics-package]: https://fairlearn.github.io/v0.5.0/api_reference/fairlearn.metrics.html
[towardsdatascience-tutorial-fairness]: https://towardsdatascience.com/a-tutorial-on-fairness-in-machine-learning-3ff8ba1040cb
[seokjin-azure-and-ml]: http://it.chosun.com/site/data/html_dir/2020/08/02/2020080200103.html
[linkedin-soeun-park]: https://www.linkedin.com/in/soeun-park-b55613176/
[linkedin-seokjin-han]: https://www.linkedin.com/in/seokjinhan/
[ms-ai-approach]: https://www.microsoft.com/ko-kr/ai/our-approach?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-build-korea-2020-azure-track]: https://info.microsoft.com/AP-AzureINFRA-WBNR-FY21-07Jul-23-BuildKorea-SRDEM31279_LP02OnDemandRegistration-ForminBody.html?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-docs-ml-algorithm-evaluation-model-metrics]: https://docs.microsoft.com/en-us/azure/machine-learning/algorithm-module-reference/evaluate-model#metrics?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-learn-azure-ml-workspace]: https://docs.microsoft.com/ko-kr/learn/modules/intro-to-azure-machine-learning-service/2-azure-ml-workspace?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-azureml-core-experiment-class]: https://docs.microsoft.com/ko-kr/python/api/azureml-core/azureml.core.experiment(class)?view=azure-ml-py&ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-tc-fairlearn]: https://techcommunity.microsoft.com/t5/educator-developer-blog/fairlearn-a-python-package-to-assess-ai-system-s-fairness/ba-p/1402950?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-docs-responsible-ml]: https://docs.microsoft.com/en-us/azure/machine-learning/concept-responsible-ml?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-research-fairlearn]: https://www.microsoft.com/en-us/research/publication/fairlearn-a-toolkit-for-assessing-and-improving-fairness-in-ai/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-azure-ml-jupyter]: https://docs.microsoft.com/ko-kr/azure/machine-learning/how-to-run-jupyter-notebooks/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi
[ms-azure-ml-docs]: https://docs.microsoft.com/ko-kr/azure/machine-learning/?ocid=AID3027813&WT.mc_id=aiml-13829-yechoi

249
content/posts/2021/02/2021-02-02-websub-to-eventgrid-via-cloudevents-and-beyond.md
Просмотреть файл

@ -1,249 +0,0 @@
---
title: "WebSub에서 CloudEvents를 통해 이벤트그리드로 전환하고 다양한 소셜 미디어로 알리기"
slug: websub-to-eventgrid-via-cloudevents-and-beyond
description: "이 포스트는 유튜브 채널에 새 비디오가 올라왔을 때, 이 이벤트를 CloudEvents 형식으로 변환해서 애저 이벤트그리드로 발행한 후, 로직 앱을 이용해 다양한 소셜 미디어로 확산시키는 일련의 워크플로우에 대해 다룹니다."
date: 2021-02-02
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-00-ko.png
image_caption: 유튜브 WebSub에서 CloudEvents를 거쳐 이벤트그리드로 변환하기
author: justin-yoo
category: Azure
tags: azure-eventgrid, azure-logicapps, azure-functions, cloudevents
canonical_url: https://blog.aliencube.org/ko/2021/01/27/websub-to-eventgrid-via-cloudevents-and-beyond/
featured: false
---
유튜브 채널을 하나 운영하고 있다고 가정하겠습니다. 새 비디오가 하나 업로드 되었을 때, 이를 내가 운영하는 다른 소셜 미디어에 함께 노출 시키고 싶다면 어떻게 하면 좋을까요? 이미 시장에는 이를 위한 다양한 유료 도구들이 많이 나와 있고, 소셜 미디어 마케팅을 전문으로 하는 회사도 많습니다. 게다가 그런 회사의 경우는 자체적인 솔루션도 갖고 있으니, 이를 이용하면 쉽겠죠. 그런데, 만약 여러 가지 이유로 내가 직접 이런 도구들을 만들어서 사용하고 싶다면 어떨까요? 기존의 제품/서비스들이 제공하는 기능이 내 용도와는 다르다면 어떻게 할까요? 이럴 경우에는 한 번 직접 만들어 보는 것도 좋습니다.
이 포스트에서는 유튜브에 새 비디오가 올라올 때부터 다른 소셜 미디어에 노출 시킬 때 까지의 전체적인 워크플로우를 [애저 이벤트그리드][az evtgrd], [애저 펑션][az fncapp], [애저 로직 앱][az logapp] 등의 다양한 애저 서버리스 서비스를 통해 구현해 보기로 하겠습니다.
> 구현한 솔루션의 소스 코드는 이곳 [깃헙 리포지토리][gh sample]에서 다운로드 받아 보세요!
## 유튜브 알림 구독 ##
유튜브에서는 [웹훅 알림][yt webhook]을 위해 [PubSubHubbub][pshb]이라는 규약을 사용합니다. 이 규약은 현재 [WebSub][websub]이라는 이름으로 [2016년에 최초 가안][websub wd 1]이 나온 이후 2018년에 웹표준으로 지정됐죠.
유튜브의 모든 채널은 이미 구글이 운영하는 [WebSub 허브][yt websub hub]에 등록이 되어 있으므로, 특정 채널에 대한 비디오 업데이트 알림을 받기 위해서는 이 허브에 [구독 신청][yt websub sub]만 하면 됩니다. 아래 그림과 같이 메시지 처리기(Message Handler) URL을 넣고, 유튜브 채널 URL을 입력한 후 `Do It!` 버튼을 클릭하면 등록이 끝납니다.
![유튜브 WebSub 구독하기][image-01]
단, 여기서 주의해야 할 점이 하나 있습니다. 메시지 처리기 URL로 호출하는 애플리케이션은 구독 등록이 끝남과 동시에 [유효성 검증][websub verification]을 위한 API 호출을 받게 되는데, 이를 통과해야만 구독 절차가 완전히 끝나게 됩니다. 이 유효성 검증을 통과하지 못하면 아무리 구독을 해도 알림을 받을 수 없습니다.
## WebSub 구독 요청 검증 ##
WebSub 구독 요청에 대한 검증을 위해서 메시지 처리기 URL은 검증 요청이 들어왔을 때 아래와 같은 내용을 처리해 줘야 합니다.
* 검증 요청은 `GET` 메소드로 아래와 같은 쿼리스트링 파라미터를 전송하는데요,
* `hub.mode`: `subscribe` 문자열
* `hub.topic`: 구독하고자 하는 유튜브 채널 URL
* `hub.challenge`: WebSub 허브에서 생성한 임의의 문자열로 구독 요청에 대한 검증에 사용합니다
* `hub.lease_seconds`: 구독 요청 유효 기간으로 이 기간 안에 구독 요청에 대한 검증을 통과하지 못하면 이 요청은 자동으로 폐기됩니다
* 검증 요청에 대한 응답으로 응답 개체 본문에 `hub.challenge` 값만 추가해서 200 응답 코드와 함께 반환합니다
* 응답 개체 본문에 `hub.challenge` 이외의 다른 값이 들어가면 이 응답은 WebSub 허브에서 유효한 응답으로 처리하지 않습니다
이 구독 요청 검증 로직을 [애저 펑션][az fncapp]으로 구현해 보면 대략 아래와 같습니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=01-callback-1.cs
위와 같이 메시지 처리를 위한 구독 요청 검증에 성공했다면, WebSub 허브는 앞으로 계속해서 유튜브 채널에 새 비디오가 올라올 때마다 알림 이벤트를 메시지 처리기 쪽으로 보내게 되죠.
## WebSub 알림 피드 변환 ##
WebSub 역시도 어디까지나 [발행자/구독자(Publisher/Subscriber; Pub/Sub) 패턴][eip pubsub]을 따르기 때문에 크게 새로울 것은 없습니다. 다만, WebSub으로 주고 받는 데이터는 ATOM 피드 형식을 따르기 때문에 구독자가 ATOM 피드 형식의 XML 문서를 해석해서 처리할 수만 있으면 됩니다. 그런데, 이벤트 구독자 쪽에 ATOM 피트 형태의 XML 데이터를 강제하는 것은 이벤트 발행자와 구독자 사이에 강한 커플링을 유도합니다. 구독자가 어떤 식으로 데이터를 처리할 지 알 수 없는 상황에서 이를 강제하는 것은 바람직하지 않기 때문에, 중간에 표준 데이터 형식 혹은 캐노니컬 데이터 형식으로 바꿔주는 것이 좋습니다.
따라서, 여기서는 [CloudEvents][ce] 형식을 이용해서 캐노니컬 데이터 형식으로 변환합니다. 이 포스트에서는 이 캐노니컬 데이터 변환 과정을 두 단계로 나눴는데, 하나씩 설명해 보기로 하겠습니다.
### 1. WebSub 알림 피드 ➡️ CloudEvents 형식 변환 ##
이 첫번째 단계의 목적은 WebSub에 대한 의존성을 끊어내는 데 있습니다. 따라서, WebSub에서 전달된 ATOM 피드의 XML 데이터를 별다른 변환 없이 그대로 CloudEvents 형식에 담습니다. 유튜브에 새 비디오가 올라왔을 때 WebSub을 통해 받는 알림 피드의 데이터는 대략 아래와 비슷하게 생겼습니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=02-websub-feed.xml
이 요청 데이터를 아래와 같이 단순 문자열로 받아 냅니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=03-callback-2.cs
이와 더불어 알림 피드 요청 헤더는 아래와 같은 값을 포함하고 있는데요,
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=04-websub-request-header.txt
이 헤더 값을 아래와 같이 추출해 냅니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=05-callback-3.cs
그리고 아래와 같이 이벤트 타입과 이벤트 데이터 타입을 설정합니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=06-callback-4.cs
[지난 포스트][post prev 1]에서 언급한 바와 같이 현재 [애저 펑션][az fncapp]의 [이벤트그리드 바인딩][az fncapp binding evtgrd]은 [CloudEvents 형식을 아직 지원하지 않기 때문에][az evtgrd ce], 아래와 같이 펑션 코드 안에서 직접 처리를 해 줘야 합니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=07-callback-5.cs
여기까지 해서, WebSub에서 받아온 이벤트 데이터를 그대로 CloudEvents를 이용한 캐노니컬 형식으로 변환해서 애저 이벤트그리드로 다시 보냅니다. 이렇게 보내진 CloudEvents 형식 데이터는 아래와 같습니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=08-cloudevents-from-websub.json
여기까지 해서 아래와 같은 변환 절차가 끝났습니다.
![유튜브 WebSub에서 애저 이벤트그리드로 변환하기][image-02]
이제 다음 단계로 넘어가도록 하지요.
### 2. WebSub XML 데이터 가공 ##
두 번째 단계에서는 WebSub XML 데이터를 소셜 미디어 확산을 위해 필요한 데이터 형태로 가공하는 일을 합니다.
앞서 받아온 WebSub 데이터에는 비디오 ID, 채널 ID 등과 같은 제한적인 정보만 들어있습니다. 따라서, 이를 이용해서 구체적인 정보를 YouTube API를 통해 받아와야 다음 단계의 소셜 미디어 노출에 필요한 데이터를 가공할 수 있습니다. [애저 이벤트그리드][az evtgrd]에 발행된 이벤트 데이터를 받아 처리하려면 우선 이벤트 처리기를 등록해야 합니다. 이 등록 과정도 앞서 WebSub 구독 등록 절차와 같이 [유효성 검사][az evtgrd delivery auth]가 필요합니다. 그런데, 이벤트 처리기로 [애저 로직 앱][az logapp]을 선택하면 이 유효성 검사 부분을 내부적으로 처리를 해주기 때문에 여기서는 로직 앱을 이용하면 편리합니다.
로직 앱 이벤트 처리기에서 처음 하는 일은 이벤트그리드에서 받아온 이벤트 데이터가 내가 필요로 하는 데이터인지를 확인하는 것입니다. 내가 필요로 하는 이벤트 데이터라면 채널 정보와 이벤트 타입이 맞아야 합니다. 내가 필요로 하는 데이터가 아니라면 더이상 로직 앱 워크플로우를 실행하지 않고 멈추게 됩니다.
![이벤트 데이터 확인하기][image-03]
내가 처리하고자 하는 이벤트 데이터라면 이를 애저 펑션으로 보내 데이터를 가공합니다.
![이벤트 데이터 가공하기][image-04]
애저 펑션에서는 유튜브 API를 이용해서 비디오의 구체적인 정보를 받아와 가공한 후 다시 로직 앱으로 데이터를 반환합니다. 애저 펑션이 반환하는 데이터는 대략 아래와 같이 생겼습니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=09-video-details.json
여기까지 해서 대략 이벤트 데이터를 가공하는 작업이 끝났습니다.
![이벤트 데이터 가공하기 다이어그램][image-05]
## 소셜 미디어 노출 ##
이 로직 앱이 해야 하는 나머지 일은 다른 소셜 미디어 확산 도구들이 이 데이터를 받아 처리할 수 있게끔 해 주는 것인데요, 여기에는 두 가지 방법이 있습니다.
* 이 로직 앱에 직접 다른 소셜 미디어 노출을 위한 API를 연결하는 것
* 소셜 미디어에 노출시키기 위한 도구들이 이용할 수 있게끔 이벤트를 던지는 것
첫 번째 방법은 의존성이 생깁니다. 만약, 새로운 도구가 추가된다거나, 기존 도구를 제거한다거나 하면 이 로직 앱을 반드시 수정해야 합니다. 이는 유지보수 측면에서는 그다지 좋은 방법은 아니죠. 반면에 두 번째 방법은 다시 이벤트를 생성해서 뿌리면, 다른 소셜 미디어 확산 도구들이 각자 알아서 이 이벤트를 받아 처리하면 되기 때문에 의존성을 없앨 수 있습니다. 복잡도가 한 단계 증가하기는 하지만, 유지보수 측면에서는 굉장히 편리합니다. 따라서, 여기서는 두 번째 방법을 선택했습니다.
### 1. 이벤트그리드로 가공된 데이터 발행하기 ###
이벤트그리드로 다시 이벤트 데이터를 발행하기 위해서는 우선 CloudEvents 형식으로 데이터를 구성해야 합니다. 앞서 받아온 데이터는 말 그대로 데이터를 가공만 한 것이고, 아래 로직 앱 액션에서 CloudEvents 형식으로 데이터를 가공합니다.
![CloudEvents 형식으로 변환하기][image-06]
마지막으로 이 이벤트 데이터를 애저 이벤트그리드로 보내는 액션을 만들어 보면 아래와 같습니다. 아래 그림에 보면 헤더 영역에 `ce-`로 시작하는 다양한 메타 데이터가 보이는데, 이는 CloudEvents 데이터 전송시 [교차 검증][ce binding http]과 관련된 규약 때문입니다.
![이벤트그리드로 데이터 보내기][image-07]
이렇게 이벤트그리드로 데이터를 보내고 나면 개별 소셜 미디어 처리기에서 이 이벤트 데이터를 처리할 준비가 된 셈인데요, 다음에서 개별 소셜 미디어 처리기가 어떻게 대응하는 지 볼 수 있습니다.
![이벤트그리드로 데이터 보내기 다이어그램][image-08]
### 2. 개별 소셜 미디어 처리기 ###
앞서 소셜 미디어에서 처리할 수 있을 정도로 데이터를 가공해서 이벤트그리드로 보냈다면, 개별 소셜 미디어 처리기는 각자 상황에 맞게 이 데이터를 받아 처리하면 됩니다. 이벤트그리드에서 받아온 데이터는 대략 아래와 같이 생겼습니다.
https://gist.github.com/justinyoo/cb04844306f9a44dcdcaaa70a6a55326?file=10-video-details-to-cloudevents.json
#### 트위터 ####
로직 앱은 [트위터 커넥터][az logapp connector twitter]를 자체 제공하고 있으므로 별도로 API 호출을 위한 코드를 만들 필요가 없습니다. 따라서, 아래와 같이 간단하게 호출하면 됩니다.
![트위터 포스팅하기][image-09]
#### 링크드인 ####
로직 앱은 [링크드인 커넥터][az logapp connector linkedin]도 자체 제공하고 있으므로 별도로 API 호출을 위한 코드를 만들 필요가 없습니다. 따라서, 아래와 같이 간단하게 호출하면 된다.
![링크드인 포스팅하기][image-10]
#### 페이스북 ####
반면에 로직 앱의 [페이스북 커넥터][az logapp connector facebook]는 더이상 사용할 수 없습니다. 따라서, [오픈소스로 풀린 커스텀 커넥터][az logapp connector facebook custom]를 이용하거나 다른 방법을 쓰는 수 밖에 없는데, 마침 [IFTTT][ifttt]에서 [페이스북 페이지로 포스팅][ifttt facebook page]하는 커넥터를 사용할 수 있으니, 이를 이용하기로 하겠습니다.
![IFTTT 페이스북 커넥터][image-11]
로직 앱 관점에서는 IFTTT 쪽으로 HTTP 요청만 보내면 되기 때문에 별다른 어려움은 없습니다. 다만, `value1`, `value2`, `value3` 어트리뷰트만 사용 가능하다는 점 주의하세요!
![페이스북 포스팅하기][image-12]
실제로 IFTTT 쪽에서 이 요청을 받아 처리한 결과는 아래와 같이 보입니다.
![IFTTT에서 페이스북 포스팅하기][image-14]
이렇게 해서 트위터, 링크드인, 페이스북 등 소셜 미디어로 새 유튜브 비디오가 올라왔을 경우 포스팅하는 방법을 구현해 보았습니다.
![E2E 이벤트 처리 절차][image-13]
---
지금까지 [애저 이벤트그리드][az evtgrd], [애저 펑션][az fncapp], [애저 로직 앱][az logapp] 등을 사용해서 특정 유튜브 채널에 새 비디오가 올라왔을 때, 이를 WebSub 이벤트로 받으면, 1) 이를 CloudEvents 형식으로 변환해서 애저 이벤트그리드로 보내고, 2) 필요한 형태로 변환한 후, 3) 원하는 소셜 미디어로 포스팅하는 전체적인 워크플로우를 구현해 보았습니다. 각각의 단계는 모두 디커플링을 시켜놓았기 때문에 유지 보수 차원에서 의존성을 고려할 필요가 없을 뿐더러, 향후 새로운 소셜 미디어 채널로 포스팅을 계획할 경우에도 손쉽게 추가할 수 있는 구조를 만들었습니다.
만약 이런 온라인 컨텐츠 마케팅을 기획하고 있다면 이와 비슷한 형태로 애플리케이션을 구현해 보는 것도 좋은 시도가 될 것입니다. 또한, 이를 통해 전체적인 클라우드 시스템 아키텍처를 구성하는 방법에 대해서도 고민해 볼 수 있을 것입니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-02-ko.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-04.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-05-ko.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-06.png
[image-07]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-07.png
[image-08]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-08-ko.png
[image-09]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-09.png
[image-10]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-10.png
[image-11]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-11.png
[image-12]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-12.png
[image-13]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-13-ko.png
[image-14]: https://sa0blogs.blob.core.windows.net/aliencube/2021/01/websub-to-eventgrid-via-cloudevents-and-beyond-14.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[post prev 1]: /developerkorea/posts/2021/01/19/cloudevents-for-azure-eventgrid-via-azure-functions/
[gh sample]: https://github.com/devrel-kr/youtube-websub-subscription-handler
[pshb]: https://github.com/pubsubhubbub/PubSubHubbub
[websub]: https://www.w3.org/TR/websub/
[websub wd 1]: https://www.w3.org/TR/2016/WD-pubsub-20161020/
[websub verification]: https://indieweb.org/How_to_publish_and_consume_WebSub#The_hub_verifies_the_subscription_request
[eip pubsub]: https://www.enterpriseintegrationpatterns.com/patterns/messaging/PublishSubscribeChannel.html
[yt webhook]: https://developers.google.com/youtube/v3/guides/push_notifications
[yt websub hub]: https://pubsubhubbub.appspot.com/
[yt websub sub]: https://pubsubhubbub.appspot.com/subscribe
[ce]: https://cloudevents.io/
[ce binding http]: https://github.com/cloudevents/spec/blob/master/http-protocol-binding.md#3-http-message-mapping
[az evtgrd]: https://docs.microsoft.com/ko-kr/azure/event-grid/overview?WT.mc_id=devops-dotnet-12869-juyoo&ocid=AID3027813
[az evtgrd ce]: https://docs.microsoft.com/ko-kr/azure/event-grid/cloudevents-schema?WT.mc_id=devops-dotnet-12869-juyoo&ocid=AID3027813#use-with-azure-functions
[az evtgrd delivery auth]: https://docs.microsoft.com/ko-kr/azure/event-grid/security-authentication?WT.mc_id=devops-dotnet-12869-juyoo&ocid=AID3027813
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[az logapp connector twitter]: https://docs.microsoft.com/ko-kr/connectors/twitter/?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[az logapp connector linkedin]: https://docs.microsoft.com/ko-kr/connectors/linkedinv2/?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[az logapp connector facebook]: https://docs.microsoft.com/ko-kr/connectors/facebook/?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[az logapp connector facebook custom]: https://github.com/microsoft/PowerPlatformConnectors/tree/master/custom-connectors/Facebook
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[az fncapp binding evtgrd]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-event-grid?WT.mc_id=dotnet-12869-juyoo&ocid=AID3027813
[ifttt]: https://ifttt.com/
[ifttt facebook page]: https://ifttt.com/facebook_pages

275
content/posts/2021/02/2021-02-09-creating-custom-connector-from-azure-functions-with-openapi.md
Просмотреть файл

@ -1,275 +0,0 @@
---
title: "애저 펑션에 Open API 확장 기능을 이용해 파워 플랫폼용 커스텀 커넥터 곧바로 생성하기"
slug: creating-custom-connector-from-azure-functions-with-swagger
description: "이 포스트에서는 애저 펑션 API에 Open API 확장 기능을 통합해서 파워 플랫폼에 사용할 커스텀 커넥터를 생성하는 방법에 대해 알아봅니다."
date: 2021-02-09
image: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-00.png
image_caption: 파워 플랫폼에 Open API 확장 기능을 연동시킨 애저 펑션 API로 커스텀 커넥터를 생성해서 연결
author: justin-yoo
category: Power Platform
tags: azure-functions, power-platform, openapi, custom-connector
canonical_url: https://blog.aliencube.org/ko/2020/07/15/creating-custom-connector-from-azure-functions-with-swagger/
featured: false
---
[애저 펑션을 위한 Open API 확장 기능][gh openapi]을 사용하면 좋은 점 중에 하나가 바로 [애저 펑션][az func]으로 API를 개발할 때 이 API의 발견가능성(discoverability)을 높여준다는 것입니다. 따라서, 이를 이용하면 굉장히 손쉽게 [애저 API 관리도구][az apim]에 연동시킬 수 있습니다. 또한 [애저 로직 앱][az logapp]이나 [파워 플랫폼][power platform] 에서 사용하는 [커스텀 커넥터][az cuscon] 역시도 쉽게 생성할 수 있는데요, 이 포스트에서는 이 Open API 확장 기능을 이용해 애저 펑션에 Open API 문서를 통합한 후, 이를 이용해 커스텀 커넥터를 만들어 보는 방법에 대해 알아봅니다.
## 샘플 애저 펑션 코드 ##
우선 기본적인 뼈대만 갖춘 애저 펑션 샘플 코드는 아래와 같습니다. `/feeds/items`와 `/feeds/item` 이라는 두 개의 엔드포인트를 나타냅니다 (line #7, 15).
https://gist.github.com/justinyoo/2b4bc731ff8f2cdb5e80e28bd7dff9e7?file=01-feed-reader.cs&highlights=7,15
이를 실행시키면 당연하겠지만, 아래와 같이 두 개의 엔드포인트를 확인할 수 있습니다.
![애저 펑션 엔드포인트][image-01]
## NuGet 패키지 설치 ##
애저 펑션에 Open API 문서를 손쉽게 생성해 주는 NuGet 패키지를 설치합니다.
https://gist.github.com/justinyoo/2b4bc731ff8f2cdb5e80e28bd7dff9e7?file=02-install-nuget-package-2.sh
## 보일러플레이트 코드 설치 ##
사실, 위 NuGet 패키지를 설치하면 보일러플레이트 코드가 자동으로 설치가 됩니다. 따라서, 이 부분은 딱히 고민할 부분이 없습니다. 앱을 빌드하고 실행시켜볼까요? 아래 그림과 같이 추가 엔드포인트가 보일텐데, 이 세 엔드포인트가 바로 Open API와 관련한 것들입니다.
![애저 펑션 Open API 엔드포인트][image-02]
이제 이 중에서 `http://localhost:7071/api/swagger/ui`를 브라우저에서 실행시켜 보면 아래와 같습니다.
![엔드포인트 없는 애저 펑션 Swagger UI 페이지][image-03]
일단 Swagger UI 페이지는 나왔지만, 아직 엔드포인트를 설정하지 않았기 때문에 자세한 내용은 보이질 않습니다.
## Open API 확장을 위한 데코레이터 지정 ##
이제 아래와 같이 각각의 엔드포인트에 데코레이터를 이용해 Open API 설정을 해 보겠습니다. `OpenApiOperationAttribute`, `OpenApiSecurityAttribute`, `OpenApiRequestBodyAttribute`, `OpenApiResponseWithBodyAttribute` 등의 데코레이터를 사용했습니다 (line #1-4, 13-16).
https://gist.github.com/justinyoo/2b4bc731ff8f2cdb5e80e28bd7dff9e7?file=08-add-decorators-2.cs&highlights=1-4,13-16
이렇게 컴파일 한 후, 다시 펑션 앱을 실행시켜 보면 아래와 같이 Swagger UI 페이지가 제대로 보입니다.
![엔드포인트 포함한 애저 펑션 Swagger UI 페이지 #1][image-04]
이렇게 애저 펑션에 Open API 익스텐션을 추가해서 Swagger UI 페이지를 붙이는 것 까지 살펴봤습니다. 이를 애저로 배포한 후 다시 Swagger UI 페이지에 접속해 볼까요?
![엔드포인트 포함한 애저 펑션 Swagger UI 페이지 #1][image-05]
이제 배포가 끝났으니 실제 커스텀 커넥터를 만들기 위한 다음 단계로 넘어가도록 하겠습니다.
## 커스텀 커넥터 생성 ##
커스텀 커넥터는 한 번 만들어 놓으면 [파워 오토메이트][power automate]와 [파워 앱스][power apps] 어디서든 사용할 수 있습니다. 따라서 여기서는 파워 오토메이트에서 커스텀 커넥터를 만들어 보기로 합니다. 먼저 아래와 같이 애저 펑션에서 제공하는 Swagger 문서의 URL을 지정합니다.
![파워 오토메이트 커스텀 커넥터 #1][image-06]
그런데, 가끔 아래와 같이 잘 안될 때가 있습니다. 이것은 현재 알려진 버그인데요, 괜찮습니다.
![파워 오토메이트 커스텀 커넥터 #2][image-07]
그럴 땐 당황하지 말고, Swagger 문서를 저장한 후 직접 업로드합니다.
![파워 오토메이트 커스텀 커넥터 #3][image-08]
이렇게 하면 그 다음부터는 그냥 자동으로 진행됩니다. 애초에 이 Open API 익스텐션이 바로 이 커스텀 커넥터를 염두에 두고 만든 것이어서 문제없이 진행됩니다. 아래와 같이 `✅ Create Connector` 버튼을 눌러 마무리합니다.
![파워 오토메이트 커스텀 커넥터 #4][image-09]
이제 커스텀 커넥터가 제대로 작동하는지 테스트를 해 볼 차례입니다. 아래 그림과 같이 `4. Test` 탭에서 커스텀 커넥터를 연결합니다.
![파워 오토메이트 커스텀 커넥터 #5][image-10]
그러면 아래 그림과 같이 애저 펑션 API 키 값을 입력하라는 표시가 나타나는데요, 여기서 API 키 값을 입력한 후 연결합니다.
![파워 오토메이트 커스텀 커넥터 #6][image-11]
커스텀 커넥터에 성공적으로 커넥션이 만들어지면, 이제 아래와 같이 실제로 테스트를 진행합니다. 아래 그림의 입력창은 바로 Swagger 문서에 정의된 요청 객체의 형식을 그대로 따라갑니다. 필요한 데이터를 입력하고 아래 `Test Operation` 버튼을 눌러보겠습니다.
![파워 오토메이트 커스텀 커넥터 #7][image-12]
그러면 아래와 같이 테스트가 성공적으로 수행된 것이 보입니다.
![파워 오토메이트 커스텀 커넥터 #8][image-13]
이제 커스텀 커넥터를 생성했으니, 파워 오토메이트를 하나 만들어 보겠습니다.
## 커스텀 커넥터를 이용한 파워 오토메이트 플로우 만들기 ##
이번에 만드는 파워 오토메이트 플로우는 파워 앱에서 이용할 것이기 때문에 아래와 같은 순서로 생성합니다. 먼저 `Instant Flow`를 선택합니다.
![파워 오토메이트 커스텀 커넥터 #9][image-14]
그 다음에는 아래 그림과 같이 파워 앱을 트리거로 지정합니다.
![파워 오토메이트 커스텀 커넥터 #10][image-15]
그러면 이제 본격적인 플로우 작성을 위한 디자이너 창이 생겼습니다. 여기서 `➕ New Step` 버튼을 클릭합니다.
![파워 오토메이트 커스텀 커넥터 #11][image-16]
검색 창에 `ATOM`을 입력하면 방금 우리가 생성한 커스텀 커넥터가 보입니다. 그리고, 애저 펑션에서 만든 두 개의 엔드포인트가 나타나는 것을 알 수 있죠? 여기서 피드 아이템 하나만 가져오는 액션을 아래와 같이 선택합니다.
![파워 오토메이트 커스텀 커넥터 #12][image-17]
액션을 선택하면 앞서 커스텀 커넥터를 테스트 할 때와 비슷한 필드 입력 화면이 나타납니다. 동일한 내용을 입력합니다.
![파워 오토메이트 커스텀 커넥터 #13][image-18]
이 플로우의 목적은 방금 커스텀 커넥터로 받아온 유튜브 피드를 소셜미디어에 포스팅하는 것이므로, 다음 액션으로 아래와 같이 트위터에 포스팅하는 액션을 선택합니다.
![파워 오토메이트 커스텀 커넥터 #14][image-19]
그리고 난 후, 앞서 커스텀 커넥터로부터 받아온 데이터를 아래와 같이 트위터 포스트 데이터로 입력합니다.
![파워 오토메이트 커스텀 커넥터 #15][image-20]
이번에는 파워 앱으로 이 플로우의 결과를 넘겨줘야 하니 아래와 같이 응답 객체 액션을 선택합니다.
![파워 오토메이트 커스텀 커넥터 #16][image-21]
그리고, 응답 객체의 본문에는 커스텀 커넥터에서 받아온 응답 객체 전부를 넣습니다.
![파워 오토메이트 커스텀 커넥터 #17][image-22]
여기까지 하면 파워 오토메이트 플로우 작성은 거의 다 끝났습니다. 한 번 테스트를 해 볼까요? 우측 상단의 `Test` 버튼을 클릭해서 아래와 같이 선택한 후 `Save & Test` 버튼을 클릭합니다.
![파워 오토메이트 커스텀 커넥터 #18][image-23]
그러면 다음 화면에서는 이 플로우에서 사용하는 커넥터들이 다 제대로 연결되어 있는지 확인하게 되는데, 다 연결 되었다면 아래 `Continue` 버튼을 눌러 계속 진행합니다.
![파워 오토메이트 커스텀 커넥터 #19][image-24]
모든 것이 잘 진행된다면 아래와 같이 테스트에 성공했다는 메시지를 볼 수 있습니다.
![파워 오토메이트 커스텀 커넥터 #20][image-25]
이제 실제로 워크플로우가 어떻게 진행됐는지 살펴보겠습니다. 모든 액션은 아래와 같이 성공적으로 진행되었습니다. 여기서 응답 객체 데이터를 복사해 놓겠습니다.
![파워 오토메이트 커스텀 커넥터 #21][image-26]
그리고 실제로 트위터에도 성공적으로 포스팅이 된 것을 확인할 수 있습니다.
![파워 오토메이트 커스텀 커넥터 #22][image-27]
이제 응답 객체를 파워앱에서 좀 더 확실하게 인식할 수 있게끔 마지막 설정을 해 줄 차례입니다. 앞서 복사한 응답 객체 데이터를 가지고 JSON 스키마를 설정합니다. 아래 그림의 `Generate from Sample` 버튼을 클릭합니다.
![파워 오토메이트 커스텀 커넥터 #23][image-28]
방금 복사해 놨던 JSON 응답 객체를 붙여넣고 `Done` 버튼을 클릭합니다.
![파워 오토메이트 커스텀 커넥터 #24][image-29]
그러면 JSON 응답객체 스키마가 생성된 것을 확인할 수 있습니다.
![파워 오토메이트 커스텀 커넥터 #25][image-30]
여기까지 한 후 저장하면 파워 오토메이트 플로우 작성은 모두 끝났습니다.
## 파워 앱에 파워 오토메이트 연동하기 ##
이제 파워 앱을 만들어 볼 차례입니다. 이번에 만드는 파워 앱에 앞서 만든 파워 오토메이트를 연결해 보도록 하죠. 우선 새 앱 캔버스를 하나 생성합니다.
![파워 앱스 #1][image-31]
그 다음에 버튼 콘트롤 하나, 라벨 콘트롤 두 개, 이미지 콘트롤 하나를 캔버스에 추가합니다.
![파워 앱스 #2][image-32]
버튼을 눌렀을 때 필요한 액션이 바로 파워 오토메이트를 실행시키는 것입니다. 이 액션을 아래와 같이 연결합니다. 버튼을 클릭한 후 상단의 메뉴 바에서 `Action`을 클릭합니다. 그리고 바로 아래에 있는 `Power Automate`를 선택합니다. 그 다음에 나오는 화면에서 앞서 만들어 둔 파워 오토메이트를 선택하면 됩니다.
![파워 앱스 #3][image-33]
연결이 끝나면 곧바로 함수 창에 어떤 작업을 할 것인지를 물어보는데, 여기에 `ClearCollect(result, AmplifyingaRandomYouTubeContent.Run())` 라고 입력합니다. 여기서 `AmplifyingaRandomYouTubeContent()` 함수는 파워 오토메이트 이름을 의미합니다.
![파워 앱스 #4][image-34]
이제 다른 레이블 콘트롤 두 개와 이미지 콘트롤 한 개에는 이 파워 오토메이트 실행 결과를 표시합니다. 각각의 콘트롤에 아래와 같이 입력합니다.
* 상단 레이블 콘트롤: `First(result).title`
* 하단 레이블 콘트롤: `First(result).link`
* 이미지 콘트롤: `First(result).thumbnailLink`
이렇게 입력한 후 파워 앱을 실행시켜 버튼을 클릭해 볼까요? 그러면 아래와 같은 결과가 나타납니다.
![파워 앱스 #5][image-35]
그리고 트위터에도 제대로 포스트가 잘 이루어진 것을 확인할 수 있습니다.
![파워 앱스 #6][image-36]
<br/>
---
지금까지, [애저 펑션][az func] 앱에 [Open API 익스텐션][gh openapi]을 설치해서 자동으로 Swagger 문서를 만들어주게끔 하는 것과 더불어, 이를 이용해 [파워 오토메이트][power automate]에 쓰이는 [커스텀 커넥터][az cuscon]를 손쉽게 만드는 방법, 그리고 파워 오토메이트에 이 커스텀 커넥터를 쉽게 붙이는 방법, 마지막으로 [파워 앱][power apps]에 파워 오토메이트를 쉽게 연동하는 방법에 대해 알아 보았습니다. 이렇게 애저 펑션에 간단한 익스텐션 하나만 설치하는 것으로 애저 펑션 API의 확장성이 엄청나게 높아지게 되는데, 이를 이용하면 [파워 플랫폼][power platform]에서 필요한 API를 정말 손쉽게 만들 수 있으리라 확신합니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-04.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-05.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-06.png
[image-07]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-07.png
[image-08]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-08.png
[image-09]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-09.png
[image-10]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-10.png
[image-11]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-11.png
[image-12]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-12.png
[image-13]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-13.png
[image-14]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-14.png
[image-15]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-15.png
[image-16]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-16.png
[image-17]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-17.png
[image-18]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-18.png
[image-19]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-19.png
[image-20]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-20.png
[image-21]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-21.png
[image-22]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-22.png
[image-23]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-23.png
[image-24]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-24.png
[image-25]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-25.png
[image-26]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-26.png
[image-27]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-27.png
[image-28]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-28.png
[image-29]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-29.png
[image-30]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-30.png
[image-31]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-31.png
[image-32]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-32.png
[image-33]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-33.png
[image-34]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-34.png
[image-35]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-35.png
[image-36]: https://sa0blogs.blob.core.windows.net/aliencube/2020/07/creating-custom-connector-from-azure-functions-with-swagger-36.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-12565-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[gh openapi]: https://github.com/Azure/azure-functions-openapi-extension
[gh openapi docs openapi]: https://github.com/Azure/azure-functions-openapi-extension/blob/main/docs/enable-open-api-endpoints.md
[gh openapi release]: https://github.com/Azure/azure-functions-openapi-extension/releases
[az func]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[az apim]: https://docs.microsoft.com/ko-kr/azure/api-management/api-management-key-concepts?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[az cuscon]: https://docs.microsoft.com/ko-kr/connectors/custom-connectors/?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[power platform]: https://powerplatform.microsoft.com/ko-kr/?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[power automate]: https://flow.microsoft.com/ko-kr/?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813
[power apps]: https://powerapps.microsoft.com/ko-kr/?WT.mc_id=dotnet-15268-juyoo&ocid=AID3027813

156
content/posts/2021/02/2021-02-16-developing-webhook-testing-tool-with-azure-durable-functions.md
Просмотреть файл

@ -1,156 +0,0 @@
---
title: "애저 듀어러블 펑션으로 웹훅 검사 도구 만들기"
slug: developing-webhook-testing-tool-with-azure-durable-functions
description: "이 포스트에서는 애저 듀어러블 펑션의 Stateful 속성을 이용해서 웹훅을 테스트할 수 있는 도구를 개발해 보겠습니다."
date: 2021-02-16
image: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-00.png
image_caption: 애저 펑션과 RequestBin 아이콘 합성
author: justin-yoo
category: Azure
tags: azure-functions, azure-durable-functions, statefulness, requestbin
canonical_url: https://blog.aliencube.org/ko/2020/04/23/building-requestbin-with-durable-functions/
featured: false
---
혹시 웹훅을 테스트 하기 위해 사용했던 추억의 RequestBin 앱 첫 화면이 기억나시나요?
![][image-01]
현재는 정식으로 서비스 되고 있지 않고, 다만 소스 코드와 함께 [샘플 형태][requestbin herokuapp]로 운영되고 있습니다. 따라서, 내가 직접 이 서비스를 운영하고 싶다면 도커 컨테이너를 이용해서 어딘가에 호스팅을 해야 합니다. 이와 관련해서 [애저 컨테이너 인스턴스][az aci]를 활용해서 [올리는 방법][gh sample aci]과 [애저 앱 서비스][az appsvc]를 활용해서 [올리는 방법][gh sample appsvc]을 예전에 샘플 코드 형태로 소개한 적이 있습니다. 그런데, 문제가 하나 있습니다. 오리지널 RequestBin 앱은 애플리케이션과 Redis 캐시로 구성이 되어 있는데, 캐시의 특성상 언제든 데이터가 소실될 수 있기 때문에 가끔은 오래된 웹훅 히스토리를 확인하고 싶을 때에는 난감할 수도 있죠.
마침 애저 [듀어러블 펑션][az func durable]은 자체적으로 테이블 저장소 기능을 이용해서 [이벤트 소싱 패턴][event sourcing pattern]을 구현해 놓았습니다. 또한 이를 통해 데이터를 Stateful하게 저장할 수 있기 때문에 코드와 데이터를 동시에 다뤄야 하는 RequestBin 애플리케이션을 처음부터 만들어 보기에 아주 적절한 예시가 될 수 있습니다. 애저 [듀어러블 펑션][az func durable]이 갖는 독특한 속성 중 하나는 상태(State)를 저장할 수 있는(Stateful) 기능입니다. 이 상태 저장 속성을 이용하면 애저 펑션을 훨씬 더 다양한 용도로 사용할 수 있는데요, 이번 포스트에서는 바로 이 [듀어러블 펑션][az func durable]의 Stateful 속성을 이용해서 API의 웹훅 기능을 테스트할 수 있는 [RequestBin 애플리케이션][requestbin herokuapp]을 구현해 보겠습니다.
> 이 포스트에 쓰인 샘플 코드는 [Durable RequestBin Sample][gh sample]에서 다운로드 받을 수 있습니다.
## 상태 저장 엔티티 ##
[듀어러블 펑션][az func durable]의 오케스트레이션 기능은 `IDurableOrchestrationClient`를 통해 State를 암시적으로 저장하는 반면에, 상태 저장 엔티티를 사용하면 `IDurableClient`를 통해 이 State를 명시적으로 저장하고 호출합니다. 따라서, 대략 아래와 같은 모양이 될 텐데요, 오케스트레이션을 구현하는 대신 State에 직접 접근하는 `IDurableClient` 인스턴스가 보일 것입니다 (line #4).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=01-create-bin.cs&highlights=4
이제 이를 바탕으로 상태를 정의하는 엔티티를 생성합니다. `binId`는 유일한 값이라면 뭐가 되든 상관 없으므로 여기서는 간단하게 GUID를 사용합니다 (line #6). `EntityId`가 바로 상태를 관장하는 값입니다 (line #7).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=02-create-bin.cs&highlights=6,7
위 코드에서 보면 `"Bin"`이라는 값은 이 상태를 명시적으로 저장하고 삭제하는 엔티티의 이름입니다. 이 엔티티는 액터 모델의 구현을 따릅니다. 따라서, 엔티티의 상태와 더불어 어떤 식으로 엔티티의 상태를 변경시킬 수 있는지에 대한 액션도 함께 정의되어 있지요. 대략 아래와 같은 모습이 됩니다. 먼저 `IBin` 인터페이스를 통해 상태 변경과 관련한 액션을 정의합니다. 여기서는 상태를 추가하고 리셋하는 역할만 정의합니다.
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=03-ibin.cs
그리고 아래와 같이 `Bin` 클라스로 인터페이스 구현을 하는데, 상태 저장을 위한 `History`라는 속성을 정의합니다 (line #5). 이 때 클라스 데코레이터로 직렬화 옵션을 `MemberSerialization.OptIn`라고 주면 (line #1) 명시적으로 `JsonProperty` 데코레이터를 선언한 속성에 대해서만 직렬화를 시도하게 됩니다 (line #4). 마지막 줄에 보면 `Run(IDurableEntityContext)`라는 이름의 정적 메소드가 있는데 (line #23), 이를 통해 이벤트를 발생시켜 테이블 저장소에 상태를 저장합니다.
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=04-bin.cs&highlights=1,4,5,23
## Bin 생성 ##
그렇다면, 이제 이 엔티티에 어떻게 상태를 저장할까요? `SignalEntityAsync()` 메소드를 통해 엔티티에 구현한 메소드를 호출합니다 (line #8). 여기서는 비어있는 Bin 객체만 반환시킬 예정이므로 `null` 값을 보내게 됩니다. 이렇게 해서 비어있는 Bin이 하나 만들어졌습니다.
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=05-create-bin.cs&highlights=8
여기까지 해서 펑션 앱을 실제로 돌려보면 테이블 저장소에 아래와 같은 형태로 레코드가 생성된 것이 보일 것입니다. `history` 필드에 비어있는 배열이 보이나요? 현재 `Bin`만 만들어졌기 때문입니다.
![][image-02]
## 웹훅 요청 저장 ##
이제 웹훅 요청 히스토리를 하나씩 저장시켜 보도록 하죠. 앞서 만든 엔드포인트와 거의 비슷합니다. 다만 이번에는 요청 데이터를 넣어줘야 합니다. 타임스탬프, 요청 메소드, 헤더, 쿼리스트링, 페이로드를 모두 캡쳐해서 저장합니다 (line #10-14).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=06-add-history.cs&highlights=10-14
그리고, 앞서와 같이 `bin`을 만들어 `SignalEntityAsync()` 메소드를 통해 히스토리를 추가합니다 (line #11).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=07-add-history.cs&highlights=11
이렇게 한 후 실제로 웹훅 요청을 날려보면 테이블 저장소의 데이터가 아래와 같이 변경된 것이 보이는데요, 이는 실제로 요청 데이터가 저장된 것입니다.
![][image-03]
## 웹훅 히스토리 조회 ##
그렇다면, 지금까지 저장해 놓은 웹훅 히스토리를 열어봐야 할 필요도 있을 테죠? 이 경우는 아래와 같이 먼저 Bin 레퍼런스를 생성합니다 (line #7).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=08-get-history.cs&highlights=7
그리고 난 뒤, `ReadEntityStateAsync()` 메소드를 통해 현재 상태를 가져와서 응답 객체로 반환합니다 (line #9).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=09-get-history.cs&highlights=9
이렇게 하면 아래와 같이 저장된 웹훅 요청 데이터에 대한 히스토리를 볼 수 있게 됩니다.
![][image-04]
## 웹훅 히스토리 삭제 ##
이번에는 Bin 안에 저장된 모든 히스토리를 삭제해 볼까요? 먼저 Bin 레퍼런스를 생성합니다 (line #7).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=10-reset-history.cs&highlights=7
그리고 난 후 이번에는 `SignalEntityAsync()` 메소드를 통해 `Bin` 액터의 `Reset()` 메소드를 호출합니다 (line #9).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=11-reset-history.cs&highlights=9
이후 테이블 저장소를 조회해 보면 모든 웹훅 히스토리가 사라진 것을 확인할 수 있습니다.
![][image-05]
## Bin 삭제 ##
이제 마지막으로 이 Bin이 더이상 필요없을 때 삭제하는 엔드포인트를 만들어 보겠습니다. 먼저 Bin 레퍼런스를 생성합니다 (line #7).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=12-purge-bin.cs&highlights=7
그리고, `PurgeInstanceHistoryAsync()` 메소드를 통해 엔티티 자체를 테이블 저장소에서 삭제합니다 (line #9).
https://gist.github.com/justinyoo/01426032d1ee6886796d9cb72e048dd9?file=13-purge-bin.cs&highlights=9
실제로 이 엔드포인트를 호출하면 아래와 같이 테이블 저장소에서 엔티티가 완전히 사라진 것이 보입니다.
![][image-06]
<br/>
---
이렇게 해서 웹훅 API의 페이로드를 테스트해 볼 때 유용한 RequestBin 앱을 애저 [듀어러블 펑션][az func durable]을 이용해 구현해 봤습니다. 이 코드를 이용하면 아무래도 PoC이니만큼 간단한 웹훅 확인 용도로 사용하는데에는 큰 문제가 없습니다. 여기에 더해 조금 더 UI를 붙여준다거나 하면 좀 더 완성도가 높은 앱이 될 것입니다. 이 포스트의 포인트는 애저 [듀어러블 펑션][az func durable]의 Stateful한 특성을 오케스트레이션 용도 뿐만 아니라 직접 액세스를 통해 다양한 활용도를 구현해 볼 수 있다는 데 있으니, 앞으로 이 듀어러블 펑션을 통해 좀 더 다양한 워크플로우 관리를 할 수 있기를 기대합니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-04.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-05.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2020/04/building-requestbin-with-durable-functions-06.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[gh sample]: https://github.com/devkimchi/RequestBin-Sample
[gh sample aci]: https://github.com/aliencube/RequestBin-on-ACI
[gh sample appsvc]: https://github.com/aliencube/RequestBin-on-Azure-App-Service
[az func]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[az func durable]: https://docs.microsoft.com/ko-kr/azure/azure-functions/durable/durable-functions-overview?tabs=csharp&WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[az func durable entity]: https://docs.microsoft.com/ko-kr/azure/azure-functions/durable/durable-functions-entities?tabs=csharp&WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[requestbin]: https://github.com/Runscope/requestbin
[requestbin herokuapp]: https://requestbin.herokuapp.com/
[az aci]: https://docs.microsoft.com/ko-kr/azure/container-instances/container-instances-overview?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[az appsvc]: https://docs.microsoft.com/ko-kr/azure/app-service/?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813
[event sourcing pattern]: https://docs.microsoft.com/ko-kr/azure/architecture/patterns/event-sourcing?WT.mc_id=dotnet-16306-juyoo&ocid=AID3027813

136
content/posts/2021/02/2021-02-23-keyvault-secrets-rotation-management.md
Просмотреть файл

@ -1,136 +0,0 @@
---
title: "애저 키 저장소 시크릿 로테이션 관리하기"
slug: keyvault-secrets-rotation-management-in-bulk
description: "이 포스트에서는 애저 키 저장소의 시크릿 값을 로테이션할 때 애저 펑션을 이용해 일정 기간 이상 오래된 시크릿 값을 한 번에 비활성화 시키는 방법에 대해 알아봅니다."
date: 2021-02-23
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/keyvault-secrets-rotation-management-00.png
image_caption: 애저 키 저장소 시크릿 관리하기
author: justin-yoo
category: Azure
tags: azure-keyvault, azure-functions, azure-sdk, secret-management
canonical_url: https://blog.aliencube.org/ko/2021/02/17/keyvault-secrets-rotation-management/
featured: false
---
얼마전 [애저 키 저장소][az kv] 시크릿 값을 [애저 앱 서비스][az appsvc] 혹은 [애저 펑션][az fncapp]에서 참조할 때, 더이상 버전을 명시하지 않아도 된다는 [공지][az kv announcement]가 있었습니다. 따라서, [지난 포스트][post prev]에서 언급했던 [애저 키 저장소의 시크릿 값][az kv secrets]을 참조하는 방법들 중 두번째 방법이 이전에는 덜 효율적이었다면 이제는 가장 효율적인 접근 방식이 되었습니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=01-keyvault-reference.txt
위와 같이 설정하면 애저 앱 서비스와 애저 펑션 앱에서 가장 최신 버전의 시크릿 값을 자동으로 가져와서 보여줍니다. 만약 최신 버전의 시크릿 값이 생성된지 아직 만 하루가 지나지 않았다면, 애저 앱 서비스 혹은 애저 펑션 내부적으로 작동하는 캐싱 메카니즘이 완전히 값을 받아오지 않았을 수도 있기 때문에, 이전 버전과 함께 [로테이션][az kv secrets rotation]을 시켜줘야 합니다. 이 때 로테이션을 위해서는 가급적이면 두 가지 버전 정도로만 활성화 상태로 유지하고 나머지는 비활성화 시켜주는 것이 보안상의 관점에서도 좋습니다.
* ***애저 키 저장소 시크릿 로테이션 관리***
* [이벤트 기반 애저 키 저장소 시크릿 로테이션 관리][post next]
[애저 키 저장소][az kv]에 저장할 수 있는 시크릿의 갯수는 딱히 제한된 것이 없습니다. 따라서 현업에서 사용하다 보면 굉장히 많은 수의 시크릿을 저장하게 되는데, 이럴 경우 로테이션에 더이상 쓰이지 않는 시크릿 버전을 일일이 찾아 비활성화 시켜주기에는 너무 많을 수 있습니다. 그렇다면, 이를 자동화할 수 있는 방법에는 무엇이 있을까요? 이 포스트에서는 오래되었지만 여전히 활성화 상태로 남아있는 시크릿 버전들을 일괄적으로 비활성화시키는 방법을 애저 펑션으로 구현해 보기로 합니다.
> 실제 작동하는 코드를 보고 싶으신가요? 이 [깃헙 리포지토리][gh sample]에서 다운로드 받아 로컬에서 돌려보세요!
## 애저 키 저장소 SDK ##
애저 키 저장소를 다루는 SDK는 현재 두 가지 버전이 있습니다.
* [Microsoft.Azure.KeyVault][nuget sdk kv old]
* [Azure.Security.KeyVault.Secrets][nuget sdk kv new]
이 중 전자는 이제 deprecated 된 버전이라서, 후자를 사용하면 됩니다. 이와 더불어 [Azure.Identity][nuget sdk identity] SDK도 함께 다운로드 받아 사용하도록 하겠습니다. 애저 펑션 프로젝트를 생성한 후 아래와 같이 두 NuGet 패키지를 설치합니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=02-add-nuget-packages.sh
또한, 키 저장소 SDK 패키지는 `IAsyncEnumerable` 인터페이스를 사용하므로 [System.Linq.Async][nuget linq async] 패키지도 함께 다운로드 받습니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=03-add-nuget-packages.sh
> **NOTE**: 애저 펑션은 아직 .NET 5를 지원하지 않으므로 `System.Linq.Async` 5.0.0 버전의 패키지를 설치하지 않도록 조심합니다.
이제 필요한 라이브러리 설치는 다 끝났고, 실제로 펑션 코드를 구현해 볼까요?
## 오래된 시크릿 버전 비활성화를 위한 애저 펑션 구현 ##
아래 명령어를 통해 애저 펑션 [HTTP 트리거][az fncapp trigger http]를 하나 만들겠습니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=04-add-new-httptrigger.sh
기본 HTTP 트리거 템플릿으로 펑션이 하나 만들어 졌습니다. 이제 이 펑션 메소드의 `HttpTrigger` 바인딩을 아래와 같이 바꿔보겠습니다. HTTP 메소드는 `POST` 하나로 한정하고, 라우팅 URL을 `secrets/all/disable`로 두었습니다 (line #5).
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-01.cs&highlights=5
환경 변수를 통해 아래 두 값을 받아옵니다. 하나는 애저 키 저장소에 접근할 수 있는 URI이고, 다른 하나는 애저 키 저장소 인스턴스를 호스팅하는 테넌트의 ID값입니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-02.cs
다음으로는 애저 키 저장소에 접근할 수 있는 `SecretClient` 인스턴스를 생성합니다. 이 때 인증 옵션을 `DefaultAzureCredentialOptions` 인스턴스를 통해 제공해야 하는데요, 만약 개발하려는 로컬 컴퓨터에서 애저에 로그인한 계정이 여러 개의 테넌트 정보를 갖고 있다면, 아래와 같이 명시적으로 테넌트 ID 값을 지정해 줘야 합니다. 그렇지 않으면 [인증 에러][nuget sdk identity error]가 발생합니다 (line #4-6).
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-03.cs&highlights=4-6
이제 모든 시크릿을 가져와서 하나씩 처리를 해야 합니다. 가장 먼저 할 일은 모든 시크릿을 가져오는 것입니다 (line #2-4).
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-04.cs&highlights=2-4
이제 각각의 시크릿을 하나씩 돌면서 모든 버전을 가져옵니다. 단, 활성화 된 것만 가져오면 되므로 아래와 같이 `WhereAwait` 구문으로 필터링을 합니다 (line #7). 또한 `OrderByDescendingAwait` 구문을 이용해 시간의 역순으로 정렬해서 가장 최근 것이 맨 앞으로 오게끔 합니다 (line #8).
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-05.cs&highlights=7,8
만약 해당 시크릿에는 활성화된 버전이 없다면, 더이상 처리할 것이 없으므로 넘어갑니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-06.cs
만약 해당 시크릿에는 활성화된 버전이 하나뿐이라면, 더이상 처리할 것이 없으므로 넘어갑니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-07.cs
만약 해당 시크릿의 최신 버전이 생성된지 만 하루가 안 됐다면, 아직 로테이션이 필요하므로 넘어갑니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-08.cs
이제 남은 시크릿 버전을 대상으로 비활성화 처리를 해야 합니다. 가장 최신의 버전은 건너뛰고 그 다음부터 처리합니다 (line #2). 그리고 `Enabled` 값을 `false`로 변경하고 (line #6), 업데이트합니다 (line #8).
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-09.cs&highlights=2,6,8
마지막으로 처리 결과를 저장한 변수를 응답 개체에 실어 반환합니다.
https://gist.github.com/justinyoo/75c16e773d9e1c8b8a1d5d5efa37f9c9?file=05-secrets-httptrigger-10.cs
이렇게 한 후 실제로 애저 펑션을 실행시켜 보면 가장 최신의 시크릿 버전을 제외한 모든 오래된 버전이 비활성화 된 것을 확인할 수 있는데요, 이 펑션앱에서 [HTTP 트리거][az fncapp trigger http] 대신 [타이머 트리거][az fncapp trigger timer]를 붙인다든가, 아니면 [애저 로직 앱][az logapp]을 연동시켜 스케줄링을 걸어 놓는다면 더이상 활성화 되어 있지만 더이상 사용하지 않는 애저 키 저장소의 시크릿 버전들에 대한 걱정을 덜 수 있을 것입니다.
---
지금까지 [애저 키 저장소][az kv]의 시크릿 값을 [애저 앱 서비스][az appsvc] 혹은 [애저 펑션][az fncapp]에서 참조할 때 더이상 사용하지 않는 시크릿 버전을 자동으로 비활성화 시키는 방법에 대해 알아 보았습니다. 이렇게 자동화를 시켜놓으면 추가적인 관리 부담을 줄일 수 있으니 한 번 시도해 보면 좋겠습니다. [다음 포스트][post next]에서는 시크릿에 새 버전이 추가될 경우 발생하는 이벤트를 통해 특정 시크릿만을 대상으로 로테이션 관리를 하는 방법에 대해 알아보겠습니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[post prev]: https://blog.aliencube.org/ko/2020/04/30/3-ways-referencing-azure-key-vault-from-azure-functions/
[post next]: /developerkorea/posts/2021/03/02/event-driven-keyvault-secrets-rotation-management/
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[gh sample]: https://github.com/devkimchi/KeyVault-Reference-Sample/tree/2021-02-17
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az appsvc]: https://docs.microsoft.com/ko-kr/azure/app-service/?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az fncapp trigger http]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=csharp&WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az fncapp trigger timer]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-timer?tabs=csharp&WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az kv]: https://docs.microsoft.com/ko-kr/azure/key-vault/general/overview?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az kv announcement]: https://azure.microsoft.com/ko-kr/updates/versions-no-longer-required-for-key-vault-references-in-app-service-and-azure-functions/?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az kv secrets]: https://docs.microsoft.com/ko-kr/azure/key-vault/secrets/about-secrets?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813
[az kv secrets rotation]: https://docs.microsoft.com/ko-kr/azure/app-service/app-service-key-vault-references?WT.mc_id=dotnet-16807-juyoo&ocid=AID3027813#rotation
[nuget sdk kv old]: https://www.nuget.org/packages/Microsoft.Azure.KeyVault/
[nuget sdk kv new]: https://www.nuget.org/packages/Azure.Security.KeyVault.Secrets/
[nuget linq async]: https://www.nuget.org/packages/System.Linq.Async/
[nuget sdk identity]: https://www.nuget.org/packages/Azure.Identity/
[nuget sdk identity error]: https://github.com/Azure/azure-sdk-for-net/issues/11559#issuecomment-620233531

198
content/posts/2021/03/2021-03-02-event-driven-keyvault-secrets-rotation-management.md
Просмотреть файл

@ -1,198 +0,0 @@
---
title: "이벤트 기반 애저 키 저장소 시크릿 로테이션 관리"
slug: event-driven-keyvault-secrets-rotation-management
description: "이 포스트에서는 애저 키 저장소의 시크릿 값이 새롭게 갱신될 때 해당 이벤트를 캡쳐해서 로테이션에 필요하지 않은 오래된 버전들을 비활성화 시키는 방법에 대해 알아봅니다."
date: 2021-03-02
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-00.png
image_caption: 이벤트 기반 애저 키 저장소 시크릿 관리하기
author: justin-yoo
category: Azure
tags: azure-keyvault, azure-eventgrid, azure-logic-apps, azure-functions, azure-sdk
canonical_url: https://blog.aliencube.org/ko/2021/02/24/event-driven-keyvault-secrets-rotation-management/
featured: true
---
[지난 포스트][post prev 1]에서는 [애저 키 저장소][az kv]의 모든 [시크릿][az kv secrets] 값의 모든 버전을 한꺼번에 돌려보고 비활성화 시키는 방법에 대해 알아 보았습니다. 이 방법이 매우 간편하긴 하지만, 처음 한 번이나 두 번 정도 벌크로 진행할 때를 제외하고는 매번 모든 시크릿 값을 대상으로 진행하는 것은 어찌 보면 과하지 않을까 하는 느낌도 있습니다. 그렇다면, 특정 시크릿에 새 버전이 만들어졌을 때 그 시크릿만 체크해서 필요한 만큼 변경할 수 있는 방법은 없을까요? 물론 있습니다! 애저 키 저장소 인스턴스는 기본적으로 [애저 이벤트그리드][az evtgrd]를 통해 이벤트를 발생시키므로, 이를 활용하면 이벤트 기반으로 특정 시크릿에 대해서만 [버전 로테이션을 관리][az kv secrets rotation]할 수 있습니다.
* [애저 키 저장소 시크릿 로테이션 관리][post prev 1]
* ***이벤트 기반 애저 키 저장소 시크릿 로테이션 관리***
이 포스트에서는 [애저 이벤트그리드][az evtgrd], [애저 로직 앱][az logapp], [애저 펑션][az fncapp]을 이용해서 특정 시크릿에 새 버전이 추가될 경우, 이를 자동으로 감지해서 로테이션 버전을 관리하는 방법에 대해 알아보기로 하겠습니다.
> 실제 작동하는 코드를 보고 싶으신가요? 이 [깃헙 리포지토리][gh sample]에서 다운로드 받아 로컬에서 돌려보세요!
## 애저 키 저장소 이벤트 ##
애저 키 저장소는 [이벤트 그리드][az kv evtgrd]와 통합하여 시크릿에 새로 버전이 하나 추가될 때 마다 [이벤트를 발생시킵니다][az kv evtgrd type]. 따라서 이 이벤트를 받아서 처리하게 되면, 굳이 모든 시크릿을 한꺼번에 루프로 돌리지 않아도 개별 시크릿에 대해서만 작업할 수 있어서 상당히 편리합니다. 애저 키 저장소와 이벤트 그리드, 그리고 이벤트 처리기로서 [애저 로직 앱][az logapp]과 [애저 펑션 앱][az fncapp]을 통합한 전체 아키텍처는 대략 아래와 같습니다.
![전체 E2E 프로세스 아키텍처][image-01]
이벤트 처리기로 [애저 로직 앱][az logapp]을 사용하는 이유는 [이전 포스트][post prev 2]에서 언급한 바와 같이 [이벤트 그리드에서 요구하는 인증][az evtgrd delivery auth]을 내부적으로 손쉽게 처리할 수 있기 때문인데요, 만약 애저 펑션에서 직접 처리하고 싶다면 [이 포스트][post prev 3]를 참조하면 좋습니다.
애저 키 저장소에 이벤트 처리기로서 로직 앱을 연동 시키는 방법은 크게 두 가지가 있습니다. 하나는 애저 키 저장소에서 [이벤트그리드 커넥터][az logapp connectors evtgrd]를 이용해 직접 로직 앱 인스턴스를 생성하는 방법이고, 다른 하나는 별도로 인스턴스를 생성한 후 HTTP 웹훅을 이용해 연동시키는 방법입니다. 전자의 경우 [커넥터][az logapp connectors]라는 의존성이 하나 생기는 반면, 후자는 키 저장소와 로직 앱이 독립적으로 작동하기 때문에 개인적으로는 의존성을 없앤 후자를 선호합니다.
먼저 애저 로직 앱 인스턴스를 하나 만들고 [HTTP 트리거][az logapp connectors request]를 추가합니다.
![로직앱 HTTP 트리거][image-02]
이렇게 만들어 놓은 로직 앱의 URL을 이용해서 키 저장소에서 이벤트 처리기를 연동시켜 보겠습니다. 먼저 키 저장소 인스턴스의 이벤트 블레이드로 이동합니다. 그리고 `+ 이벤트 구독` 버튼을 클릭합니다.
![이벤트 구독 생성 버튼][image-03]
그러면 이벤트 구독 관련 인스턴스를 생성하는 화면이 나오는데, 아래와 같이 `이벤트 구독 인스턴스 이름`, `이벤트 스키마`, `시스템 토픽 인스턴스 이름`, `엔드포인트 정보`, `웹훅 엔드포인트 URL`을 선택합니다.
![이벤트 구독 생성 상세 정보][image-04]
* 이벤트 구독 정보 섹션에서는 이벤트 스키마로 [클라우드 이벤트 스키마 v1.0][ce spec http]을 선택했는데, 이는 애저 자체 표준 대신 [CNCF][cncf]에서 제시하는 표준인 [클라우드이벤트 스펙][ce spec]을 따르는 것이 향후 이기종간 통합에 편리하기 때문입니다.
* 항목 정보 섹션에서는 이벤트 그리드 토픽 이름을 선택합니다.
* 이벤트 유형 섹션에서는 이벤트 형식 중에서 `Secret New Version Created` 이벤트만 선택합니다.
* 엔드포인트 정보 섹션에서는 엔드포인트 유형으로 웹훅/웹후크를 선택하고 엔드포인트 값을 앞서 만들어 놓은 로직 앱 엔드포인트 URL로 설정합니다.
이렇게 하면 애저 키 저장소 인스턴스와 애저 이벤트그리드, 애저 로직 앱 사이에 이벤트 발생시 기본적으로 처리할 수 있는 파이프라인을 만들게 되는데요, 실제로 애저 키 저장소에서 시크릿의 새 버전을 하나 만들어 보면 아래와 같은 이벤트가 발생하는 것을 알 수 있습니다. 원하는 `Microsoft.KeyVault.SecretNewVersionCreated` 형식의 이벤트를 캡쳐한 것이 보입니다.
![로직 앱 이벤트 캡쳐][image-05]
그리고, 실제 이벤트 메시지 JSON 개체는 아래와 같이 생겼습니다.
![로직 앱 이벤트 메시지 페이로드][image-06]
`data` 속성 안에 보면 `ObjectName`이라고 있는데, 바로 이것이 시크릿 이름이고, 이 값을 앞으로 구현할 애저 펑션으로 보내서 해당 시크릿 이름에 대해서만 필요한 버전만 남겨두고 나머지를 비활성화 시키도록 할 예정입니다. 이제 애저 펑션의 구현을 살펴보도록 하겠습니다.
## 애저 펑션을 통해 특정 시크릿에 대해서만 로테이션 관리하기 ##
[지난 포스트][post prev 1]의 구현 내용과 크게 다르지 않지만, 이번에는 특정 시크릿에 대해서만 처리를 하는 내용이므로 펑션의 구현 내용이 살짝 간결해집니다. 먼저 새 [HTTP 트리거][az fncapp trigger http]를 하나 생성합니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=01-func-new-http-trigger.sh
기본 템플릿을 이용해 HTTP 트리거를 만들었습니다. 이제 이 펑션 메소드의 `HttpTrigger` 바인딩 설정을 아래와 같이 바꿉니다. HTTP 메소드는 `POST` 하나로 한정하고, 라우팅 URL을 `secrets/{name}/disable/{count:int?}` 처럼 바꿉니다 (line #5). 라우팅 URL에 보면 `{name}`, `{count:int?}` 같은 플레이스홀더 두 개가 보이는데, 이는 바로 `string name`, `int? count` 같은 파라미터 변수로 치환시킬 수 있습니다 (line #6).
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-01.cs&highlights=5,6
환경 변수를 통해 아래 두 값을 받아옵니다. 하나는 애저 키 저장소에 접근할 수 있는 URI이고, 다른 하나는 애저 키 저장소 인스턴스를 호스팅하는 테넌트의 ID값입니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-02.cs
다음으로는 애저 키 저장소에 접근할 수 있는 `SecretClient` 인스턴스를 생성한다. 이 때 인증 옵션을 `DefaultAzureCredentialOptions` 인스턴스를 통해 제공해야 하는데, 만약 개발하려는 로컬 컴퓨터에서 애저에 로그인한 계정이 여러 개의 테넌트 정보를 갖고 있다면, 아래와 같이 명시적으로 테넌트 ID 값을 지정해 줘야 하는데요, 그렇지 않으면 인증 에러가 발생합니다 (line #4-6).
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-03.cs&highlights=4-6
시크릿 이름을 이미 알고 있기 때문에 아래와 같이 직접 이름을 호출해서 모든 시크릿 버전을 가져옵니다. 단, 활성화 된 것만 가져오면 되므로 아래와 같이 `WhereAwait` 구문으로 필터링을 하고 (line #5), 또한 `OrderByDescendingAwait` 구문을 이용해 시간의 역순으로 정렬해서 가장 최근 것이 맨 앞으로 오게끔 처리합니다 (line #6).
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-04.cs&highlights=5,6
만약 해당 시크릿에는 활성화된 버전이 없다면, 더이상 처리할 것이 없으므로 `AcceptedResult` 인스턴스를 반환하는 것으로 펑션을 끝냅니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-05.cs
기본적으로 로테이션 관리를 하기 위해서는 버전이 최소 두 개가 필요하므로, 만약 `count` 값이 주어지지 않았다면 `2`를 기본값으로 해서 `count` 값을 초기화시킵니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-06.cs
현재 활성화된 시크릿 버전이 주어진 카운트 값 보다 많지 않다면 더이상 처리할 것이 없으므로 마찬가지로 `AcceptedResult` 인스턴스를 반환하고 펑션을 끝냅니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-07.cs
이제 남은 시크릿 버전을 대상으로 비활성화 처리를 해야 합니다. 주어진 `count` 값 만큼의 최신 버전을 건너뛰고 그 다음부터 처리합니다 (line #2). 그리고 Enabled 값을 false로 변경하고 (line #7), 업데이트합니다 (line #9).
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-08.cs&highlights=2,7,9
마지막으로 처리 결과를 저장한 변수를 응답 개체에 실어 반환합니다.
https://gist.github.com/justinyoo/948385359cc739a48ad5afdf07db932e?file=02-disable-secret-http-trigger-09.cs
이렇게 해서 애저 펑션 쪽의 구현은 끝났습니다. 이제 이를 애저로 배포하고 난 후 로직 앱에 연동시켜 보겠습니다.
## 애저 로직 앱과 애저 펑션 연동 ##
앞서 만들어 둔 애저 로직 앱 인스턴스에 아래와 같이 HTTP 액션과 응답 액션을 추가합니다. 애저 펑션 엔드포인트를 호출할 때 `ObjectName` 값과 `2`를 라우팅 파라미터로 추가한 것이 보일 겁니다.
![로직 앱 추가 액션][image-07]
이제 애저 키 저장소로부터 애저 이벤트그리드, 로직 앱, 애저 펑션을 이용한 종단간 프로세스 통합 작업은 끝났습니다. 실제로 이 워크플우를 실행시켜 볼까요?
## 종단간 테스트 &ndash; 애저 키 저장소 시크릿 버전 추가 ##
앞서 구현한 모든 통합 워크플로우를 실행시키기 위해서는 애저 키 저장소 인스턴스에 새 시크릿 버전을 추가해 보면 됩니다.
![애저 키 저장소 시크릿 버전 리스트][image-08]
아래와 같이 애저 키 저장소 인스턴스에 새 시크릿 버전을 추가해 보겠습니다.
![애저 키 저장소 새 시크릿 버전 추가][image-09]
아래와 같이 새 버전이 추가된 것이 보이나요?
![애저 키 저장소 새 시크릿 버전 추가 결과][image-10]
그리고 새 버전이 추가됐을 때 이벤트 그리드를 통해 로직 앱으로 받은 이벤트 데이터는 아래와 같습니다. `ObjectName` 값과, 새로 생성된 시크릿 버전 값이 위와 같은 것을 확인하셨나요?
![로직 앱 실행 결과][image-11]
이 로직 앱을 통해 애저 펑션을 호출하고 해당 시크릿의 로테이션 처리 결과가 적용된 애저 키 저장소를 살펴 보면 최신 두 버전을 제외하고 나머지는 모두 비활성화 상태로 바뀐 것이 보입니다.
![애저 키 저장소 시크릿 버전 비활성화][image-12]
<br/>
---
지금까지 [애저 키 저장소][az kv] 인스턴스에 새 [시크릿][az kv secrets] 버전이 추가되는 이벤트를 캡쳐해서, 해당 시크릿만 대상으로 [버전 로테이션 관리][az kv secrets rotation]를 하는 방법을 [애저 이벤트그리드][az evtgrd], [애저 로직 앱][az logapp], [애저 펑션][az fncapp]을 이용해서 구현해 보았습니다. 여러분의 실무에서도 이와 비슷한 방식으로 이벤트를 캡쳐해서 처리하게 하는 방식을 도입해 본다면 꽤 유용할 것입니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-02-ko.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-03-ko.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-04-ko.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-05-ko.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-06-ko.png
[image-07]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-07-ko.png
[image-08]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-08-ko.png
[image-09]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-09-ko.png
[image-10]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-10-ko.png
[image-11]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-11-ko.png
[image-12]: https://sa0blogs.blob.core.windows.net/aliencube/2021/02/event-driven-keyvault-secrets-rotation-management-12-ko.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[post prev 1]: /developerkorea/posts/2021/02/23/keyvault-secrets-rotation-management-in-bulk/
[post prev 2]: /developerkorea/posts/2021/02/02/websub-to-eventgrid-via-cloudevents-and-beyond/
[post prev 3]: /developerkorea/posts/2021/01/19/cloudevents-for-azure-eventgrid-via-azure-functions/
[gh sample]: https://github.com/devkimchi/KeyVault-Reference-Sample/tree/2021-02-24
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az logapp connectors]: https://docs.microsoft.com/ko-kr/connectors/connectors?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az logapp connectors request]: https://docs.microsoft.com/ko-kr/azure/connectors/connectors-native-reqres?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az logapp connectors evtgrd]: https://docs.microsoft.com/ko-kr/connectors/azureeventgrid/?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az fncapp trigger http]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=csharp&WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az kv]: https://docs.microsoft.com/ko-kr/azure/key-vault/general/overview?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az kv secrets]: https://docs.microsoft.com/ko-kr/azure/key-vault/secrets/about-secrets?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az kv secrets rotation]: https://docs.microsoft.com/ko-kr/azure/app-service/app-service-key-vault-references?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813#rotation
[az kv evtgrd]: https://docs.microsoft.com/ko-kr/azure/key-vault/general/event-grid-overview?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az kv evtgrd type]: https://docs.microsoft.com/ko-kr/azure/event-grid/event-schema-key-vault?tabs=cloud-event-schema&WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az evtgrd]: https://docs.microsoft.com/ko-kr/azure/event-grid/overview?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[az evtgrd delivery auth]: https://docs.microsoft.com/ko-kr/azure/event-grid/security-authentication?WT.mc_id=dotnet-17246-juyoo&ocid=AID3027813
[cncf]: https://cncf.io/
[ce]: https://cloudevents.io/
[ce spec]: https://github.com/cloudevents/spec/tree/v1.0
[ce spec http]: https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md

134
content/posts/2021/03/2021-03-09-enabling-openapi-on-azure-functions.md
Просмотреть файл

@ -1,134 +0,0 @@
---
title: "애저 펑션에 Open API 활성화 시키기"
slug: enabling-openapi-on-azure-functions
description: "이 포스트에서는 애저 펑션에서 Open API 기능을 활성화 시키는 방법에 대해 알아 봅니다."
date: 2021-03-09
image: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-00.png
image_caption: 애저 펑션과 Open API
author: justin-yoo
category: Azure
tags: azure-functions, openapi
canonical_url:
featured: false
---
[애저 펑션][az fncapp]에서는 현재 [v1 런타임에 대해서만 프리뷰 형태로 Open API 지원][az fncapp v1 openapi]을 하고 있습니다. 하지만, 애저 펑션의 현재 런타임 버전은 v3인데, 아직까지 v2 버전 이후로 공식적으로 Open API 기능을 지원하지 않습니다. 다행히도 [이 확장 기능][gh openapi]을 사용하면 애저 펑션에 [Open API][openapi] 기능을 활성화 시킬 수 있는데, 이 포스트에서는 이 확장 기능을 사용하는 방법에 대해 알아보기로 하겠습니다.
> **NOTE**: 현재 이 [확장 기능][gh openapi]은 프리뷰 상태로, 정식 출시되기 전입니다. 미리 사용해 보시고, 피드백을 [깃헙 이슈][gh openapi issues]에 남겨주세요!
## 애저 펑션 앱 생성하기 ##
가장 먼저 애저 펑션 프로젝트를 생성합니다.
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=01-func-init.sh
그 다음에 [HTTP 트리거 펑션][az fncapp trigger http]을 하나 생성합니다.
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=02-func-new.sh
그러면 아래와 같이 기본 HTTP 트리거 펑션 코드가 만들어 집니다.
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=03-default-http-trigger.cs
이제 아래 명령어를 통해 이 애저 펑션 앱을 한 번 실행시켜 보겠습니다.
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=04-func-start.sh
예상한 바와 같이 애저 펑션의 엔드포인트는 `/api/DefaultHttpTrigger` 하나만 보입니다.
![애저 펑션 엔드포인트][image-01]
## Open API 기본 기능 추가하기 ##
이제 Open API 기능을 활성화 시키기 위해 NuGet 패키지를 설치할 차례입니다. 아래 명령어를 통해 [확장 기능 패키지 라이브러리][nuget openapi]를 설치합니다.
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=05-dotnet-add-package.sh
> **NOTE**: 이 포스트를 작성하는 시점에서 이 확장 기능 패키지 라이브러리의 버전은 `0.5.1-preview` 입니다.
이제 다시 한 번 애저 펑션 앱을 실행시켜 보겠습니다. 그러면 추가적인 엔드포인트가 보입니다.
![애저 펑션 Open API용 추가 엔드포인트][image-02]
이 추가 엔드포인트를 통해 Open API 기능을 확인할 수 있습니다. 웹 브라우저를 통해 맨 아래에 있는 `http://localhost:7071/api/swagger/ui` 주소로 접속해 보겠습니다. 아래와 같이 Swagger UI 페이지를 볼 수 있습니다.
![Swagger UI 페이지 - 엔드포인트 안보임][image-03]
그런데, 위 페이지를 보면 분명히 이 앱에서는 `/api/DefaultHttpTrigger`라는 엔드포인트가 있는데, 이 UI에서는 없다고 나옵니다. 어떻게 된 일일까요? 아직 해당 엔드포인트에 설정을 하지 않은 상태라서 그렇습니다. 이제 아래와 같이 Open API 관련 설정을 엔드포인트에 추가해 보도록 하겠습니다 (line #3-5).
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=06-default-http-trigger.cs&highlights=3-5
* `OpenApiOperation`: Open API 스펙에 따르면 모든 엔드포인트는 고유의 Operation ID 값을 갖고 있어야 합니다. 이를 정의하는 데코레이터입니다.
* `OpenApiParameter`: 이 엔드포인트로 파라미터를 보내는 방법에 대해 정의합니다. 여기서는 쿼리스트링으로 `name`이라는 파라미터를 통해 값을 전송합니다.
* `OpenApiResponseWithBody`: 이 엔드포인트로 HTTP 요청을 보낼 때 받을 수 있는 응답 개체의 형식을 정의합니다. 여기서는 `text/plain` 형식으로 문자열을 반환합니다.
위와 같이 설정한 후 다시 펑션 앱을 실행시켜 보면 아래와 같이 UI 페이지에서 엔드포인트가 보입니다!
![Swagger UI 페이지 - 엔드포인트 보임][image-04]
## Open API 보안 기능 추가하기 ##
일반적으로 API는 부정한 방법으로 접근하는 것을 방지하기 위해 보안 설정을 하죠. 그렇다면, 이 확장 기능으로는 어떻게 이 보안 설정을 정의할까요? 아래 코드를 한 번 보겠습니다 (line #7).
https://gist.github.com/justinyoo/2516ec59b204e2bbf85181620f1d0aea?file=07-default-http-trigger.cs&highlights=7
* `OpenApiSecurity`: 애저 펑션은 기본적으로 API Key 값을 통해 보안을 설정할 수 있습니다. 이 키 값을 쿼리스트링으로 보낼 때는 `code`라는 파라미터로, 요청 헤더를 통해 보낼 때는 `x-functions-key`를 통해 보내는데요, 여기서는 쿼리스트링으로 보내는 것으로 정의합니다.
이렇게 한 후, 다시 펑션 앱을 실행시켜 보겠습니다. 아래 그림에 보면 전에 보이지 않던 `Authorize 🔓` 버튼이 보입니다.
![Swagger UI 페이지 - 자물쇠 열림][image-05]
이 버튼을 클릭해 보면 아래와 같은 팝업 창이 생기는데요, 여기에 애저 펑션의 API Key 값을 입력합니다. 현재는 로컬 개발 환경에서 실행시키고 있으니, 아무 값이나 넣어도 상관 없습니다. 쿼리스트링에 `code`라는 파라미터로 추가하는 것이 보이시나요?
![Swagger UI 페이지 - 인증 팝업][image-06]
인증을 하고 나면 아래와 같이 자물쇠 모양이 잠긴 것을 확인합니다.
![Swagger UI 페이지 - 자물쇠 닫힘][image-07]
그리고, UI 상에서 이 엔드포인트를 실행시켜 볼까요? `name` 필드에 아무 값이나 넣고 실행시켜 보면 아래와 같습니다. 쿼리스트링에 `code=abcde` 값이 포함된 것을 볼 수 있습니다.
![Swagger UI 페이지 - API 실행][image-08]
<br />
---
이렇게 해서 애저 펑션에 Open API 기능을 활성화 시키는 방법에 대해 알아 봤습니다. 한 가지 문제가 있다면, 이 확장 기능은 런타임 버전 v2 이상만을 지원한다는 건데요, 여러 가지 이유로 v1 런타임을 사용해야 하는 경우에는 어떻게 해야 할까요? [다음 포스트][post next]에서는 애저 펑션 런타임 v1을 지원하는 방법에 대해 알아보도록 하겠습니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[image-01]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-04.png
[image-05]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-05.png
[image-06]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-06.png
[image-07]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-07.png
[image-08]: https://sa0blogs.blob.core.windows.net/msdevkr/2021/03/enabling-openapi-on-azure-functions-08.png
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-19697-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-19697-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[post next]: /developerkorea/posts/2021/03/16/openapi-extension-to-support-azure-functions-v1/
[gh openapi]: https://github.com/Azure/azure-functions-openapi-extension
[gh openapi issues]: https://github.com/Azure/azure-functions-openapi-extension/issues
[nuget openapi]: https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.OpenApi/
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-19697-juyoo&ocid=AID3027813
[az fncapp v1 openapi]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-openapi-definition?WT.mc_id=dotnet-19697-juyoo&ocid=AID3027813
[az fncapp trigger http]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=csharp&WT.mc_id=dotnet-19697-juyoo&ocid=AID3027813
[openapi]: https://www.openapis.org/

79
content/posts/2021/03/2021-03-16-openapi-extension-for-azure-functions-v1-support.md
Просмотреть файл

@ -1,79 +0,0 @@
---
title: "애저 펑션 프록시 기능을 이용한 Open API 확장 기능 하위 호환성 유지하기"
slug: openapi-extension-to-support-azure-functions-v1
description: "이 포스트에서는 애저 펑션의 Open API 확장 기능이 직접 지원하지 않는 v1 런타임을 애저 펑션의 프록시 기능을 이용해서 지원할 수 있는 방법에 대해 알아봅니다."
date: 2021-03-16
image: https://sa0blogs.blob.core.windows.net/aliencube/2020/11/openapi-extension-to-support-azure-functions-v1-00.png
image_caption: 애저 펑션 v1 런타임과 Open API
author: justin-yoo
category: Azure
tags: azure-functions, azure-functions-proxy, openapi, backward-compatibility
canonical_url: https://blog.aliencube.org/ko/2020/11/11/openapi-extension-to-support-azure-functions-v1/
featured: false
---
[지난 포스트][post prev]에서 [애저 펑션][az fncapp]에 데코레이터를 추가해서 Open API 문서를 자동으로 생성하는 Open API 확장 기능과 관련한 [오픈 소스][gh openapi] 프로젝트와 [NuGet 라이브러리][nuget openapi]를 소개했습니다. 이 라이브러리는 현재 애저 펑션 런타임 버전 v2 부터 지원합니다. 하지만, 실제 현업에서는 여전히 여러 이유로 v1 런타임을 사용하는 곳도 많습니다. 그렇다면 이런 경우에는 이 확장 기능을 사용할 수 없는 걸까요? 그럴 수도 있고 아닐 수도 있습니다. Open API 확장 기능을 직접 v1 런타임에 적용시킬 수는 없지만, [애저 펑션 프록시 기능][az fncapp proxy]을 이용하면 가능한데요, 이 포스트에서는 이 트릭에 대해 알아보기로 하겠습니다.
## 레거시 애저 펑션 ##
레거시 엔터프라이즈 애플리케이션의 경우에는 참조 라이브러리 의존성 때문에 v1 런타임으로만 애저 펑션을 구성해야 하는 경우가 왕왕 있습니다. 여기 레거시 애저 펑션 엔드포인트가 아래와 같은 형태로 구성되어 있다고 가정하겠습니다.
https://gist.github.com/justinyoo/2b0b286bbe3e727e17423047cd97f86e?file=01-v1-legacy.cs
애저 펑션 런타임 v1의 경우, [Newtonsoft.Json][nuget jsonnet] 버전 9.0.1에 고정되어 있고, 이를 변경하기가 굉장히 어렵습니다. 그런데, 예를 들어 이 `MyReturnObject` 클라스가 Newtonsoft.Json 버전 10.0.1 이상에 대한 의존성을 갖고 있다면, 이 경우에는 이 [Open API 확장 기능 라이브러리][gh openapi]를 사용할 수 없겠지요?
## Open API 문서 정의용 애저 펑션 만들기 ##
이런 경우에는 [애저 펑션 프록시 기능][az fncapp proxy]으로 한 번 감싸주면 완벽하지는 않더라도 동일한 개발자 경험을 제공함으로써 문제를 해결할 수 있습니다. 먼저 Open API 정의용 애저 펑션을 v3 런타임으로 아래와 같이 만들어 보겠습니다. 펑션 앱 이름은 `MyV1ProxyFunctionApp`으로 두고 (line #1), 기본적으로 모든 펑션 기능은 레거시 v1 앱과 동일하게 작성합니다 (line #3-7). 하지만, 이 펑션은 그저 프록시 용도이므로 실제 펑션이 하는 일은 없으니 간단하게 OK 결과만 반환하게끔 설정합니다 (line #10).
https://gist.github.com/justinyoo/2b0b286bbe3e727e17423047cd97f86e?file=02-v1-proxy.cs&highlights=1,3-7,10
이제 Open API 확장 기능 라이브러리를 설치했다면, 데코레이터를 추가할 차례입니다. 아래와 같이 `FunctionName(...)` 데코레이터 위에 Open API 메타데이터 관련 데코레이터를 추가합니다 (line #5-9).
https://gist.github.com/justinyoo/2b0b286bbe3e727e17423047cd97f86e?file=03-v1-proxy-openapi.cs&highlights=5-9
여기까지 하고 이 프록시 애저 펑션 앱을 실행시키면 성공적으로 Swagger UI 화면을 볼 수 있습니다. 하지만, 이 앱은 Swagger UI 화면만 보여줄 뿐 실제로 동작하는 화면은 아니므로 추가로 작업을 해 줄 것이 있습니다. 바로 프록시 기능이죠.
## 레거시 애저 펑션 프록시 추가하기 ##
아래와 같이 `proxies.json` 파일을 프로젝트 루트 폴더에 만듭니다. 레거시 펑션과 프록시 펑션은 동일한 엔드포인트를 갖게끔 만들어 놨기 때문에 (line #6, 11) 사용자 입장에서는 마치 웹서버가 바뀌는 정도의 차이만 느낄 뿐 개발 경험은 동일하게 유지할 수 있습니다. 또한 쿼리스트링과 요청 헤더 역시도 동일하게 레거시 펑션 앱으로 전달합니다 (line #13-14).
https://gist.github.com/justinyoo/2b0b286bbe3e727e17423047cd97f86e?file=04-proxies.json&highlights=6,11,13-14
프록시 펑션을 배포할 때 이 `proxies.json` 파일도 함께 배포해야 하므로 아래와 같이 `.csproj` 파일을 수정해 줍니다 (line #10-12).
https://gist.github.com/justinyoo/2b0b286bbe3e727e17423047cd97f86e?file=05-v1-proxy.csproj&highlights=10-12
이렇게 한 후 이 프록시 펑션을 로컬에서 실행시켜 보거나 애저로 배포한 후 프록시 API 엔드포인트로 접속해 볼까요? 이제 원하는 Open API 문서도 생성할 수도 있고, 실제 레거시 API도 프록시를 통해 실행시킬 수도 있습니다.
<br/>
---
지금까지 [애저 펑션 프록시][az fncapp proxy] 기능을 이용해서 v1 런타임으로만 구성 가능한 레거시 애저 펑션에 [Open API 확장 기능][gh openapi]을 구현하는 방법에 대해 알아 보았습니다. 이 방법의 단점이라면 레거시 API를 한 번 호출할 때 프록시를 거쳐가므로 비용이 두 배로 들어간다는 것인데, 이 부분은 실제 엔터프라이즈 애플리케이션 아키텍팅의 관점에서 신중히 결정해서 결정하시면 됩니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-20715-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-20715-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[post prev]: /developerkorea/posts/2021/03/09/enabling-openapi-on-azure-functions/
[gh openapi]: https://github.com/Azure/azure-functions-openapi-extension
[nuget openapi]: https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.OpenApi/
[nuget jsonnet]: https://www.nuget.org/packages/Newtonsoft.Json/
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-20715-juyoo&ocid=AID3027813
[az fncapp proxy]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-proxies?WT.mc_id=dotnet-20715-juyoo&ocid=AID3027813

241
content/posts/2021/04/2021-04-09-automatic-provisioning-power-platform-hands-on-labs-environment.md
Просмотреть файл

@ -1,241 +0,0 @@
---
title: "명령어 한 줄로 파워 플랫폼 실습 환경 설정하기"
slug: single-command-provisioning-for-power-platform-hands-on-labs-environment
description: "이 포스트에서는 파워 플랫폼 핸즈온 랩을 위한 공통 환경 설정을 명령어 하나만으로 자동화하는 방법에 대해 알아봅니다."
date: 2021-04-13
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-00.png
image_caption: 실습실의 선생님과 학생들
author: justin-yoo
category: Power Platform
tags: power-platform, microsoft-365, azure, powershell, provisioning
canonical_url: https://blog.aliencube.org/ko/2021/04/09/automatic-provisioning-power-platform-hands-on-labs-environment/
featured: true
---
자, 당신이 강사로서 혹은 실습 진행자로서 [파워 플랫폼][pp] 핸즈온 실습을 진행해야 한다고 가정하겠습니다. 실습을 위한 컨텐츠는 준비가 됐습니다. 이제 그렇다면 실습 환경을 준비해야겠지요? 파워 플랫폼 핸즈온 실습을 위해서는 크게 세 가지 방법이 있습니다.
1. 실습자 본인의 기존 파워 플랫폼 환경을 그대로 사용하는 것
1. 실습자 각자 새롭게 환경을 구성하는 방법
1. 진행자가 일괄적으로 환경을 구성하는 방법
각각의 방법은 저마다 장단점이 있게 마련인데, 대략 아래와 같이 정리할 수 있을 것입니다.
1. **첫번째 방법**은 진행자 입장에서는 가장 편리한 방법입니다. 이미 실습자의 환경이 구성되어 있기 때문이죠. 하지만, 실습자 개개인이 속한 테넌트마다 구성이 다를 수 있으므로 파워 플랫폼 실습에 적합한지 아닌지 알 수 있는 방법이 없습니다. 따라서, 실습 동안 권한 문제라든가 다양한 문제를 겪을 가능성이 농후한 편이죠.
2. **두번째 방법**은 진행자 입장에서는 편리할 수도 있고 아닐 수도 있습니다. 우선 환경 구성 자체를 실습자에게 위임하는 과정만 놓고 보자면 진행자 관점에서는 편리할 수도 있겠지만, 그 환경 구성을 위한 가이드 문서를 꼼꼼하게 작성해서 전달해야 합니다. 또한 아무리 자세하게 가이드를 제공한다고 하더라도, 실습자 개개인의 컴퓨터 활용 능력에 따라 환경 구성이 손쉬울 수도 있고 아닐 수도 있습니다. 결국 가이드 문서대로 되었다고 가정하면 낭패를 볼 수 있습니다.
3. **마지막 방법**은 진행자가 모두 사전에 구성을 해 놓는 방법인데요, 실습자 입장에서는 실습에 집중할 수 있으니 아주 편리한 방법이죠. 반면에 진행자 입장에서는 이를 매번 수동으로 설정한다고 생각하면 굉장히 끔찍한 일이 될 겁니다.
따라서, 이 포스트에서는 핸즈온랩 실습 진행자 관점에서 최초 수동으로 해야만 하는 부분을 제외하고는 모두 스크립트 한 번 실행으로 환경 설정을 최대한 자동화하는 방법에 대해 알아보기로 하겠습니다.
> 이 포스트에서 사용한 파워셸 스크립트는 [이 리포지토리][gh sample]에서 다운로드 받을 수 있습니다.
## 명령어 하나로 환경 설정하기 ##
편의상 여기서는 아래와 같은 내용으로 테넌트를 생성했다고 가정합니다.
* 테넌트 이름: `powerplatformhandsonlab`
* 테넌트 URL: `powerplatformhandsonlab.onmicrosoft.com`
* 관리자 이메일: `admin@powerplatformhandsonlab.onmicrosoft.com`
* 관리자 패스워드: `Pa$$W0rd!@#$`
이 정보를 이용해서, 한 번에 환경 설정을 하려면 어떻게 하면 될까요? 여기 전체 [파워셸 스크립트][gh sample code]가 있으니 이걸 이용해 아래와 같이 명령어를 실행시켜 보세요.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=15-set-environment.ps1
네, 그렇습니다. 이게 됩니다! 아래에서 스크립트 하나씩 뜯어볼까요?
## Microsoft 365 테넌트 생성 ##
실습 진행자가 가장 먼저 해야 할 일은 [Microsoft 365][m365] 테넌트를 생성하는 것입니다. Microsoft 365는 30일짜리 무료 평가판을 제공하는데, 관리자를 포함해 총 25개의 라이센스를 제공하므로, 실습용으로 사용하기 좋습니다. [http://aka.ms/Office365E5Trial][m365 trial e5] 링크를 클릭해서 아래와 같이 무료로 Miicrosoft 365 E5 평가판 테넌트를 생성합니다.
![Microsoft 365 E5 평가판 가입 첫화면][image-01]
아래 화면에서 필요한 정보를 모두 입력하면 평가판 테넌트가 만들어집니다.
![Microsoft 365 E5 평가판 가입 화면][image-02]
이제 테넌트가 만들어졌으니 실제로 실습 환경을 파워셸로 구성해 보겠습니다. **참고로 아래에서 진행한 모든 파워셸 명령어는 관리자 권한의 파워셸 콘솔 안에서 실행시켜야 하는 것 잊지 마세요!**
## 프로비저닝 순서 ##
환경 구성을 위한 순서가 딱히 정해져 있지는 않습니다. 하지만, 아래 순서대로 하는 것을 권장하는 편인데, 이는 파워 앱 모듈과 애저 AD 모듈 사이에 호환성이 없어지는 부분이 하나 있기 때문입니다.
1. Microsoft Dataverse 데이터베이스 초기화
1. 사용자 계정 추가
1. Microsoft 365 권한 부여
1. 라이센스 부여
1. 애저 권한 부여
만약에 첫번째 Microsoft Dataverse 데이터베이스 초기화를 가장 먼저 하지 않고 사용자 계정 추가 이후에 진행한다면 에러가 생깁니다. 어떤 에러가 생기는 지는 아래에서 다시 다루도록 하겠습니다.
> **NOTE**: `AzureAD` 모듈을 사용하기 위해서는 Windows 환경의 파워셸 5.1 버전이 필요합니다. 파워셸 6 이상의 버전은 지원하지 않습니다. 사용 환경에 대해서는 [파워셸을 통해 Microsoft 365에 연결하기][m365 powershell connect] 페이지를 참조하세요.
## AzureAD 파워셸 모듈 설치 ##
Microsoft 365 테넌트에 사용자 계정을 추가하기 위해서는 먼저 [`AzureAD` 모듈][psgallery azuread]을 설치해야 합니다. 이 포스트를 쓰는 현재 최신 버전은 `2.0.2.130`입니다. 아래와 같이 `Install-Module` 명령어를 사용하면 되는데요, 맨 마지막의 `-Force -AllowClobber` 옵션을 주면 동일한 버전이 이미 설치가 되어 있을 경우에도 별다른 경고 메시지 없이 재설치합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=01-install-azuread.ps1
## AzureAD 관리자 로그인 ##
파워셸 모듈 설치가 끝났다면, 이제 테넌트 관리자로 로그인 할 차례입니다. 단순히 `Connect-AzureAD` 명령어만 실행시켜도 상관 없겠지만, 이 경우에는 웹 브라우저 기반의 로그인 창이 별도로 생기게 되므로, 자동화 스크립트의 경우에는 맞지 않습니다. 오히려 가능한 한 현재 파워셸 콘솔 창에서 벗어나지 않고 모두 해결해야 하므로 아래와 같은 방식으로 로그인을 하면 효과적입니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=02-connect-azuread.ps1
## 사용자 추가 ##
관리자 로그인이 끝났다면, 이제 본격적으로 사용자를 추가할 차례입니다. 평가판 테넌트에는 관리자를 포함해서 모두 25개의 라이센스를 사용할 수 있으므로, 추가 가능한 실습자의 수는 최대 24명이다. 이와 관련한 자세한 내용은 [파워셸로 Microsoft 365 사용자 계정 만들기][m365 powershell account create] 페이지를 참조하고, 여기서는 아래 파워셸 스크립트를 실행시킵니다.
* 사용자의 패스워드는 편의상 `UserPa$$W0rd!@#$`로 통일시켰으며, 임의로 바꿀 수 없게끔 설정합니다.
* 사용자의 지역은 테넌트가 만들어진 지역으로 설정합니다. 여기서는 `KR`이겠네요.
* 모두 24개의 계정을 만들어야 하므로 `ForEach-Object` 루프 구문을 사용합니다.
* 만들어진 계정은 나중에 다시 사용하기 위해 모두 `$users` 배열 개체에 저장합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=03-new-azureaduser.ps1
## 사용자 계정 역할 및 권한 부여 ##
앞서 추가한 사용자에게 적합한 권한을 부여할 차례입니다. 파워 플랫폼 실습을 위한 환경 설정이니만큼, **파워 플랫폼 관리자 권한**을 부여하기로 하겠습니다. 하지만, 이 권한은 기본적으로 비활성화 되어 있기 때문에, 그에 앞서 아래 명령어를 통해 파워 플랫폼 관리자 권한을 활성화 시킵니다. 권한 할당과 관련한 자세한 내용은 이 [파워셸을 통해 Microsoft 365 계정에 관리자 권한 부여하기][m365 powershell role assign] 페이지를 참조하세요.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=04-get-azureaddirectoryrole.ps1
위와 같이 파워 플랫폼 관리자 권한을 `$role` 개체로 받아왔으니, 이를 앞서 생성한 계정에 모두 부여할 차례입니다. 아래 명령어를 실행시켜 볼까요?
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=05-add-azureaddirectoryrolemember.ps1
## 사용자 계정 라이센스 부여 ##
이번에는 각 사용자에게 파워 플랫폼을 사용할 수 있는 라이센스를 부여할 차례입니다. 기본적으로 평가판 테넌트에는 파워 플랫폼을 사용할 수 있는 라이센스를 계정 수 만큼 제공하고 있으니 이를 사용하면 됩니다. 이와 관련해서 좀 더 자세한 내용은 [파워셸을 통해 계정에 Microsoft 365 라이센스 부여하기][m365 powershell license assign] 페이지를 참조하세요.
우선 라이센스 이름을 검색해 볼까요? 평가판 테넌트를 만든 후 추가적인 작업을 하지 않았으므로 라이센스는 하나만 나올 것이고 그 이름은 `ENTERPRISEPREMIUM`일 것입니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=06-get-azureadsubscribedsku.ps1
아래 명령어를 사용해서 모든 사용자 계정에 라이센스를 부여합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=07-set-azureaduserlicense.ps1
여기까지 해서 핸즈온랩 실습에 필요한 모든 사용자 계정에 역할, 권한, 라이센스까지 자동으로 할당했습니다.
## 파워 플랫폼 기본 환경 Microsoft Dataverse 활성화 ##
파워 플랫폼 핸즈온랩 실습을 위해서 또 한가지 해야 할 것이 있습니다. 바로 [Microsoft Dataverse][pp dataverse] 라는 데이터베이스를 활성화 시키는 작업이다. 다양한 Microsoft 365 제품군과 협업을 하기 위해서 반드시 활성화 시켜야 하는 부분이므로, 아래와 같은 절차를 거쳐 초기화합니다. 파워셸을 이용한 파워 플랫폼 관리자 기능에 대한 좀 더 자세한 내용은 [관리자용 파워 앱 cmdlet][pp powershell dataverse create] 페이지를 참조하세요.
가장 먼저 파워 앱 관련 파워셸 모듈인 [Microsoft.PowerApps.Administration.PowerShell][psgallery pa admin]와 [Microsoft.PowerApps.PowerShell][psgallery pa]을 설치합니다. 앞서와 마찬가지로 `-Force -AllowClobber` 옵션을 이용하면 이미 설치가 되어 있을 경우 재설치합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=08-install-powerapps.ps1
위에서 설정한 `$adminUpn`, `$adminPW` 값을 이용해서 파워 앱 환경에 관리자로 로그인합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=09-add-powerappsaccount.ps1
> **NOTE**: 로그인 과정에서 아래와 같은 에러메시지를 내면서 파워 앱 환경에 로그인 할 수 없는 경우가 생길 수 있습니다.
>
> ![파워 앱 환경 로그인 불가능][image-03]
>
> 이것은 Microsoft 365 테넌트에 로그인하는 과정과 파워 앱에 로그인하는 프로세스가 내부적으로 달라 생기는 일이기 때문에, 이런 에러 메시지를 보면 당황하지 말고 새 파워셸 콘솔 창을 관리자 권한으로 열고 거기서 로그인하면 됩니다.
아래와 같은 가정을 바탕으로 Microsoft Dataverse 데이터베이스를 초기화 시킵니다.
* 기본 환경의 Dataverse 데이터베이스를 활성화 시킵니다.
* 기본 환경의 통화 설정을 따라갑니다.
* 기본 환경의 언어 설정을 따라갑니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=10-new-adminpowerappcdsdatabase.ps1
## 애저 구독 할당 ##
파워 플랫폼을 사용하다 보면 [커스텀 커넥터][pp cuscon]를 사용하기 위해 애저 리소스를 다뤄야 할 경우도 생깁니다. 이 때 애저 구독이 필요한데요, 평가판 테넌트를 생성하면 평가판 애저 구독도 함께 활성화 시킬 수 있습니다. 다만, 이는 신용카드 인증을 위해 애저 포탈에서 직접 해야 합니다. 관리자 계정으로 애저 포탈에 로그인하면 아래와 같은 화면이 나오는데요,
![애저 구독 평가판 가입 안내][image-04]
시작 버튼을 눌러 평가판 구독 절차를 진행합니다.
![애저 구독 평가판 가입 절차][image-05]
위와 같이 관리자 계정에서 평가판 구독 절차가 끝났다면 이번에는 아래 파워셸 명령어를 실행시켜 애저에 로그인합니다. `$adminCredential` 개체는 앞서 AzureAD 로그인에 사용했던 것과 동일합니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=11-connect-azaccount.ps1
> **NOTE**: 파워셸로 애저 리소스를 관리하려면 관련 파워셸 모듈인 [Az][psgallery az]가 이미 설치되어 있어야 합니다. 아래 명령어를 통해 설치하면 됩니다. 마찬가지로 `-Force -AllowClobber` 옵션이 무엇을 의미하는 지는 이제 아시겠죠?
>
> https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=12-install-az.ps1
그런데, 체험판 구독의 경우 사용할 수 있는 애저 리소스의 종류가 제한적입니다. 실제로 커스텀 커넥터를 위한 리소스는 기본적으로 사용할 수 없게 되어 있으므로 아래 명령어를 통해 파워 플랫폼 핸즈온 실습에 필요한 리소스를 활성화 시킵니다. 여기서는 [애저 로직 앱][az logapp], [애저 저장소][az st], [애저 네트워크][az netwrk], [애저 API 매니지먼트][az apim], [애저 Cosmos DB][az cosdba] 정도의 리소스를 사용한다고 가정하겠습니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=13-register-azresourceprovider.ps1
이렇게 리소스 공급자를 등록했다면, 이제 각 사용자 계정에 구독을 할당할 차례입니다. 애저 구독과 권한 부여에 관련해서는 이 [애저 파워셸로 애저 리소스에 대한 권한 부여][az powershell role assign] 페이지를 참조하세요.
> **NOTE**: 구독 전체를 할당하기 보다는 각 사용자별로 리소스 그룹을 생성하고 해당 리소스 그룹에만 기여자 권한을 부여해서 할당하는 것이 보안과 관리 측면에서 용이합니다. 여기서는 지역을 `koreacentral`로 할당하겠습니다.
https://gist.github.com/justinyoo/4cba9e122dfdb5684cd432c072b36b3d?file=14-new-azroleassignment.ps1
각 실습자 계정별로 애저 평가판 구독과 실습에 필요한 리소스 그룹 할당이 끝났습니다! 이제 모든 환경 설정이 다 끝났네요.
<br>
---
지금까지 파워 플랫폼 핸즈온 실습을 위한 모든 환경 설정을 파워셸 스크립트로 구성해 봤습니다. 이제 핸즈온 실습 일정이 잡힐 경우 이 파워셸 스크립트만 실행시키면 짧은 시간 안에 모든 구성을 끝마치고 준비할 수 있을 것입니다. 이 참에 한 번 실습 진행해 보실까요? 😉
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* Microsoft 365에 관심이 있으신가요? ➡️ [무료 체험 계정 생성하기][m365 account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-23654-juyoo&ocid=AID3027813
[m365 account free]: https://www.microsoft.com/ko-kr/microsoft-365/try?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-23654-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-01-ko.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-02-ko.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-03-ko.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-04-ko.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/automatic-provisioning-power-platform-hands-on-labs-environment-05-ko.png
[gh sample]: https://github.com/devkimchi/PowerPlatform-Hands-on-Lab-Environment-Automatic-Provsioning
[gh sample code]: https://github.com/devkimchi/PowerPlatform-Hands-on-Lab-Environment-Automatic-Provsioning/blob/main/AzureAD/Set-Environment.ps1
[pp]: https://powerplatform.microsoft.com/ko-kr/?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[pp dataverse]: https://docs.microsoft.com/ko-kr/powerapps/maker/data-platform/data-platform-intro?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[pp cuscon]: https://docs.microsoft.com/ko-kr/connectors/custom-connectors/?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[pp powershell dataverse create]: https://docs.microsoft.com/ko-kr/power-platform/admin/powerapps-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813#power-apps-cmdlets-for-administrators
[psgallery azuread]: https://www.powershellgallery.com/packages/AzureAD/
[psgallery pa]: https://www.powershellgallery.com/packages/Microsoft.PowerApps.PowerShell/
[psgallery pa admin]: https://www.powershellgallery.com/packages/Microsoft.PowerApps.Administration.PowerShell/
[psgallery az]: https://www.powershellgallery.com/packages/Az/
[m365]: https://www.microsoft.com/ko-kr/microsoft-365?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[m365 trial e5]: http://aka.ms/Office365E5Trial
[m365 powershell connect]: https://docs.microsoft.com/ko-kr/microsoft-365/enterprise/connect-to-microsoft-365-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[m365 powershell account create]: https://docs.microsoft.com/ko-kr/microsoft-365/enterprise/create-user-accounts-with-microsoft-365-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[m365 powershell role assign]: https://docs.microsoft.com/ko-kr/microsoft-365/enterprise/assign-roles-to-user-accounts-with-microsoft-365-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[m365 powershell license assign]: https://docs.microsoft.com/ko-kr/microsoft-365/enterprise/assign-licenses-to-user-accounts-with-microsoft-365-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az powershell role assign]: https://docs.microsoft.com/ko-kr/azure/role-based-access-control/role-assignments-powershell?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az logapp]: https://docs.microsoft.com/ko-kr/azure/logic-apps/logic-apps-overview?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az st]: https://docs.microsoft.com/ko-kr/azure/storage/?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az netwrk]: https://docs.microsoft.com/ko-kr/azure/virtual-network/virtual-networks-overview?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az apim]: https://docs.microsoft.com/ko-kr/azure/api-management/api-management-key-concepts?WT.mc_id=power-23654-juyoo&ocid=AID3027813
[az cosdba]: https://docs.microsoft.com/ko-kr/azure/cosmos-db/introduction?WT.mc_id=power-23654-juyoo&ocid=AID3027813

126
content/posts/2021/04/2021-04-27-bicep-refreshed.md
Просмотреть файл

@ -1,126 +0,0 @@
---
title: "애저 Bicep 되짚어보기"
slug: bicep-refreshed
description: "이 포스트에서는 애저 Bicep 프로젝트 관련 새롭게 추가된 내용에 대해 알아봅니다."
date: "2021-04-27"
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/04/bicep-refreshed-00.png
image_caption: 이두근 표현
author: justin-yoo
category: Azure
tags: azure, bicep, arm, iac
canonical_url: https://blog.aliencube.org/ko/2021/04/21/bicep-refreshed/
featured: false
---
예전에 개인 블로그에 [작성했던 포스트][post 1]에서는 극초기의 [Bicep 프로젝트][bicep]에 대해 소개를 했더랬습니다. 포스팅 당시에는 `0.1.x` 버전이었지만, 지금은 `0.3.x` 버전으로 실제 프로덕션에서 사용할 수 있을 만큼 안정화가 되었습니다. 더불어 다양한 기능 추가도 있었는데요, 이 포스트에서는 신규로 추가된 bicep의 기능에 대해 알아보기로 합니다.
## 애저 CLI 통합 ##
Bicep CLI는 단독으로도 사용할 수 있지만, 만약 [애저 CLI][az cli]를 사용하고 있다면 [v2.20.0 버전][az cli release v2.20.0] 이후부터는 bicep CLI와 통합되었습니다. 따라서 아래와 같은 명령어가 가능합니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=01-bicep-build.sh
> **참고**: `v0.2.x` 버전까지는 여러 bicep 파일을 한번에 컴파일할 수 있었습니다. 하지만, `v0.3.x` 버전부터는 한 번에 bicep 파일 하나만 처리할 수 있도록 바뀌었습니다. 따라서, 한 번에 여러 파일을 빌드하고 싶다면 별도의 작업을 해 주어야 하는데요, 아래는 파워셸을 예로 들어 작성해 본 스크립트입니다.
>
> https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=02-bicep-build.ps1
이렇게 애저 CLI와 통합된 덕에 bicep 파일을 그대로 애저 CLI를 통해 실행시킬 수도 있습니다. 따라서 아래와 같은 명령어가 가능합니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=03-bicep-deploy.sh
## Bicep 디컴파일 ##
`v0.1.x` 버전에서는 오로지 `.bicep` 파일을 `.json` 파일로 컴파일하는 기능만 가능했습니다. 그런데, [`v0.2.59` 버전][bicep release v0.2.59] 이후로는 기존의 ARM 템플릿을 .bicep 파일로 디컴파일 하는 것도 가능합니다. 이 기능을 이용하면 기존에 사용하던 ARM 템플릿을 유지보수하기 위해 bicep 파일로 변환시키는 데 굉장히 유용하겠죠? 아래와 같은 명령어를 사용하면 됩니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=04-bicep-decompile.sh
> **NOTE**: 이 디컴파일 기능은 ARM 템플릿 안에 `copy` 속성이 있을 경우 아직 제대로 처리하지 못합니다. 좀 더 버전업이 되면 가능해질 것으로 예상하고 있습니다.
## 파라미터 데코레이터 ##
파라미터 작성이 `v0.1.x` 버전에 비해 훨씬 간결해졌습니다. 파라미터의 속성을 데코레이터로 지정할 수 있게끔 개선되었는데요, 아래 코드를 보겠습니다. 저장소 어카운트의 SKU 값은 정해져 있으므로, 아래와 같이 `@allowed` 데코레이터를 사용하면 훨씬 더 가독성이 높아지겠죠?
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=05-bicep-decorators.bicep
## 조건부 리소스 선언 ##
속성값을 지정할 때 삼항연산을 사용하면 조건에 따라 다른 값을 부여할 수 있습니다. 더불어, 아예 `if { ... }` 문을 사용하면, 리소스 자체를 조건부로 선언할 수도 있게끔 개선이 이루어졌습니다. 아래와 같은 형태로 구성해 볼까요? 리소스 그룹의 프로비저닝 지역이 **한국 중부 (Korea Central)**일 때에만 애저 앱 서비스 인스턴스를 프로비저닝하게끔 조건을 걸어 놓은 게 보이죠?
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=06-bicep-conditions.bicep
## 순환문 선언 ##
ARM 템플릿에서는 `copy` 속성과 `copyIndex()` 함수를 이용해서 동일한 리소스를 반복해서 프로비저닝했습니다. bicep 에서는 이를 `for...in` 루프를 사용해서 선언할 수 있습니다. 아래 코드를 볼까요? 애저 앱 서비스 인스턴스를 배열 파라미터를 통해 한 번에 프로비저닝하게끔 선언한 것을 볼 수 있습니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=07-bicep-loops-1.bicep
아래 리소스 선언과 같이 배열과 인덱스를 동시에 활용할 수도 있네요.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=08-bicep-loops-2.bicep
또한 배열과 상관없이 `range()` 함수를 사용해서 루프를 돌려 리소스를 선언할 수도 있습니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=09-bicep-loops-3.bicep
여기서 한 가지 명심해야 하는 부분이 있습니다. `for...in` 루프를 사용하면 결과적으로 리소스 배열이 생기게 되는데요, 이 `for...in` 루프의 바로 바깥에 반드시 배열 표시(`[...]`)를 해야 합니다. 그러면 나머지는 bicep이 알아서 처리합니다.
## 모듈화 ##
제 최애 파트입니다! ARM 템플릿에서는 [연결 템플릿][az arm template linked] 기능을 이용해 리소스별 모듈화를 시도했다면, bicep에서는 `module` 이라는 키워드를 이용해서 모듈화를 선언합니다. 좀 더 직관적으로 바뀐 셈이죠. 예를 한 번 들어볼까요? 아래와 같이 애저 펑션 인스턴스를 선언하기 위해서는 최소 저장소 어카운트, 컨섬션 플랜, 애저 펑션의 세 가지 리소스가 필요한데, 이를 각각 모듈로 구성해서 하나로 통합하면 됩니다. 물론 개별 모듈은 독립적으로 작동할 수 있어야 합니다.
### 저장소 어카운트 모듈 ###
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=10-bicep-storage-account.bicep
### 컨섬션 플랜 모듈 ###
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=11-bicep-consumption-plan.bicep
### 애저 펑션 모듈 ###
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=12-bicep-function-app.bicep
### 모듈 오케스트레이션 ###
위와 같이 개별 리소스마다 모듈화를 해 놓았다면, 이를 하나로 통합해서 활용할 수 있는 오케스트레이션 파일을 아래와 같이 생성하면 됩니다.
https://gist.github.com/justinyoo/e27d3ddc8d868a1c16293f8286b3ff67?file=13-bicep-azuredeploy.bicep
> **NOTE**: 이 글을 쓰는 시점에서는 ARM 템플릿과 반대로 아직 모듈 참조를 위해 외부 URL을 사용할 수 없습니다.
---
지금까지 애저 bicep의 새로운 기능에 대해 알아 보았습니다. 계속해서 추가 기능이 들어가고 있는 만큼 굉장히 빠르게 업데이트 되고 있으니, 꾸준히 사용해 보면 좋을 것 입니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-25381-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-25381-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/c/microsoftdeveloperkorea
[post 1]: https://blog.aliencube.org/ko/2020/09/09/bicep-sneak-peek/
[bicep]: https://github.com/Azure/bicep/
[bicep release v0.2.59]: https://github.com/Azure/bicep/releases/tag/v0.2.59
[az cli]: https://docs.microsoft.com/ko-kr/cli/azure/what-is-azure-cli?WT.mc_id=devops-25381-juyoo&ocid=AID3027813
[az cli release v2.20.0]: https://docs.microsoft.com/ko-kr/cli/azure/release-notes-azure-cli?WT.mc_id=devops-25381-juyoo&ocid=AID3027813#march-02-2021
[az arm template linked]: https://docs.microsoft.com/ko-kr/azure/azure-resource-manager/templates/linked-templates?WT.mc_id=devops-25381-juyoo&ocid=AID3027813

187
content/posts/2021/05/2021-05-18-power-apps-in-fusion-teams.md
Просмотреть файл

@ -1,187 +0,0 @@
---
title: "퓨전 개발팀의 파워 앱 개발 실사례"
slug: power-apps-in-fusion-teams
description: "이 포스트에서는 퓨전 개발팀의 실제 파워 앱 개발 사례를 들어 봅니다."
date: "2021-05-18"
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-00.png
image_caption: "퓨전 팀에서 파워 앱과 애저 펑션의 조합"
author: justin-yoo
category: Power Platform
tags: azure, fusion-teams, power-apps, azure-functions
canonical_url: https://blog.aliencube.org/ko/2021/05/12/power-apps-in-fusion-teams/
featured: false
---
얼마전 Microsoft에서는 퓨전 개발팀을 위한 [무료 학습 모듈을 공개][pa fusion path]했습니다. 더불어 이를 위한 [전자책도 함께 공개][pa fusion ebook]했는데요, 이를 통해 조직내 퓨전 개발팀의 작동 방식에 대한 아이디어가 실제 어떤 식으로 구현이 되는지를 살펴볼 수 있습니다.
[가트너][gartner fusion]에서는 퓨전 개발팀을 "교차 기능 조직(cross-functional team)으로서 비지니스 가치를 수행하기 위해 다양한 데이터와 기술을 사용한다"라고 정의합니다. 동시에 이 퓨전 개발팀은 대체로 기술적인 의사결정을 IT 조직 외부에서 내리기도 하고, 이 결정의 방향은 IT 조직에서 권장하는 방향과 다르게 가는 경우도 잦습니다. 그리고 이러한 퓨전 개발팀의 리더는 IT 조직 외부에서 오는 경우가 많다고도 하네요. 즉, 기존의 IT 조직 관점에서 흔히 보이는 전문 개발자의 시각보다는 좀 더 넓은 비니지스 관점에서 가치를 충족시키는 서비스 개발이 이루어져야 하는 셈인데요, 그렇다면 실제로 이러한 퓨전 개발팀에서 어떤 제품 혹은 서비스를 개발하고 배포할까요?
이 포스트에서는 Lamna 헬스 케어라는 가상의 회사가 한국에서 VIP 회원들을 위해 운영하는 피트니스 센터에서 회원들이 운동 일지 작성에 사용할 모바일 앱을 [파워 앱][pa]으로 개발하는 일련의 과정에 대해 시리즈로 다루도록 합니다.
* ***퓨전 개발팀의 파워 앱 개발 실사례***
* [파워 앱의 종단간 데이터 흐름 실시간 추적][post 2]
* 파워 앱에 DevOps 적용하기
> 이 포스트에 사용한 백엔드 API 샘플 코드는 이곳 [GitHub 리포지토리][gh sample]에서 다운로드 받을 수 있습니다.
## 시나리오 ##
Lamna 피트니스 센터의 퍼스널 트레이너인 안지민쌤은 자신이 관리하는 회원들에게 운동일지를 항상 수기로 작성해서 줬습니다. 하지만, 굳이 쌤이 관리하는 일지 내용을 다시 수기로 작성해서 건네주는 것이 비효율적이라는 생각에 센터에서 도입한 파워 앱을 이용해서 회원과 공유해보고자 하는 계획을 세웠는데요, 이미 회원의 운동 일지를 저장하는 전산 시스템은 구축이 되어 있는 상태입니다. 그렇다면, 이를 파워 앱에서 사용할 수 있게끔 [사용자 지정 커넥터][pa cuscon]를 만들어 파워 앱에서 사용하기만 하면 될 것이라고 생각하고 있습니다. 파워 앱을 통해 회원의 운동 일지 데이터를 입력 받아 데이터베이스에 저장하는 일련의 과정은 대략 아래와 같은 구조입니다.
![GymLog Architecture][image-01]
* 백엔드에서 사용하는 [애저 펑션][az fncapp]에 [OpenAPI 확장 기능][az fncapp extension openapi]을 설치해서 검색용이성(discoverability)을 높입니다.
* OpenAPI 문서를 이용해 사용자 지정 커넥터를 만들구요,
* 사용자 지정 커넥터를 통해 파워 앱에서 운동 데이터를 백엔드로 보냅니다.
* 백엔드는 비동기식으로 데이터를 다루는 [Pub/Sub 패턴][eip pubsub]을 구현합니다.
* 백엔드 API에서 받아온 데이터는 퍼블리셔 쪽에 계속 쌓이다가 운동이 다 끝나는 시점에 모두 합산(Aggregate)한 데이터를 [애저 서비스 버스][az svcbus]로 보내게 됩니다.
* 서비스 버스로 보낸 데이터는 섭스크라이버 쪽의 애저 펑션에서 받아 최종적으로 [애저 코스모스 DB][az cosdba]로 저장합니다.
## 백엔드 API 개선 ##
안지민쌤은 퍼스널 트레이너 팀장이기도 해서 피트니스 센터의 여러 가지 업무에 대한 자동화 아이디어를 퓨전 개발팀에 제공하고 있습니다. 파워 앱을 개발하기 위해 같은 퓨전 개발팀 내 전문 개발자인 권수빈쌤에게 API 검색이 가능하게끔 해달라는 요청을 했고, 이를 받아들여 권수빈쌤은 애저 펑션에 OpenAPI 기능을 추가했습니다. 이를 위해 가장 먼저 [NuGet 패키지 라이브러리][nuget openapi]를 애저 펑션 프로젝트에 추가했습니다.
```bash
dotnet add package Microsoft.Azure.WebJobs.Extensions.OpenApi --prerelease
```
그리고 기존의 API에 몇 가지 데코레이터만 추가해서 API 엔드포인트를 OpenAPI 문서에 포함시키는 작업 정도만 수행했습니다. 아래 코드는 맨 처음 운동 루틴을 시작할 때 사용하는 API에 대한 내용인데요, OpenAPI와 상관없는 부분은 제외시켰으므로, 만약 해당 API의 전체 코드를 보고 싶다면 [이 링크][gh sample api routine]를 클릭하면 됩니다.
https://gist.github.com/justinyoo/1cb47ec0dad64609d26f1fa69a75b60d?file=01-create-routine.cs&highlights=1-7
위와 같이 OpenAPI 설정을 추가하고 난 후 배포해 보면 아래와 같이 Swagger UI 화면이 나타납니다.
![Publisher Swagger UI][image-02]
위에 추가한 확장 기능 라이브러리는 OpenAPI 스펙 V2 (Swagger)와 V3를 모두 지원하므로, `https://<function_app_name>.azurewebsites.net/api/swagger.json` 으로 접속하면 설정에 따라 V2 문서 혹은 V3 문서를 렌더링할 수 있습니다. 위 그림은 V3 문서를 렌더링하는 것으로 되어 있죠?
## 사용자 지정 커넥터 생성 ##
앞서의 작업을 통해 애저 펑션으로 만들어진 API는 OpenAPI 확장 기능에서 제공하는 실시간 OpenAPI 문서 생성 기능을 통해 검색용이성을 높였으니, 이를 통해 파워 앱 쪽에서 사용자 지정 커넥터를 이용해 API에 접근할 수 있게 해야 합니다. 파워 앱은 로우코드 플랫폼이므로 퓨전 팀 안에서 굳이 전문 개발자인 권수빈쌤이 이 사용자 지정 커넥터를 만들어 주지 않더라도 시민 개발자인 안지민쌤도 충분히 작업이 가능한데요, 아래와 같이 파워 앱 스튜디오의 좌측 `사용자 지정 커넥터` 링크를 클릭한 후 우측 상단의 `➕ 새 사용자 지정 커넥터` 버튼을 눌러 `URL에서 OpenAPI 가져오기` 메뉴를 선택하면 됩니다.
![Import OpenAPI from URL][image-03]
아래와 같이 `공개 API의 URL에 붙여넣기` 필드에 애저 펑션에서 자동 생성해 주는 OpenAPI 문서 URL을 붙여넣습니다. 참고로 사용자 지정 커넥터는 현재 OpenAPI v2 스펙으로 작성된 문서만 인식합니다. 따라서, `https://<function_app_name>.azurewebsites.net/api/openapi/v2.json`과 같은 형태의 URL을 호출하면 곧바로 V2 형식의 OpenAPI 문서를 생성해 주니, 이를 그대로 활용하면 되겠네요.
![Import OpenAPI from URL Pop-up][image-04]
그런데, 만약 아래와 같은 에러가 발생하면서 사용자 지정 커넥터 생성에 실패할 수도 있는데, 이는 파워 앱 스튜디오와 애저 펑션 API 인스턴스 사이에 CORS 설정이 빠져 있기 때문입니다.
![Import OpenAPI from URL CORS Error][image-05]
따라서, 애저 펑션 인스턴스 쪽에서 `https://flow.microsoft.com` 사이트에 대한 CORS 설정을 아래와 같이 해 주면 됩니다.
![Azure Functions App CORS][image-06]
CORS 설정이 끝난 후 파워 앱 스튜디오로 돌아와서 다시 사용자 지정 커넥터를 생성하면 이번에는 오류 없이 바로 생성 가능합니다. 이 이후 과정은 [일반적인 사용자 지정 커넥터 생성 과정과 동일][pa cuscon create]하므로 여기서는 생략하겠습니다. 마침내 아래와 같이 사용자 지정 커넥터가 만들어졌네요!
![Custom Connector Created][image-07]
## 인증을 통한 커넥션 생성 ##
안지민쌤이 이 사용자 지정 커넥터를 활용할 수 있으려면, 먼저 인증 절차를 통해서 커넥션을 만들어 놓아야 합니다. 애저 펑션 API 엔드포인트는 API 키로 보호받고 있으므로 이를 이용해 인증하고 커넥션을 만들면 됩니다. 아래와 같이 `➕` 버튼을 클릭합니다.
![New Connection][image-08]
애저 펑션에서 제공하는 API 인증 키 값을 입력한 후 `만들기` 버튼을 클릭합니다.
![API Key Auth][image-09]
그러면, 아래와 같이 커넥션이 만들어졌고, 이제 파워 앱 안에서 이 사용자 지정 커넥터를 자유자재로 사용할 수 있게 됐습니다!
![Connection Created][image-10]
## 파워 앱에서 사용자 지정 커넥터 사용 ##
이제 안지민쌤은 본인이 관리하는 회원들의 운동 일지를 수기로 작업하는 대신 파워 앱을 이용해 작성하면 되는데요, 아래와 같이 파워 앱 캔버스 화면에서 사용자 지정 커넥터를 추가합니다.
![Custom Connector in Power Apps][image-11]
그리고 앱을 개발했습니다! 이제 회원들의 운동일지를 앱으로 관리할 수 있게 됐네요. 아래는 파워 앱을 모바일에서 사용할 때의 스크린샷입니다.
![Power Apps in Action #1][image-12]
![Power Apps in Action #2][image-13]
마지막으로 이렇게 기록한 운동 일지는 [애저 코스모스 DB][az cosdba]에 비동기식으로 저장됩니다.
![Gym Logs in Cosmos DB][image-14]
안지민쌤의 회원들은 이제 좀 더 손쉽게 스스로 운동 일지를 작성할 수 있도록 앱을 제공 받았습니다.
> 만약 이 GymLogs 앱을 사용해 보고 싶다면 [이 링크][gh sample app]에서 다운로드 받아 자신의 파워 앱 환경에 업로드해서 사용하면 됩니다.
---
지금까지 퓨전 개발팀에서
* 현장 전문가는 시민 개발자로서 [파워 앱][pa]을 개발하고,
* 전문 개발자는 이 파워 앱의 기능을 풍부하게 해 주는 커스텀 커넥터를 위한 백엔드 API를 OpenAPI 형식으로 공개하는 형태로
협업을 하는 과정에 대해 알아 보았습니다. 이를 통해 결국 Lamna 피트니스 센터의
* 고객들은 좀 더 체계적인 운동 일지를 작성할 수 있게 되었고,
* 이 데이터를 바탕으로 트레이너들은 좀 더 회원별로 개인화된 운동 루틴을 작성할 수 있게 되었습니다.
이렇게 함으로써 회원과 피트니스 센터 모두에게 좀 더 나은 서비스를 제공할 수 있는 기반이 다져진 셈이죠. [다음 포스트][post 2]에서는 [애저 모니터][az monitor] 서비스를 이용해 파워 앱에서 데이터 저장소까지 데이터가 이동하면서 거쳐가는 경로들을 추적하는 과정에 대해 알아보기로 하겠습니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/c/microsoftdeveloperkorea
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-03-ko.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-04-ko.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-05-ko.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-06-ko.png
[image-07]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-07-ko.png
[image-08]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-08-ko.png
[image-09]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-09-ko.png
[image-10]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-10-ko.png
[image-11]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-11.png
[image-12]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-12.png
[image-13]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-13.png
[image-14]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/power-apps-in-fusion-teams-14.png
[post 1]: /developerkorea/posts/2021/05/18/power-apps-in-fusion-teams/
[post 2]: /developerkorea/posts/2021/05/25/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db/
[gh sample]: https://github.com/aliencube/GymLog
[gh sample api routine]: https://github.com/aliencube/GymLog/blob/main/src/GymLog.FunctionApp/Triggers/RoutineHttpTrigges.cs
[gh sample app]: https://github.com/aliencube/GymLog/blob/main/packages/GymLogs.zip
[pa fusion path]: https://docs.microsoft.com/ko-kr/learn/paths/transform-business-applications-with-fusion-development/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[pa fusion ebook]: https://docs.microsoft.com/ko-kr/powerapps/guidance/fusion-dev-ebook/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[gartner fusion]: https://blogs.gartner.com/hank-barnes/2021/03/30/fusion-teams-a-critical-area-for-vendors-to-develop-understanding/
[eip pubsub]: https://www.enterpriseintegrationpatterns.com/patterns/messaging/PublishSubscribeChannel.html
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[az fncapp extension openapi]: https://github.com/Azure/azure-functions-openapi-extension
[az svcbus]: https://docs.microsoft.com/ko-kr/azure/service-bus-messaging/service-bus-messaging-overview?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[az cosdba]: https://docs.microsoft.com/ko-kr/azure/cosmos-db/introduction?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[az monitor]: https://docs.microsoft.com/ko-kr/azure/azure-monitor/overview?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[pa]: https://powerapps.microsoft.com/ko-kr/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[pa cuscon]: https://docs.microsoft.com/ko-kr/connectors/custom-connectors/?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[pa cuscon create]: https://docs.microsoft.com/ko-kr/connectors/custom-connectors/define-openapi-definition?WT.mc_id=power-27849-juyoo&ocid=AID3027813
[nuget openapi]: https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.OpenApi/

190
content/posts/2021/05/2021-05-25-tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db.md
Просмотреть файл

@ -1,190 +0,0 @@
---
title: "파워 앱의 종단간 데이터 흐름 실시간 추적"
slug: tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db
description: "이 포스트에서는 퓨전 개발팀에서 개발한 파워 앱에서 코스모스 DB까지 종단간 데이터 흐름을 오픈 텔레메트리 기법을 이용해 실시간으로 추적하는 방법에 대해 알아봅니다."
date: "2021-05-25"
image: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-00.png
image_caption: "여러 점들의 연결"
author: justin-yoo
category: Power Platform
tags: azure, observability, traceability, open-telemetry
canonical_url: https://blog.aliencube.org/ko/2021/05/19/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db/
featured: false
---
클라우드 기반의 애플리케이션 아키텍처를 보고 있노라면, 굳이 마이크로서비스 아키텍처가 아니라고 하더라도 수많은 시스템들이 복잡하게 연결되어 서로 데이터 혹은 메시지를 주고 받는 경우가 대부분입니다. 이런 경우에 서로 다른 시스템으로 메시지가 오가다 보면 어느 순간 메시지를 잃어버린다든가, 처리가 되지 않은 채로 계속 남아있다든가 하는 경우가 종종 생기곤 하지요.
클라우드 환경에서는 시스템을 구성하는 수많은 컴포넌트들이 저마다의 리듬으로 작동하기 때문에 어느 특정한 시점에서 특정 서비스가 다운될 수 있다는 것을 항상 전제 조건으로 하고 아키텍처를 설계해야 합니다. 따라서, 메시지가 처음부터 끝까지 무슨 경로를 통해 어떻게 흘러가는지를 지속적으로 확인할 수 있게끔 설계하는 것이 좋은데요, 이런 기능을 가리켜 관측 용이성(Observability)과 추적 용이성(Traceability)이라고 합니다.
[지난 포스트][post 1]에서는 퓨전 개발팀 안에서 시민 개발자가 OpenAPI 기능을 추가한 [애저 펑션][az fncapp] 기반의 API를 이용해 [파워 앱][pa]을 개발하는 과정에 대해 알아보았습니다. 이번에는 이 파워 앱에서 데이터베이스까지 데이터가 이동하는 과정을 [애저 모니터][az monitor] 서비스와 [애플리케이션 인사이트][az appins] 서비스를 이용해 추적하는 방법에 대해 알아보고, 이를 [오픈 텔레메트리][cncf opentelemetry]에서 제공하는 개념과 연결지어 논의해 보기로 합니다.
* [퓨전 개발팀의 파워 앱 개발 실사례][post 1]
* ***파워 앱의 종단간 데이터 흐름 실시간 추적***
* 파워 앱에 DevOps 적용하기
> 이 포스트에 사용한 백엔드 API 샘플 코드는 이곳 [GitHub 리포지토리][gh sample]에서 다운로드 받을 수 있습니다.
## 시나리오 ##
Lamna 피트니스 센터에서는 회원들을 위해 [파워 앱][pa]으로 만든 모바일 앱으로 운동 일지를 작성하는 서비스를 제공하고 있습니다. 그런데, 종종 데이터 입력시 오류가 난다는 회원들의 피드백을 받곤 하는데요, 퓨전 개발팀에서 퍼스널 트레이너 팀을 대표하는 안지민쌤은 이 문제를 같은 팀의 전문 개발자인 권수빈쌤과 공유했습니다. 따라서, 수빈쌤은 어떻게 데이터가 파워 앱에서 애저 코스모스 DB로 흘러가는지 추적할 수 있는 로직을 추가하기로 방향을 잡고 애플리케이션을 수정하기로 했습니다. 데이터 추적 프로세스를 그림으로 나타내면 아래와 같습니다.
![GymLog Telemetry Architecture][image-01]
위의 프로세스를 [오픈 텔레메트리][cncf opentelemetry]에서 정의한 스펙에 맞춰 분석해 볼까요?
* [파워 앱][pa]에서 [코스모스 DB][az cosdba]까지 데이터가 흘러가는 전체 흐름을 [트레이스(trace)][cncf opentelemetry trace]라고 합니다.
* 이 전체 흐름은 [애저 서비스 버스][az svcbus]를 경계로 삼아 서비스 버스에 메시지를 보내기 전과 후로 나눌 수 있는데, 서비스 버스 전과 후는 완전히 다른 독립적인 애플리케이션(퍼블리셔와 섭스크라이버)이기 때문입니다. 이렇게 나뉘어진 각각을 가리켜 [스팬(span)][cncf opentelemetry span]이라고 합니다. 즉, 스팬은 데이터 혹은 메시지를 처리하는 하나의 작업 단위라고 할 수 있죠.
* 파워 앱에서 보낸 데이터는 [애저 테이블 저장소][az st table]에 저장되고 마지막 `publish` 액션을 통해 합산(aggregate)된 데이터가 [애저 서비스 버스][az svcbus]로 전송됩니다.
> 위 그림에서는 이 부분이 `routine`, `exercise`, `publish`의 세 가지 액션으로 구성되어 있습니다. 따라서, 이 부분을 세 개의 스팬으로 잘게 쪼갤 수도 있습니다만, 여기서는 하나의 스팬으로 처리하기로 하겠습니다.
* [애저 서비스 버스][az svcbus]에서 받은 메시지를 처리해서 [코스모스 DB][az cosdba]에 저장합니다.
* 한 스팬에서 다른 스팬으로 데이터가 이동할 때 데이터 추적에 필요한 메타 데이터가 함께 이동해야 합니다. 이를 [스팬 컨텍스트(span context)][cncf opentelemetry spancontext]라고 합니다.
## 파워 앱 개선 ##
앞서 언급한 바와 같이 트레이스는 파워 앱에서부터 시작하기 때문에, 파워 앱에서 트레이스를 위해 작업해 줘야 할 것이 있습니다. 아래 그림과 같이 **Start** 버튼을 누를 때 `correlationId` 값과 `spanId` 값을 파워 앱에서 준비해서 첫번째 `routine` 액션을 수행할 때 API로 보내는 것이 되겠네요.
![Power Apps Canvas - Correlation ID and Span ID][image-02]
이렇게 함으로써, 파워 앱에서부터 추적을 시작한다는 것을 전체 모니터링 과정에서 알 수 있고, 첫번째 스팬도 파워 앱에서부터 시작한다는 것 역시도 알 수 있습니다. 여기서 생성한 `correlationId` 값과 `spanId` 값은 `publish` 액션을 수행할 때 까지 계속해서 따라다닙니다. 더우기 `correlationId` 값은 애저 서비스 버스를 통해 다른 스팬으로 넘어갈 때에도 스팬 컨텍스트를 통해 계속해서 다른 스팬으로 전달됩니다.
## 백엔드 개선 ##
애저 펑션은 [애플리케이션 인사이트][az appins] 서비스의 계측 키(instrumentation key)만 연결해 놓으면 자동으로 모든 추적 데이터를 수집합니다. [오픈 텔레메트리][cncf opentelemetry]의 구현체 중 하나인 [OpenTelemetry.NET][cncf opentelemetry dotnet]을 보면 현재 추적 관련 구현은 [1.0 버전으로 안정화 되었고][cncf opentelemetry dotnet ga], 메트릭이라든가 세부 로그 작성 관련해서는 곧 GA를 목표로 활발하게 작업중입니다. 하지만 안타깝게도 이 구현체가 [애저 펑션에서는 제대로 작동하지 않습니다][cncf opentelemetry dotnet issue]. 따라서, 여기서는 오픈 텔레메트리의 추적 과정을 로그 저장 수준에서만 구현해서 애플리케이션 인사이트와 통합해 보기로 하겠습니다.
### 퍼블리셔 &ndash; HTTP 트리거 ###
그렇다면 로그는 어느 시점에 저장하는 것이 좋을까요?
백엔드 API는 `routine`, `exercise`, `publish` 액션으로 구성되어 있고, 각 액션은 [애저 테이블 저장소][az st table]에 이벤트 소싱 형태로 데이터를 일시 저장합니다. 따라서, 테이블에 데이터를 저장하는 시점에 추적을 위한 일종의 체크포인트로서 로그를 하나 남기는 것이 좋습니다. 또한, 마지막 `publish` 액션에서는 이렇게 저장된 데이터를 합산(aggregate)해서 [애저 서비스 버스][az svcbus]로 메시지를 보내는데, 메시지를 보낸 후에도 체크포인트 로그를 남겨 놓습니다.
애저 펑션의 로깅 기능은 `ILogger` 인터페이스를 통해 사용할 수 있는데, 애플리케이션 인사이트와 연동시켜 놓으면 사용자 지정 텔레메트리 속성을 손쉽게 저장합니다. 그렇다면 사용자 지정 텔레메트리 속성으로 어떤 것들을 지정하면 좋을까요?
* **이벤트 종류**: 액션과 액션의 수행 여부 &ndash; `RoutineReceived`, `ExerciseCreated`, `MessageNotPublished` 등
* **이벤트 상태**: 성공 혹은 실패 &ndash; `Succeeded`, `Failed` 등
* **이벤트 ID**: 애저 펑션의 Invocation ID로 실행될 때 마다 새롭게 GUID가 할당됨
* **스팬 종류**: 스팬의 종류 &ndash; `Publisher` 또는 `Subscriber`
* **스팬 상태**: 스팬의 상태 &ndash; `PublisherInitiated`, `SubscriberInProgress`, `PublisherCompleted` 등
* **스팬 ID**: 매번 스팬이 실행될 때 마다 새롭게 할당되는 GUID
* **인터페이스 종류**: 사용자 인터페이스의 종류 &ndash; `Test Harness` 또는 `Power Apps App`
* **코릴레이션 ID**: 트레이스 전체에서 메시지 추적을 위한 고유 ID
이 정도를 [애플리케이션 인사이트][az appins]를 통해 저장해 두면, 어떤 트레이스에서(코릴레이션 ID) 무슨 인터페이스를 통해(테스트 혹은 파워 앱), 어떤 스팬을 거쳐서, 데이터 처리(이벤트 종류)에 성공했는지 여부(이벤트 상태)를 한 눈에 알 수 있겠죠?
이를 위해 `ILogger` [확장 메서드를 하나 구현][gh sample logger]해서 애저 펑션 안에서 아래와 같이 사용합니다. 코드에서 보이다시피 코릴레이션 ID 값과 스팬 ID 값은 파워 앱에서 보내온 것을 사용합니다 (line #9-10). 그리고, 이벤트 ID 값은 애저 펑션의 `invocationId` 값을 그대로 사용하면 되겠네요 (line #12). 마지막으로 이벤트 종류, 이벤트 상태, 스팬 종류, 스팬 상태, 인터페이스 종류, 코릴레이션 ID 값을 로그로 보냅니다 (line #14-17). 아래의 코드는 파워 앱으로부터 `routine` 액션을 수행할 때, 요청 데이터를 문제 없이 받았음을 기록하는 부분입니다.
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=01-create-routine-01.cs&highlights=9-10,12,14-17
위와 같이 우선 파워 앱으로부터 요청 데이터를 잘 받았음을 체크포인트 로그로 남겨뒀으니, 이제 아래 코드를 볼까요? 우선 요청 데이터를 애저 테이블 저장소에 저장합니다 (line #14). 이 때 성공적으로 저장했다면 거기에 맞춰 로그를 기록합니다 (line #18-23). 만약 이 과정에서 에러가 발생했다면 예외 처리를 하면서 에러 로그를 작성하면 되겠네요 (line #29-34).
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=02-create-routine-02.cs&highlights=14,18-23,29-34
이와 비슷한 방식으로 다른 `exercise`, `publish` 액션에도 체크포인트 로그 처리를 합니다.
### 퍼블리셔 &ndash; 스팬 컨텍스트 ###
`publish` 액션에서는 체크포인트 로그 기능을 구현할 뿐만 아니라, 스팬 컨텍스트 처리도 함께 해야 합니다. 스팬 컨텍스트는 스팬을 넘나들면서 데이터 추적과 관련한 메타 데이터를 함께 보내야 하는 부분인데, 이게 HTTP 요청/응답을 사용할 경우에는 요청 헤더에, 애저 서비스 버스를 사용할 경우에는 메시지 봉투에 넣어주는 형태로 구현하면 됩니다. 여기서는 애저 서비스 버스를 사용하므로 메시지 봉투에 구현된 `ApplicationProperties` 딕셔너리를 이용하겠습니다.
아래 `publish` 액션에 대한 애저 펑션 코드를 볼까요? 서비스 버스 메시지의 본문은 운동 기록에 대한 것이지만 (line #23-24), 나머지 데이터는 메시지 개체의 `CorrelationId`, `MessageId` 속성에 (line #26-27), 나머지는 `ApplicationProperties` 딕셔너리를 통해 섭스크라이버 쪽에서 활용할 수 있게끔 지정해 줍니다 (line #30-33). 마지막으로 애저 서비스 버스에 메시지를 보내고 나면 체크포인트 로그를 생성합니다 (line #37-42).
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=03-publish-routine.cs&highlights=23-24,26-27,30-33,37-42
### 섭스크라이버 &ndash; 서비스 버스 트리거 ###
위에서 정의한 바와 같이 퍼블리셔 쪽에서 애저 서비스 버스의 메시지 봉투를 이용해서 스팬 컨텍스트를 전달했으니, 섭스크라이버 쪽에서는 이를 받아서 사용합니다.
아래 코드는 메시지 봉투를 해석하는 과정을 표현한 것인데요, 스팬 컨텍스트를 통해 코릴레이션 ID 값을 복원하고 (line #10), 메시지 ID 값을 복원한다 (line #13). 그리고 메시지를 성공적으로 복원한 결과를 체크포인트 로그에 남겨둔다 (line #16-19).
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=04-ingest-01.cs&highlights=10,13,16-19
마지막으로 애저 코스모스 DB에 레코드를 저장하고 (line #12), 체크포인트 로그를 남겨둡니다 (line #16-21). 혹시 이 과정에서 에러가 발생할 경우 예외 처리를 한 후 마찬가지로 체크포인트 로그를 저장합니다 (line #25-30).
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=05-ingest-02.cs&highlights=12,16-21,25-30
여기까지 해서 데이터가 지나가는 길목마다 체크포인트를 두고, 해당 체크포인트마다 적절한 로그를 애플리케이션 인사이트로 저장하게끔 구현했습니다. 그렇다면, 이제 실제로 이를 [애저 모니터 서비스][az monitor]를 이용해서 어떻게 추적할 수 있는지 살펴 볼까요?
## 애저 모니터링 KUSTO 쿼리 ##
안지민쌤은 다시 회원으로부터 파워 앱에서 운동 일지를 저장하는 과정에서 에러가 생겼다는 피드백을 받았습니다. 마침 이번에는 스크린샷도 함께 받았는데, 대략 아래와 같군요.
![Power Apps Workout Screen][image-03]
![Power Apps Error Screen][image-04]
지민쌤은 이 스크린샷을 수빈쌤과 공유했고, 이를 바탕으로 수빈쌤은 아래와 같은 [Kusto 쿼리][az monitor kusto]를 애플리케이션 인사이트 쿼리 화면에서 실행시켰습니다. 우선 이 에러를 추적하기 위해 `correlationId` 값을 변수로 지정했습니다 (line #1). 그리고 앞서 저장했던 사용자 지정 텔레메트리 속성값을 이용해서 쿼리를 작성했습니다. 모든 사용자 지정 텔레메트리 속성 값은 `customDimensions.prop__`으로 시작하므로 `where` 구문에서 해당 코릴레이션 ID 값으로 필터링을 했고 (line #4), `project` 구문에서는 전체 필드가 아닌 내가 원하는 필드만 지정했습니다 (line #5-18).
https://gist.github.com/justinyoo/9679433b6d886897cc09d8bcf1c8b6de?file=06-kusto-query.kql&highlights=1,4,5-18
그리고 이렇게 해서 쿼리를 실행 시킨 결과는 아래와 같습니다. 운동 메시지를 받는 데 까지는 성공했지만, 이를 처리해서 애저 테이블 저장소에 저장하는 과정에서 에러가 생긴 것을 알 수 있네요.
![Application Insights Kusto Query Result - Failed][image-05]
수빈쌤이 어느 부분에서 오류가 발생했는지 알아냈으니, 이 부분을 수정해서 다시 애저 펑션 API를 배포했고, 이제는 더이상 오류가 발생하지 않았습니다. 아래는 성공한 기록 중 하나를 임의로 조회한 결과입니다. 퍼블리셔 쪽에서 보낸 메시지를 섭스크라이버 쪽에서 제대로 받아 처리하고 애플리케이션 로직에 따라 이 메시지 ID 값이 그대로 코스모드 DB의 레코드 ID 값이 된 것이 보이나요?
![Application Insights Kusto Query Result - Succeeded][image-06]
이렇게 해서 데이터 추적 로직이 [애플리케이션 인사이트][az appins]를 통해 [오픈 텔레메트리][cncf opentelemetry]의 형식을 빌어 구현한 것을 확인했습니다. 이제 지민쌤과 트레이너들, 그리고 모든 회원들이 앱을 사용하다가 에러가 생기면 코릴레이션 ID 값만 불러주면 손쉽게 어디에서 문제가 생겼는지 추적할 수 있겠군요!
---
지금까지 퓨전 개발팀에서 개발한 앱을 두고, 처음부터 끝까지 하나의 ID 값을 이용해 데이터가 이동하는 과정을 추적하는 것을 [오픈 텔레메트리][cncf opentelemetry]와 [애플리케이션 인사이트][az appins]를 이용해 구현했습니다.
아쉽게도 오픈 텔레메트리 닷넷 구현체가 아직 애저 펑션에서 완벽하게 작동하지 않긴 하지만, 여전히 애플리케이션 인사이트를 이용해 오픈 텔레메트리의 사상을 구현해 낼 수 있으므로 당분간 큰 문제는 없을 것으로 생각합니다. 곧 애플리케이션 인사이트와 오픈 텔레메트리간 통합이 애저 펑션에서도 이루어지길 기대합니다.
다음 포스트에서는 파워 앱을 DevOps 기법을 이용해 배포 자동화 하는 방법을 살펴보기로 하겠습니다.
## 더 궁금하다면... ##
* 애저 클라우드에 관심이 있으신가요? ➡️ [무료 애저 계정 생성하기][az account free]
* 애저 클라우드 무료 온라인 강의 코스를 들어 보세요! ➡️ [Microsoft Learn][ms learn]
* 마이크로소프트 개발자 유튜브 채널 ➡️ [Microsoft Developer Korea][yt msdevkr]
[az account free]: https://azure.microsoft.com/ko-kr/free/?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[ms learn]: https://docs.microsoft.com/ko-kr/learn/?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[yt msdevkr]: https://www.youtube.com/c/microsoftdeveloperkorea
[image-01]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-01.png
[image-02]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-02.png
[image-03]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-03.png
[image-04]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-04.png
[image-05]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-05.png
[image-06]: https://sa0blogs.blob.core.windows.net/aliencube/2021/05/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db-06.png
[post 1]: /developerkorea/posts/2021/05/18/power-apps-in-fusion-teams/
[post 2]: /developerkorea/posts/2021/05/25/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db/
[gh sample]: https://github.com/aliencube/GymLog
[gh sample logger]: https://github.com/aliencube/GymLog/blob/main/src/GymLog.FunctionApp/Extensions/LoggerExtensions.cs
[cncf]: https://cncf.io/
[cncf opentelemetry]: https://opentelemetry.io/
[cncf opentelemetry dotnet]: https://opentelemetry.io/docs/net/
[cncf opentelemetry dotnet ga]: https://devblogs.microsoft.com/dotnet/opentelemetry-net-reaches-v1-0/?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[cncf opentelemetry dotnet issue]: https://github.com/open-telemetry/opentelemetry-dotnet/issues/1602
[cncf opentelemetry trace]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/overview.md#traces
[cncf opentelemetry span]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/overview.md#spans
[cncf opentelemetry spancontext]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/overview.md#spancontext
[az fncapp]: https://docs.microsoft.com/ko-kr/azure/azure-functions/functions-overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az svcbus]: https://docs.microsoft.com/ko-kr/azure/service-bus-messaging/service-bus-messaging-overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az cosdba]: https://docs.microsoft.com/ko-kr/azure/cosmos-db/introduction?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az st table]: https://docs.microsoft.com/ko-kr/azure/storage/tables/table-storage-overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az appins]: https://docs.microsoft.com/ko-kr/azure/azure-monitor/app/app-insights-overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az monitor]: https://docs.microsoft.com/ko-kr/azure/azure-monitor/overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[az monitor kusto]: https://docs.microsoft.com/ko-kr/azure/azure-monitor/logs/log-query-overview?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813
[pa]: https://powerapps.microsoft.com/ko-kr/?WT.mc_id=dotnet-28936-juyoo&ocid=AID3027813

82
content/site/navigation.json
Просмотреть файл

@ -1,82 +0,0 @@
{
"headerNavigation": [
{
"name": "🏠 홈",
"link": "/",
"external": false
},
{
"name": "🚀 시작하기",
"link": "/getting-started",
"external": false
},
{
"name": "📝 Docs",
"link": "https://docs.microsoft.com/ko-kr/",
"external": true
},
{
"name": "📘 Learn",
"link": "https://docs.microsoft.com/ko-kr/learn/",
"external": true
},
{
"name": "📌 북마크",
"link": "#",
"children": [
{
"name": "Microsoft Azure",
"link": "https://azure.microsoft.com/ko-kr/",
"external": true
},
{
"name": "Microsoft 365",
"link": "https://www.microsoft.com/ko-kr/microsoft-365",
"external": true
},
{
"name": "Microsoft Power Platform",
"link": "https://powerplatform.microsoft.com/ko-kr/",
"external": true
}
]
},
{
"name": "깃헙",
"link": "https://github.com/microsoft/developerkorea",
"external": true
},
{
"name": "📣 RSS",
"link": "https://microsoft.github.io/developerkorea/feed.xml",
"external": true
}
],
"footerNavigation": [
{
"name": "YouTube",
"link": "https://youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g",
"external": true
},
{
"name": "Twitter",
"link": "https://twitter.com/microsofttechKR",
"external": true
},
{
"name": "Facebook",
"link": "https://facebook.com/MicrosoftDeveloper.Korea",
"external": true
},
{
"name": "GitHub",
"link": "https://github.com/microsoft/developerkorea",
"external": true
},
{
"name": "RSS",
"link": "https://microsoft.github.io/developerkorea/feed.xml",
"external": true
}
]
}

29
content/site/social.json
Просмотреть файл

@ -1,29 +0,0 @@
{
"social": [
{
"name": "YouTube",
"link": "https://youtube.com/channel/UCdgR-b2t7Byu_UGrHnu-T0g",
"icon": "youtube"
},
{
"name": "Twitter",
"link": "https://twitter.com/microsofttechKR",
"icon": "twitter"
},
{
"name": "Facebook",
"link": "https://facebook.com/MicrosoftDeveloper.Korea",
"icon": "facebook-square"
},
{
"name": "GitHub",
"link": "https://github.com/microsoft/developerkorea",
"icon": "github"
},
{
"name": "RSS",
"link": "https://microsoft.github.io/developerkorea/feed.xml",
"icon": "rss-square"
}
]
}

51
docs/404.html
Просмотреть файл

@ -1,51 +0,0 @@
<!DOCTYPE html>
<html data-html-server-rendered="true" lang="en" data-vue-tag="%7B%22lang%22:%7B%22ssr%22:%22en%22%7D%7D">
<head>
<title>마이크로소프트 기술 블로그 | 마이크로소프트 기술 블로그</title><meta name="gridsome:hash" content="80e403713986797ff323aa88b661a5d06e448643"><meta data-vue-tag="ssr" charset="utf-8"><meta data-vue-tag="ssr" name="generator" content="Gridsome v0.7.23"><meta data-vue-tag="ssr" data-key="viewport" name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"><meta data-vue-tag="ssr" data-key="format-detection" name="format-detection" content="telephone=no"><meta data-vue-tag="ssr" data-key="description" name="description" content="Microsoft Azure, Microsoft 365, Microsoft Power Platform 개발의 모든 것을 다룹니다"><link data-vue-tag="ssr" rel="icon" href="data:,"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="16x16" href="/developerkorea/assets/static/favicon.ce0531f.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="32x32" href="/developerkorea/assets/static/favicon.ac8d93a.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="96x96" href="/developerkorea/assets/static/favicon.b9532cc.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="76x76" href="/developerkorea/assets/static/favicon.f22e9f3.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="152x152" href="/developerkorea/assets/static/favicon.62d22cb.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="120x120" href="/developerkorea/assets/static/favicon.1539b60.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="167x167" href="/developerkorea/assets/static/favicon.dc0cdc5.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="180x180" href="/developerkorea/assets/static/favicon.7b22250.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Nanum+Gothic:wght@400;700;800&amp;display=swap"><link data-vue-tag="ssr" rel="stylesheet" href="https://github.githubassets.com/assets/gist-embed-d89dc96f3ab6372bb73ee45cafdd0711.css"><link rel="preload" href="/developerkorea/assets/css/1.styles.a2925b16.css" as="style"><link rel="preload" href="/developerkorea/assets/js/app.6a63bf9f.js" as="script"><link rel="preload" href="/developerkorea/assets/js/page--node-modules--gridsome--app--pages--404-vue.ef0f12da.js" as="script"><link rel="prefetch" href="/developerkorea/assets/js/page--src--pages--index-vue.3ba335bc.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--pages--infinity-vue.1ecb3c0c.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--author-vue.6aad95b7.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--author-vue~page--src--templates--category-vue~page--src--templates--tag-vue.74fb66e1.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--blog-post-vue.c211ede3.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--category-vue.aec175fd.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--custom-page-vue.7f442cf2.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--tag-vue.91ca211b.js"><link rel="prefetch" href="/developerkorea/assets/js/vendors~page--src--templates--blog-post-vue.40135467.js"><link rel="stylesheet" href="/developerkorea/assets/css/1.styles.a2925b16.css"><script data-vue-tag="ssr" src="https://platform.twitter.com/widgets.js"></script><noscript data-vue-tag="ssr"><style>.g-image--loading{display:none;}</style></noscript>
</head>
<body >
<script>
// Add dark / light detection that runs before Vue.js load. Borrowed from overreacted.io
// for this starter, i used the code from gridsome.org
(function() {
window.__onThemeChange = function() {};
function setTheme(newTheme) {
window.__theme = newTheme;
preferredTheme = newTheme;
document.body.setAttribute('data-theme', newTheme);
document.documentElement.classList.remove('light')
document.documentElement.classList.remove('dark')
document.documentElement.classList.add(newTheme)
window.__onThemeChange(newTheme);
}
var preferredTheme;
try {
preferredTheme = localStorage.getItem('theme');
} catch (err) { }
window.__setPreferredTheme = function(newTheme) {
setTheme(newTheme);
try {
localStorage.setItem('theme', newTheme);
} catch (err) {}
}
var darkQuery = window.matchMedia('(prefers-color-scheme: dark)');
darkQuery.addListener(function(e) {
window.__setPreferredTheme(e.matches ? 'dark' : 'light');
});
setTheme(preferredTheme || (darkQuery.matches ? 'dark' : 'light'));
})();
</script>
<h1 data-server-rendered="true" id="app">404 - not found</h1>
<script>window.__INITIAL_STATE__={"data":null,"context":{"__notFound":true}};(function(){var s;(s=document.currentScript||document.scripts[document.scripts.length-1]).parentNode.removeChild(s);}());</script><script src="/developerkorea/assets/js/app.6a63bf9f.js" defer></script><script src="/developerkorea/assets/js/page--node-modules--gridsome--app--pages--404-vue.ef0f12da.js" defer></script>
</body>
</html>

51
docs/404/index.html
Просмотреть файл

@ -1,51 +0,0 @@
<!DOCTYPE html>
<html data-html-server-rendered="true" lang="en" data-vue-tag="%7B%22lang%22:%7B%22ssr%22:%22en%22%7D%7D">
<head>
<title>마이크로소프트 기술 블로그 | 마이크로소프트 기술 블로그</title><meta name="gridsome:hash" content="80e403713986797ff323aa88b661a5d06e448643"><meta data-vue-tag="ssr" charset="utf-8"><meta data-vue-tag="ssr" name="generator" content="Gridsome v0.7.23"><meta data-vue-tag="ssr" data-key="viewport" name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"><meta data-vue-tag="ssr" data-key="format-detection" name="format-detection" content="telephone=no"><meta data-vue-tag="ssr" data-key="description" name="description" content="Microsoft Azure, Microsoft 365, Microsoft Power Platform 개발의 모든 것을 다룹니다"><link data-vue-tag="ssr" rel="icon" href="data:,"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="16x16" href="/developerkorea/assets/static/favicon.ce0531f.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="32x32" href="/developerkorea/assets/static/favicon.ac8d93a.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="icon" type="image/png" sizes="96x96" href="/developerkorea/assets/static/favicon.b9532cc.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="76x76" href="/developerkorea/assets/static/favicon.f22e9f3.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="152x152" href="/developerkorea/assets/static/favicon.62d22cb.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="120x120" href="/developerkorea/assets/static/favicon.1539b60.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="167x167" href="/developerkorea/assets/static/favicon.dc0cdc5.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="apple-touch-icon" type="image/png" sizes="180x180" href="/developerkorea/assets/static/favicon.7b22250.956d6987e7d3d645bed3e641d6455e72.png"><link data-vue-tag="ssr" rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Nanum+Gothic:wght@400;700;800&amp;display=swap"><link data-vue-tag="ssr" rel="stylesheet" href="https://github.githubassets.com/assets/gist-embed-d89dc96f3ab6372bb73ee45cafdd0711.css"><link rel="preload" href="/developerkorea/assets/css/1.styles.a2925b16.css" as="style"><link rel="preload" href="/developerkorea/assets/js/app.6a63bf9f.js" as="script"><link rel="preload" href="/developerkorea/assets/js/page--node-modules--gridsome--app--pages--404-vue.ef0f12da.js" as="script"><link rel="prefetch" href="/developerkorea/assets/js/page--src--pages--index-vue.3ba335bc.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--pages--infinity-vue.1ecb3c0c.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--author-vue.6aad95b7.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--author-vue~page--src--templates--category-vue~page--src--templates--tag-vue.74fb66e1.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--blog-post-vue.c211ede3.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--category-vue.aec175fd.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--custom-page-vue.7f442cf2.js"><link rel="prefetch" href="/developerkorea/assets/js/page--src--templates--tag-vue.91ca211b.js"><link rel="prefetch" href="/developerkorea/assets/js/vendors~page--src--templates--blog-post-vue.40135467.js"><link rel="stylesheet" href="/developerkorea/assets/css/1.styles.a2925b16.css"><script data-vue-tag="ssr" src="https://platform.twitter.com/widgets.js"></script><noscript data-vue-tag="ssr"><style>.g-image--loading{display:none;}</style></noscript>
</head>
<body >
<script>
// Add dark / light detection that runs before Vue.js load. Borrowed from overreacted.io
// for this starter, i used the code from gridsome.org
(function() {
window.__onThemeChange = function() {};
function setTheme(newTheme) {
window.__theme = newTheme;
preferredTheme = newTheme;
document.body.setAttribute('data-theme', newTheme);
document.documentElement.classList.remove('light')
document.documentElement.classList.remove('dark')
document.documentElement.classList.add(newTheme)
window.__onThemeChange(newTheme);
}
var preferredTheme;
try {
preferredTheme = localStorage.getItem('theme');
} catch (err) { }
window.__setPreferredTheme = function(newTheme) {
setTheme(newTheme);
try {
localStorage.setItem('theme', newTheme);
} catch (err) {}
}
var darkQuery = window.matchMedia('(prefers-color-scheme: dark)');
darkQuery.addListener(function(e) {
window.__setPreferredTheme(e.matches ? 'dark' : 'light');
});
setTheme(preferredTheme || (darkQuery.matches ? 'dark' : 'light'));
})();
</script>
<h1 data-server-rendered="true" id="app">404 - not found</h1>
<script>window.__INITIAL_STATE__={"data":null,"context":{"__notFound":true}};(function(){var s;(s=document.currentScript||document.scripts[document.scripts.length-1]).parentNode.removeChild(s);}());</script><script src="/developerkorea/assets/js/app.6a63bf9f.js" defer></script><script src="/developerkorea/assets/js/page--node-modules--gridsome--app--pages--404-vue.ef0f12da.js" defer></script>
</body>
</html>

3
docs/assets/css/1.styles.a2925b16.css
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/404/index.json
Просмотреть файл

@ -1 +0,0 @@
{"hash":"80e403713986797ff323aa88b661a5d06e448643","data":null,"context":{"__notFound":true}}

1
docs/assets/data/authors/devrel-kr/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/authors/ian-choi/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/authors/justin-yoo/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/authors/justin-yoo/3/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/authors/justin-yoo/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/categories/announcement/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/categories/azure/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/categories/azure/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/categories/power-platform/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/getting-started/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/infinity/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/infinity/3/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/infinity/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/01/01/tech-blog-opening/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/01/06/provisioning-eventgrid-subscription-and-logicapp-handler-using-azure-cli/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/01/12/6-ways-refactoring-azure-devops-pipelines/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/01/19/cloudevents-for-azure-eventgrid-via-azure-functions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/01/26/towards-fairness-ai-with-fairlearn-and-azure-mlops/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/02/02/websub-to-eventgrid-via-cloudevents-and-beyond/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/02/09/creating-custom-connector-from-azure-functions-with-swagger/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/02/16/developing-webhook-testing-tool-with-azure-durable-functions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/02/23/keyvault-secrets-rotation-management-in-bulk/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/03/02/event-driven-keyvault-secrets-rotation-management/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/03/09/enabling-openapi-on-azure-functions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/03/16/openapi-extension-to-support-azure-functions-v1/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/04/13/single-command-provisioning-for-power-platform-hands-on-labs-environment/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/04/27/bicep-refreshed/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/05/18/power-apps-in-fusion-teams/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/posts/2021/05/25/tracing-end-to-end-data-from-power-apps-to-azure-cosmos-db/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/arm/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-cli/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-devops/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-durable-functions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-eventgrid/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-eventgrid/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-functions-proxy/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-functions/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-functions/3/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-functions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-keyvault/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-logic-apps/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-logicapps/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-ml/index.json
Просмотреть файл

@ -1 +0,0 @@
{"hash":"80e403713986797ff323aa88b661a5d06e448643","data":{"tag":{"title":"azure-ml","path":"/tags/azure-ml/","belongsTo":{"totalCount":1,"pageInfo":{"totalPages":1,"currentPage":1},"edges":[{"node":{"id":"ebd28fc914e4624bb31f7dc475733481","title":"공정한 & 편향없는 AI를 위한 Fairlearn 및 애저 MLOps 도구 활용","image":"https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/fairness_and_interpretability_in_ai.jpg","path":"/posts/2021/01/26/towards-fairness-ai-with-fairlearn-and-azure-mlops/","timeToRead":24,"featured":false,"humanTime":"26 Jan 2021","datetime":"2021-01-26T00:00:00.000Z","category":{"id":"Azure","title":"Azure","path":"/categories/azure/"},"author":[{"id":"ian-choi","name":"Ian Choi","image":{"type":"image","mimeType":"image/jpeg","src":"/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg","size":{"width":64,"height":64},"sizes":"(max-width: 64px) 100vw, 64px","srcset":["/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg 64w"],"dataUri":"data:image/svg+xml,%3csvg fill='none' viewBox='0 0 64 64' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'%3e%3cdefs%3e%3cfilter id='__svg-blur-9017504dd3a0335f8b03742d0ba54e18'%3e%3cfeGaussianBlur in='SourceGraphic' stdDeviation='40'/%3e%3c/filter%3e%3c/defs%3e%3cimage x='0' y='0' filter='url(%23__svg-blur-9017504dd3a0335f8b03742d0ba54e18)' width='64' height='64' xlink:href='data:image/jpeg%3bbase64%2c/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCABAAEADASIAAhEBAxEB/8QAGwAAAwEAAwEAAAAAAAAAAAAABQYHBAECCAP/xAAxEAABAwMCBAQFBAMBAAAAAAABAgMEAAUREiEGEzFBBxRRYSIycYGRFaGxwSRi0UL/xAAYAQADAQEAAAAAAAAAAAAAAAADBAUBAv/EACYRAAIDAAEDAgcBAAAAAAAAAAECAAMRIQQSMSJBBVFhcZHR4fD/2gAMAwEAAhEDEQA/AKgwKINCsbA6UQaxtnYd6Qhoo8f8dweEWUNrAfnuJ1IYB6D1PoKkr3jRxGtZLAhNpG4SWQr%2bTS9JiTuPOPro4Hccx1at/wDygHSkfgCnq0eDSRGbXNmpKzupIGAn/tds9dfDeYWuh7Bo8TDY/He4NSUovlujSI5PxLjgtOD3AJIP7VZ%2bGOJLbxNbxMtLylt90rTpUn6ipZI8JbSwpxS3tenokDP70iviT4c8UsTba4sRic6c5BGd0q9QRWLalhxfM6s6Z6x3Gen3B1qeskt8X8TBOMqfZVv7tI/5VCbcS/Hbeb3Q4kLSfYjI/mpxLcDfHt9Z7uJjr/LWP6qh8NOXiTusG1mPzPQVuZRrGk7A7VhZ7UQZGpJTkjIxkdqnZGZDPDK2OWp7iKdMQUvMPqYUlQwfhJP27Uek%2bIEmKoMSbKrlu/I7zMZHsOuaOwbSiAmew6lJ1vZSSSdQSEgaiepOnf60s3O32R27hMO3LTPkAtNpW3gA4OVFXcDc0ozdzEkSzWhVQoM4vfGQhFLKLa69JdTkISrBAPtU%2b46kLvNndV5V5iSypKi0sZVucf3VC43g21d1YW%2bjzLCo7cdwpwpSFDocZBOd8/ag1ztlsZt7rMJt8uLTgczKSVZHQHp0raiqkHOZtys4I9pbbTEXEstvjuZ1sxmm1Z65CADShxhwhbblcVXJwzGpq0pQpbEhTYISMDYU%2bNNlqKy2pRUpDaUEnqSEgZrNJYDuM9qdViORIxAPEysdK3snGKxR0k4AGSTgAdzXa7SP0stIluIjBwEayNakHoDpHv1zWZMHJwTNxLD0xXZjRIO3MGPtmpoLe/LmSnW2Ey2UtaCVuaQM9QNjvW%2b6cXKuN7ttua56WgdElxYKUqBSd85weyvSh7d1lQkueSdGnUQTjuDg0C9O3CJV6dnTUs/wik9AkG8ZiRCNKsDU6rA%2bmR0pj4aER7iiE3d5SEx9eSVE4UoDITn3NDLpepzilqfkHBG%2bKTrvPXJaZQ0lSCpzU2oH5kDIP7/xXFal2hLrAFwe89ZCQ3IC1sOIcRq%2bZCgoZ77iuhqTeF3PmwQiXcZFpixsYLKfn7krVjHfvVFZvTCg0vUXILpw1OykNrP5/cZFMggjRI7Aq2Ycgy0XJy4vsOQmHPNNq%2bMnPLb%2bEKGlXQ9fm9DjFLMc8Qq8y44tpwlzJJ5ZJwV/60edv7UaW89aYqnGXHUo5bYykKKVJJAH%2b3UZwPvSbAuF6U/PAtzBPN6JUgkZ1eh966YAjnM%2bs4p02qy75Pj7Rcu7F8du7zZDSCopbyNCcZGkdN/xWSJNlG6XBuKyltmOgKcaXkcwAYU4M98jetd3lXddwmFVvCMoz8SkgbFJ7n3olemrh5J66ogxlPnLbw8wjBbWj5eu2NWQPWj3qpTt4h0Zk9R2Kl4LsyQhpjCGlbnAyVe33oJb4Mm7XiDFbb5CVDUFIyQBghWPuD%2ba020TELCEPRlKaBcJedSNgDjPUZ/ujnh9bUuOvyJc5LKEMrKfLo5hKlbAHoBsKDUgUE7GHL3D0jd/kdYHDMaDwqUredddlkMIBwjTqKdwTvsM9K%2b36XPtzbdshR47kaWj/F84MKawSVLSB1HXqB%2baDW15qUuI3GbuU4NKU9ygkJCyVhtHT6qP4o9xZKuv6y0mQI0JxTWl5159IU2jfDaQMkfQb%2btaWIXtB/P6igR61UZzx4%2bRPif/2Q==' /%3e%3c/svg%3e"},"path":"/authors/ian-choi/"}]}}]}}},"context":{}}

1
docs/assets/data/tags/azure-pipelines/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure-sdk/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure/2/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/azure/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/backward-compatibility/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/bicep/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/cloudevents/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/custom-connector/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/devops/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/fairlearn/index.json
Просмотреть файл

@ -1 +0,0 @@
{"hash":"80e403713986797ff323aa88b661a5d06e448643","data":{"tag":{"title":"fairlearn","path":"/tags/fairlearn/","belongsTo":{"totalCount":1,"pageInfo":{"totalPages":1,"currentPage":1},"edges":[{"node":{"id":"ebd28fc914e4624bb31f7dc475733481","title":"공정한 & 편향없는 AI를 위한 Fairlearn 및 애저 MLOps 도구 활용","image":"https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/fairness_and_interpretability_in_ai.jpg","path":"/posts/2021/01/26/towards-fairness-ai-with-fairlearn-and-azure-mlops/","timeToRead":24,"featured":false,"humanTime":"26 Jan 2021","datetime":"2021-01-26T00:00:00.000Z","category":{"id":"Azure","title":"Azure","path":"/categories/azure/"},"author":[{"id":"ian-choi","name":"Ian Choi","image":{"type":"image","mimeType":"image/jpeg","src":"/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg","size":{"width":64,"height":64},"sizes":"(max-width: 64px) 100vw, 64px","srcset":["/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg 64w"],"dataUri":"data:image/svg+xml,%3csvg fill='none' viewBox='0 0 64 64' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'%3e%3cdefs%3e%3cfilter id='__svg-blur-9017504dd3a0335f8b03742d0ba54e18'%3e%3cfeGaussianBlur in='SourceGraphic' stdDeviation='40'/%3e%3c/filter%3e%3c/defs%3e%3cimage x='0' y='0' filter='url(%23__svg-blur-9017504dd3a0335f8b03742d0ba54e18)' width='64' height='64' xlink:href='data:image/jpeg%3bbase64%2c/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCABAAEADASIAAhEBAxEB/8QAGwAAAwEAAwEAAAAAAAAAAAAABQYHBAECCAP/xAAxEAABAwMCBAQFBAMBAAAAAAABAgMEAAUREiEGEzFBBxRRYSIycYGRFaGxwSRi0UL/xAAYAQADAQEAAAAAAAAAAAAAAAADBAUBAv/EACYRAAIDAAEDAgcBAAAAAAAAAAECAAMRIQQSMSJBBVFhcZHR4fD/2gAMAwEAAhEDEQA/AKgwKINCsbA6UQaxtnYd6Qhoo8f8dweEWUNrAfnuJ1IYB6D1PoKkr3jRxGtZLAhNpG4SWQr%2bTS9JiTuPOPro4Hccx1at/wDygHSkfgCnq0eDSRGbXNmpKzupIGAn/tds9dfDeYWuh7Bo8TDY/He4NSUovlujSI5PxLjgtOD3AJIP7VZ%2bGOJLbxNbxMtLylt90rTpUn6ipZI8JbSwpxS3tenokDP70iviT4c8UsTba4sRic6c5BGd0q9QRWLalhxfM6s6Z6x3Gen3B1qeskt8X8TBOMqfZVv7tI/5VCbcS/Hbeb3Q4kLSfYjI/mpxLcDfHt9Z7uJjr/LWP6qh8NOXiTusG1mPzPQVuZRrGk7A7VhZ7UQZGpJTkjIxkdqnZGZDPDK2OWp7iKdMQUvMPqYUlQwfhJP27Uek%2bIEmKoMSbKrlu/I7zMZHsOuaOwbSiAmew6lJ1vZSSSdQSEgaiepOnf60s3O32R27hMO3LTPkAtNpW3gA4OVFXcDc0ozdzEkSzWhVQoM4vfGQhFLKLa69JdTkISrBAPtU%2b46kLvNndV5V5iSypKi0sZVucf3VC43g21d1YW%2bjzLCo7cdwpwpSFDocZBOd8/ag1ztlsZt7rMJt8uLTgczKSVZHQHp0raiqkHOZtys4I9pbbTEXEstvjuZ1sxmm1Z65CADShxhwhbblcVXJwzGpq0pQpbEhTYISMDYU%2bNNlqKy2pRUpDaUEnqSEgZrNJYDuM9qdViORIxAPEysdK3snGKxR0k4AGSTgAdzXa7SP0stIluIjBwEayNakHoDpHv1zWZMHJwTNxLD0xXZjRIO3MGPtmpoLe/LmSnW2Ey2UtaCVuaQM9QNjvW%2b6cXKuN7ttua56WgdElxYKUqBSd85weyvSh7d1lQkueSdGnUQTjuDg0C9O3CJV6dnTUs/wik9AkG8ZiRCNKsDU6rA%2bmR0pj4aER7iiE3d5SEx9eSVE4UoDITn3NDLpepzilqfkHBG%2bKTrvPXJaZQ0lSCpzU2oH5kDIP7/xXFal2hLrAFwe89ZCQ3IC1sOIcRq%2bZCgoZ77iuhqTeF3PmwQiXcZFpixsYLKfn7krVjHfvVFZvTCg0vUXILpw1OykNrP5/cZFMggjRI7Aq2Ycgy0XJy4vsOQmHPNNq%2bMnPLb%2bEKGlXQ9fm9DjFLMc8Qq8y44tpwlzJJ5ZJwV/60edv7UaW89aYqnGXHUo5bYykKKVJJAH%2b3UZwPvSbAuF6U/PAtzBPN6JUgkZ1eh966YAjnM%2bs4p02qy75Pj7Rcu7F8du7zZDSCopbyNCcZGkdN/xWSJNlG6XBuKyltmOgKcaXkcwAYU4M98jetd3lXddwmFVvCMoz8SkgbFJ7n3olemrh5J66ogxlPnLbw8wjBbWj5eu2NWQPWj3qpTt4h0Zk9R2Kl4LsyQhpjCGlbnAyVe33oJb4Mm7XiDFbb5CVDUFIyQBghWPuD%2ba020TELCEPRlKaBcJedSNgDjPUZ/ujnh9bUuOvyJc5LKEMrKfLo5hKlbAHoBsKDUgUE7GHL3D0jd/kdYHDMaDwqUredddlkMIBwjTqKdwTvsM9K%2b36XPtzbdshR47kaWj/F84MKawSVLSB1HXqB%2baDW15qUuI3GbuU4NKU9ygkJCyVhtHT6qP4o9xZKuv6y0mQI0JxTWl5159IU2jfDaQMkfQb%2btaWIXtB/P6igR61UZzx4%2bRPif/2Q==' /%3e%3c/svg%3e"},"path":"/authors/ian-choi/"}]}}]}}},"context":{}}

1
docs/assets/data/tags/fairness/index.json
Просмотреть файл

@ -1 +0,0 @@
{"hash":"80e403713986797ff323aa88b661a5d06e448643","data":{"tag":{"title":"fairness","path":"/tags/fairness/","belongsTo":{"totalCount":1,"pageInfo":{"totalPages":1,"currentPage":1},"edges":[{"node":{"id":"ebd28fc914e4624bb31f7dc475733481","title":"공정한 & 편향없는 AI를 위한 Fairlearn 및 애저 MLOps 도구 활용","image":"https://raw.githubusercontent.com/ianychoi/Azure-oss-hands-on-labs/master/06-Azure-ML-with-Fairlearn/_images/fairness_and_interpretability_in_ai.jpg","path":"/posts/2021/01/26/towards-fairness-ai-with-fairlearn-and-azure-mlops/","timeToRead":24,"featured":false,"humanTime":"26 Jan 2021","datetime":"2021-01-26T00:00:00.000Z","category":{"id":"Azure","title":"Azure","path":"/categories/azure/"},"author":[{"id":"ian-choi","name":"Ian Choi","image":{"type":"image","mimeType":"image/jpeg","src":"/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg","size":{"width":64,"height":64},"sizes":"(max-width: 64px) 100vw, 64px","srcset":["/developerkorea/assets/static/ian-choi.dea1acb.15430bb56d3486b17b43a38027817af9.jpg 64w"],"dataUri":"data:image/svg+xml,%3csvg fill='none' viewBox='0 0 64 64' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'%3e%3cdefs%3e%3cfilter id='__svg-blur-9017504dd3a0335f8b03742d0ba54e18'%3e%3cfeGaussianBlur in='SourceGraphic' stdDeviation='40'/%3e%3c/filter%3e%3c/defs%3e%3cimage x='0' y='0' filter='url(%23__svg-blur-9017504dd3a0335f8b03742d0ba54e18)' width='64' height='64' xlink:href='data:image/jpeg%3bbase64%2c/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCABAAEADASIAAhEBAxEB/8QAGwAAAwEAAwEAAAAAAAAAAAAABQYHBAECCAP/xAAxEAABAwMCBAQFBAMBAAAAAAABAgMEAAUREiEGEzFBBxRRYSIycYGRFaGxwSRi0UL/xAAYAQADAQEAAAAAAAAAAAAAAAADBAUBAv/EACYRAAIDAAEDAgcBAAAAAAAAAAECAAMRIQQSMSJBBVFhcZHR4fD/2gAMAwEAAhEDEQA/AKgwKINCsbA6UQaxtnYd6Qhoo8f8dweEWUNrAfnuJ1IYB6D1PoKkr3jRxGtZLAhNpG4SWQr%2bTS9JiTuPOPro4Hccx1at/wDygHSkfgCnq0eDSRGbXNmpKzupIGAn/tds9dfDeYWuh7Bo8TDY/He4NSUovlujSI5PxLjgtOD3AJIP7VZ%2bGOJLbxNbxMtLylt90rTpUn6ipZI8JbSwpxS3tenokDP70iviT4c8UsTba4sRic6c5BGd0q9QRWLalhxfM6s6Z6x3Gen3B1qeskt8X8TBOMqfZVv7tI/5VCbcS/Hbeb3Q4kLSfYjI/mpxLcDfHt9Z7uJjr/LWP6qh8NOXiTusG1mPzPQVuZRrGk7A7VhZ7UQZGpJTkjIxkdqnZGZDPDK2OWp7iKdMQUvMPqYUlQwfhJP27Uek%2bIEmKoMSbKrlu/I7zMZHsOuaOwbSiAmew6lJ1vZSSSdQSEgaiepOnf60s3O32R27hMO3LTPkAtNpW3gA4OVFXcDc0ozdzEkSzWhVQoM4vfGQhFLKLa69JdTkISrBAPtU%2b46kLvNndV5V5iSypKi0sZVucf3VC43g21d1YW%2bjzLCo7cdwpwpSFDocZBOd8/ag1ztlsZt7rMJt8uLTgczKSVZHQHp0raiqkHOZtys4I9pbbTEXEstvjuZ1sxmm1Z65CADShxhwhbblcVXJwzGpq0pQpbEhTYISMDYU%2bNNlqKy2pRUpDaUEnqSEgZrNJYDuM9qdViORIxAPEysdK3snGKxR0k4AGSTgAdzXa7SP0stIluIjBwEayNakHoDpHv1zWZMHJwTNxLD0xXZjRIO3MGPtmpoLe/LmSnW2Ey2UtaCVuaQM9QNjvW%2b6cXKuN7ttua56WgdElxYKUqBSd85weyvSh7d1lQkueSdGnUQTjuDg0C9O3CJV6dnTUs/wik9AkG8ZiRCNKsDU6rA%2bmR0pj4aER7iiE3d5SEx9eSVE4UoDITn3NDLpepzilqfkHBG%2bKTrvPXJaZQ0lSCpzU2oH5kDIP7/xXFal2hLrAFwe89ZCQ3IC1sOIcRq%2bZCgoZ77iuhqTeF3PmwQiXcZFpixsYLKfn7krVjHfvVFZvTCg0vUXILpw1OykNrP5/cZFMggjRI7Aq2Ycgy0XJy4vsOQmHPNNq%2bMnPLb%2bEKGlXQ9fm9DjFLMc8Qq8y44tpwlzJJ5ZJwV/60edv7UaW89aYqnGXHUo5bYykKKVJJAH%2b3UZwPvSbAuF6U/PAtzBPN6JUgkZ1eh966YAjnM%2bs4p02qy75Pj7Rcu7F8du7zZDSCopbyNCcZGkdN/xWSJNlG6XBuKyltmOgKcaXkcwAYU4M98jetd3lXddwmFVvCMoz8SkgbFJ7n3olemrh5J66ogxlPnLbw8wjBbWj5eu2NWQPWj3qpTt4h0Zk9R2Kl4LsyQhpjCGlbnAyVe33oJb4Mm7XiDFbb5CVDUFIyQBghWPuD%2ba020TELCEPRlKaBcJedSNgDjPUZ/ujnh9bUuOvyJc5LKEMrKfLo5hKlbAHoBsKDUgUE7GHL3D0jd/kdYHDMaDwqUredddlkMIBwjTqKdwTvsM9K%2b36XPtzbdshR47kaWj/F84MKawSVLSB1HXqB%2baDW15qUuI3GbuU4NKU9ygkJCyVhtHT6qP4o9xZKuv6y0mQI0JxTWl5159IU2jfDaQMkfQb%2btaWIXtB/P6igR61UZzx4%2bRPif/2Q==' /%3e%3c/svg%3e"},"path":"/authors/ian-choi/"}]}}]}}},"context":{}}

1
docs/assets/data/tags/fusion-teams/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/github-actions/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

1
docs/assets/data/tags/iac/index.json
Просмотреть файл

Различия файлов скрыты, потому что одна или несколько строк слишком длинны

Некоторые файлы не были показаны из-за слишком большого количества измененных файлов Показать больше